A chamada de função, também chamada de chamada de ferramenta, permite que um modelo de linguagem peça ao seu aplicativo que execute uma função. Você descreve cada função com um Esquema JSON, o modelo responde com um nome e argumentos de função, seu código a executa, e o modelo usa o resultado para continuar ou responder.
Um modelo de linguagem por si só gera texto. A chamada de função lhe dá uma forma estruturada de pedir algo que não pode fazer sozinho, como ler um banco de dados, verificar um pedido ou chamar outra API. Um ciclo é assim:
Ferramentas. Cada ferramenta possui um Nome, a Descrição e parâmetros escrito como Esquema JSON.tool_calls com o nome da função e os argumentos JSON, e finish_reason é tool_calls.ferramenta Papel.Por exemplo, com um get_order_status função que toma um order_id, a mensagem Verifique o status do pedido 1042 produz uma chamada para get_order_status com {"order_id": "1042"}. Seu código procura a ordem, retorna seu status, e o modelo transforma esse status em uma resposta.
O modelo nunca executa código sozinho. Ele propõe uma chamada, e seu aplicativo decide se e como executá-la, mantendo as permissões e efeitos colaterais sob seu controle.
tool_choice define como o modelo usa ferramentas: Auto Deixa que decida, nenhum impede chamadas, obrigatório faz com que ele chame uma ferramenta, e um objeto que nomeia uma função força essa função. Alguns modelos aceitam apenas Auto, ou Auto e nenhum; Cada página do modelo lista o que aceita.parallel_tool_calls, em modelos que a oferecem, permite que o modelo solicite várias chamadas em um único turno. Execute-as e retorne um resultado para cada chamada.enum valores.Em alguns modelos de raciocínio, uma solicitação que força uma chamada de ferramenta é executada sem raciocínio, a menos que também defina activar pensar.
EmpirioLabs AI aceita ferramentas na forma de cada API com a qual é compatível:
/v1/chat/completions Takes Ferramentas e tool_choice conforme descrito acima e retornos tool_calls./v1/responses retorna chamadas como function_call itens de saída./v1/messages Viagens de ida e volta tool_use e tool_result Bloqueios de conteúdo.session.update e retorna cada resultado como um function_call_output item.O Referência de Finalizações de Chat Inclui uma solicitação completa de chamada de ferramenta.
Alguns modelos também oferecem ferramentas integradas, como busca na web ou um interpretador de código, que rodam durante a solicitação sem precisar ir ao seu código. Você os ativa com um parâmetro do modelo, como tool_web_search, ou com um web_search ferramenta ligada /v1/responses e /v1/messages, em modelos que a oferecem. Uma ferramenta embutida pode adicionar sua própria taxa por chamada ou por solicitação, listada na tarifação do modelo, enquanto uma ferramenta de função roda na sua própria aplicação.
Em alguns modelos, uma ferramenta embutida não é usada quando a mesma solicitação também possui ferramentas funcionais, então verifique a página do modelo antes de combiná-las. Navegar Modelos de texto para ver qual função de suporte está chamando, ou tente um modelo no Playground.
82 modelos, do mais barato para o mais caro quando compartilham uma unidade de cobrança. A página de cada modelo traz a tabela de preços completa, os parâmetros e código.
Endpoints
/v1/chat/completions POST /v1/responses POST /v1/messages POST /v1/completions POST /v1/audio/speech POST /v1/audio/speech:stream WEBSOCKET /v1/realtimePor 1M de tokens, pela tarifa de entrada
| Modelo | Entrada | Saída |
|---|---|---|
| GLM 4.5 Flash Z.ai | Grátis | Grátis |
| GLM 4.6V Flash Z.ai | Grátis | Grátis |
| GLM 4.7 Flash Z.ai | Grátis | Grátis |
| 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 |
| Modelo | Entrada | Saída |
|---|---|---|
| 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 |
Também disponíveis: 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
Não. O modelo retorna o nome da função e os argumentos, e sua aplicação executa a função e envia de volta o resultado. Nada roda a menos que seu código o execute.
A saída estruturada retorna JSON como resposta final. A chamada de função retorna uma solicitação para que seu código atue, e então continua assim que você envia o resultado de volta.
Modelos que oferecem parallel_tool_calls podem solicitar várias chamadas em um único turno. Execute cada uma e retorne um resultado para cada chamada.
Sim. Definições de ferramentas fazem parte da solicitação e contam como tokens de entrada em cada chamada, portanto inclua apenas as ferramentas que uma tarefa precisa.
Confira nossos preços ou entre em contato se quiser que seu próprio modelo seja implementado em nossa pilha.