함수 호출이란 무엇인가요?

함수 호출(툴 호출이라고도 함)은 언어 모델이 애플리케이션에 함수를 실행해 달라고 요청하는 방식입니다. 각 함수를 JSON 스키마로 설명하고, 모델이 함수 이름과 인자를 입력하며, 코드가 이를 실행하고, 모델은 그 결과를 이용해 계속하거나 응답합니다.

개념

함수 호출 작동 방식

언어 모델은 단독으로 텍스트만 생성합니다. 함수 호출은 데이터베이스를 읽거나, 주문을 확인하거나, 다른 API를 호출하는 등 혼자서는 할 수 없는 것을 구조화된 방식으로 요청할 수 있게 해줍니다. 한 사이클은 다음과 같습니다:

  1. 당신은 대화를 다음과 같이 보냅니다 도구. 각 도구는 이름, a 설명 그리고 매개변수 JSON 스키마로 작성됨.
  2. 모델은 도구가 도움이 될지 여부를 결정합니다. 만약 도움이 된다면, 응답은 다음과 같습니다 tool_calls 함수 이름과 JSON 인수를 포함하고, finish_reason 이야. tool_calls·.
  3. 코드가 인수를 확인하고 함수를 실행합니다.
  4. 대화를 다시 보내고 결과가 메시지로 추가됩니다. 도구 역할.
  5. 모델은 결과에 따라 응답하거나 다른 도구를 호출합니다.

예를 들어, get_order_status 다음과 같은 기능을 수행하는 함수 order_id, 메시지 주문 1042 상태 확인 다음 호출을 생성합니다 get_order_status 이름 * {"order_id": "1042"}. 코드가 주문을 조회해 상태를 반환하면, 모델이 그 상태를 응답으로 변환합니다.

모델은 코드 자체를 실행하지 않습니다. 호출을 제안하고, 애플리케이션이 그것을 실행할지 여부와 방법을 결정하며, 이 과정에서 권한과 부작용은 사용자의 통제 하에 두게 됩니다.

도구 사용 제어

  • tool_choice 모델이 도구를 사용하는 방식을 설정합니다: 오토 그것이 결정하게 두세요, 이름 * 통화를 방지합니다. 필수 도구를 호출하게 하고, 객체가 하나의 함수를 지정하면 그 함수를 강제로 붙인다. 일부 모델은 오직 만 허용합니다 오토, 또는 오토 그리고 이름 *; 각 모델 페이지에는 허용되는 항목이 나열되어 있습니다.
  • parallel_tool_calls이 기능을 제공하는 모델에서는 모델이 한 턴에 여러 호출을 요청할 수 있게 합니다. 이 호출들을 실행한 후 각 호출마다 하나의 결과를 반환합니다.
  • 설명이 선택을 안내합니다. 모델은 도구의 이름과 설명을 통해 도구를 선택하므로, 각 함수가 무엇을 하고 언제 사용해야 하는지 명시하고, 매개변수 스키마를 필수 필드와 함께 엄격하게 유지하세요 열거 가치관.
  • 정의는 입력입니다. 도구 정의는 모든 요청과 함께 전송되며 입력 토큰으로 간주됩니다. 작업이 필요한 도구만 포함하고, 요청마다 목록을 동일하게 유지하세요. 즉시 캐싱 이를 지원하는 모델에 적용할 수 있습니다.

일부 추론 모델에서는 도구 호출을 강제하는 요청이 논리 없이 실행되는데, 단, 함께 다음 집합을 요구하지 않는 한 실행됩니다 enable thinking을 활성화·.

엔드포인트 간 함수 호출

EmpirioLabs AI 호환되는 각 API의 형태에 맞는 도구를 수용합니다:

  • /v1/chat/completions 이것 도구 그리고 tool_choice 위에서 설명한 것과 같고 반환됩니다 tool_calls·.
  • /v1/responses 에 호출을 다음과 같이 반환합니다. function_call 출력 항목.
  • /v1/messages 에 왕복 tool_use 그리고 tool_result 콘텐츠 블록.
  • 실시간 음성 실시간 대화 중 기능을 호출하는 이를 지원하는 모델: 도구를 선언합니다. 세션.업데이트 그리고 각 결과를 다음과 같이 반환합니다. function_call_output 항목.

그 채팅 완료 참조 완전한 도구 호출 요청이 포함되어 있습니다.

기능 도구 및 내장 도구

일부 모델은 웹 검색이나 코드 인터프리터와 같은 내장 도구를 제공하여 요청 도중에 코드로 돌아오지 않고 실행됩니다. 이들을 켜려면 다음과 같은 모델 매개변수를 사용합니다. tool_web_search 에, 또는 web_search 도구 켜기 /v1/responses 에 그리고 /v1/messages 에, 이를 제공하는 모델에 대해서. 내장 도구는 모델의 가격에 명시된 호출당 또는 요청당 수수료를 별도로 추가할 수 있으며, 함수 도구는 자체 애플리케이션에서 실행됩니다.

