함수 호출(툴 호출이라고도 함)은 언어 모델이 애플리케이션에 함수를 실행해 달라고 요청하는 방식입니다. 각 함수를 JSON 스키마로 설명하고, 모델이 함수 이름과 인자를 입력하며, 코드가 이를 실행하고, 모델은 그 결과를 이용해 계속하거나 응답합니다.
언어 모델은 단독으로 텍스트만 생성합니다. 함수 호출은 데이터베이스를 읽거나, 주문을 확인하거나, 다른 API를 호출하는 등 혼자서는 할 수 없는 것을 구조화된 방식으로 요청할 수 있게 해줍니다. 한 사이클은 다음과 같습니다:
도구. 각 도구는 이름, a 설명 그리고 매개변수 JSON 스키마로 작성됨.tool_calls 함수 이름과 JSON 인수를 포함하고, finish_reason 이야. tool_calls·.도구 역할.예를 들어, 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·.
모델 82개. 과금 단위가 같은 모델은 저렴한 순으로 정렬했습니다. 각 모델 페이지에 전체 요금표, 파라미터, 코드가 있습니다.
엔드포인트
/v1/chat/completions POST /v1/responses POST /v1/messages POST /v1/completions POST /v1/audio/speech POST /v1/audio/speech:stream WEBSOCKET /v1/realtime100만 토큰당, 입력 요금 순
| 모델 | 입력 | 출력 |
|---|---|---|
| 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 |
| 모델 | 입력 | 출력 |
|---|---|---|
| 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 기능을 제공하는 모델은 한 턴에 여러 개의 호출을 요청할 수 있습니다. 각 호출을 실행하고 각 호출에 대해 결과를 반환합니다.
네. 도구 정의는 요청의 일부이며 모든 호출에서 입력 토큰으로 간주되므로, 작업에 필요한 도구만 포함하세요.