일부 모델에서는 같은 요청에 함수 도구가 있을 때 내장 도구가 사용되지 않으므로, 결합하기 전에 모델 페이지를 확인하세요. 찾아보기 텍스트 모델 어떤 함수를 호출하는지 확인하거나 모델을 시도해 보세요. Playground·.

EmpirioLabs AI의 모델

모델 82개. 과금 단위가 같은 모델은 저렴한 순으로 정렬했습니다. 각 모델 페이지에 전체 요금표, 파라미터, 코드가 있습니다.

엔드포인트

POST /v1/chat/completions POST /v1/responses POST /v1/messages POST /v1/completions POST /v1/audio/speech POST /v1/audio/speech:stream WEBSOCKET /v1/realtime

100만 토큰당, 입력 요금 순

모델입력출력
GLM 4.5 Flash Z.ai무료무료
GLM 4.6V Flash Z.ai무료무료
GLM 4.7 Flash Z.ai무료무료
Qwen3.7 Flash Alibaba Cloud<=32K $0.03 32K-256K $0.10 256K-1M $0.20<=32K $0.13 32K-256K $0.40 256K-1M $0.80
Qwen3.5 4B Alibaba Cloud$0.04$0.07
Nova Micro 1.0 Amazon$0.040$0.16
GLM 4.6V FlashX Z.ai$0.04$0.40
Gemma 4 26B-A4B Google$0.15$0.05$0.50$0.29
모델 70개 모두 보기
모델입력출력
Qwen3.5 35B-A3B Alibaba Cloud$0.25 <=128K $0.057 $0.25 128K-256K $0.229$2.00 <=128K $0.459 $2.00 128K-256K $1.835
Nova Lite 1.0 Amazon$0.069$0.28
GLM 4.7 FlashX Z.ai$0.07$0.40
Qwen3.6 35B A3B Alibaba Cloud$0.248$0.07$1.485$0.42
GLM 5.3 Flash Z.ai$0.075$0.25
Qwen3.5 27B Alibaba Cloud$0.30 <=128K $0.086 $0.30 128K-256K $0.258$2.40 <=128K $0.688 $2.40 128K-256K $2.064
Qwen3.5 9B Alibaba Cloud$0.10$0.09$0.15$0.13
Qwen3.5 Flash Alibaba Cloud$0.10$0.090$0.40$0.368
Step 3.5 Flash StepFun$0.10$0.30
Step 3.5 Flash 2603 StepFun$0.10$0.30
MiniMax M3.1 Flash MiniMax$0.15$0.1125$0.60$0.45
Qwen3.5 122B-A10B Alibaba Cloud$0.40 <=128K $0.115 $0.40 128K-256K $0.287$3.20 <=128K $0.917 $3.20 128K-256K $2.294
Seed 2.0 Mini ByteDance<=128K $0.12 128K-256K $0.24<=128K $0.50 128K-256K $1.00
MiMo V2.6 Flash Xiaomi$0.14$0.28
Mistral Small 4 Mistral AI$0.15$0.60
Qwen3.8 Flash Alibaba Cloud$0.16$0.47
Qwen3.8 27B Alibaba Cloud$0.45$0.17$3.20$0.50
Qwen3.5 397B-A17B Alibaba Cloud$0.60 <=128K $0.172 $0.60 128K-256K $0.43$3.60 <=128K $1.032 $3.60 128K-256K $2.58
DeepSeek V4.1 Flash 1017 DeepSeek$0.20$0.80
Muse Glimmer 30B Meta AI$0.35$0.20$1.50$0.80
Step 3.7 Flash StepFun$0.20$1.15
MiniMax M3 MiniMax$0.30 <=512K $0.225 $0.60 >512K $0.45$1.20 <=512K $0.90 $2.40 >512K $1.80
Qwen3.6 Flash Alibaba Cloud<=256K $0.25 256K-1M $1.00<=256K $1.50 256K-1M $4.00
Qwen3.8 Omni Flash Alibaba Cloud$0.30$0.94
Seed 2.0 Lite ByteDance<=128K $0.31 128K-256K $0.62<=128K $2.50 128K-256K $5.00
Qwen3.5 Plus Alibaba Cloud$0.40 <=256K $0.36 $0.50 256K-1M $0.45$2.40 <=256K $2.21 $3.00 256K-1M $2.76
Nova Lite 2 Amazon$0.38$3.16
Qwen3.7 Plus Alibaba Cloud<=256K $0.40 256K-1M $1.20<=256K $1.60 256K-1M $4.80
Seed 2.0 Code ByteDance<=128K $0.40 128K-256K $0.80<=128K $2.40 128K-256K $4.80
Qwen3.6 27B Alibaba Cloud$0.60$0.412564$3.60$2.475384
DeepSeek V4 Flash 0731 DeepSeek$0.424$1.272
MiMo V2.6 Pro Xiaomi$0.435$0.87
Qwen3.6 Plus Alibaba Cloud<=256K $0.50 256K-1M $2.00<=256K $3.00 256K-1M $6.00
Seed 2.1 Turbo ByteDance$0.63$3.13
Seed 2.0 Pro ByteDance<=128K $0.63 128K-256K $1.26<=128K $3.79 128K-256K $7.58
Qwen3.5 Omni Flash Alibaba Cloud$0.80$4.40
GLM 5.1 Z.ai$1.40 <=32K $0.825 $1.40 32K-200K $1.10$4.40 <=32K $3.301 $4.40 32K-200K $3.851
Kimi K2.6 Moonshot AI$0.95$0.8939$4.00$3.7131
Kimi K2.7 Code Moonshot AI$0.95$4.00
Step 5 Preview StepFun$1.00$2.70
Muse Spark 1.1 Meta AI$1.25$4.25
Muse Spark 1.2 Meta AI$1.25$4.25
Muse Spark 1.3 Meta AI$1.25$4.25
DeepSeek V4 Pro 0813 DeepSeek$1.32$3.96
GLM 5.2 Z.ai$1.40$4.40
GLM 5.3 Z.ai$1.40$4.40
StepAudio 3 Chat StepFun$1.50$3.50
Qwen4 Max Alibaba Cloud$1.50$4.50
DeepSeek V4 Pro DeepSeek$1.74$1.65$3.48$3.30
Kimi K2.7 Code Highspeed Moonshot AI$1.90$8.00
Fugu Max Sakana AI$2.00$6.00
Qwen3.8 Max Alibaba Cloud$2.00$6.00
Qwen3.8 Max 0902 Alibaba Cloud$2.00$6.00
Kimi K3.1 Pro Moonshot AI$2.00$10.00
Nova Pro 1.0 Amazon$2.40$9.60
Qwen3.7 Max Alibaba Cloud$2.50$7.50
Qwen3.5 Omni Plus Alibaba Cloud$2.80$16.60
Kimi K3 Moonshot AI$3.00$15.00
MiMo V2.6 Pro UltraSpeed Xiaomi$4.35$8.70
Fugu Ultra v1.1 Sakana AI<=272K $5.00 >272K $10.00<=272K $30.00 >272K $45.00
Fugu Ultra v2.0 Sakana AI<=272K $5.00 >272K $10.00<=272K $30.00 >272K $45.00
Fugu Ultra v1.0 Sakana AI<=272K $7.50 >272K $15.00<=272K $45.00 >272K $67.50

그 밖의 모델: Mistral Small 3.1, StepAudio 3 Realtime, StepAudio 2.5 Realtime, Qwen3.5 Omni Flash Realtime, Qwen3.5 Omni Plus Realtime, Qwen3.8 Omni Flash Realtime, Qwen Audio 3.1 Realtime Plus, Gemini 3.8 Live, Gemini 3.8 Live Extended Thinking, Qwen Audio 3.1 Realtime Flash, Qwen Audio 3.0 Realtime Plus, Qwen Audio 3.0 Realtime Flash

자주 묻는 질문

모델이 제 함수를 실행하나요?

아니요. 모델은 함수 이름과 인수를 반환하고, 애플리케이션이 함수를 실행하고 결과를 다시 보냅니다. 코드가 실행하지 않으면 아무것도 실행되지 않습니다.

함수 호출과 구조화된 출력의 차이는 무엇인가요?

구조화된 출력은 최종 응답으로 JSON을 반환합니다. 함수 호출은 코드가 동작하도록 요청하며, 결과를 다시 보내면 계속됩니다.

모델이 여러 함수를 동시에 호출할 수 있나요?

parallel_tool_calls 기능을 제공하는 모델은 한 턴에 여러 개의 호출을 요청할 수 있습니다. 각 호출을 실행하고 각 호출에 대해 결과를 반환합니다.

공구 정의에는 토큰이 필요한가요?

네. 도구 정의는 요청의 일부이며 모든 호출에서 입력 토큰으로 간주되므로, 작업에 필요한 도구만 포함하세요.

더 나은 엔드포인트를 사용할 준비가 되셨나요?

저희 가격을 확인하시거나 저희 스택에 자체 모델을 배포하고 싶으시면 연락해 주세요.