O que a função está chamando?

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.

Conceitos

Como funciona a chamada de função

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:

  1. Você envia a conversa com Ferramentas. Cada ferramenta possui um Nome, a Descrição e parâmetros escrito como Esquema JSON.
  2. O modelo decide se uma ferramenta ajudaria. Se ajudar, a resposta é válida tool_calls com o nome da função e os argumentos JSON, e finish_reason é tool_calls.
  3. Seu código verifica os argumentos e executa a função.
  4. Você envia a conversa novamente com o resultado adicionado como uma mensagem com o ferramenta Papel.
  5. O modelo responde a partir do resultado ou chama outra ferramenta.

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.

Controle do uso de ferramentas

  • 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.
  • Descrições guiam a escolha. O modelo escolhe ferramentas a partir de seus nomes e descrições, então declara o que cada função faz e quando usá-la, mantendo os esquemas de parâmetros rigorosos com os campos obrigatórios e enum valores.
  • Definições são entradas. Definições de ferramentas são enviadas com cada solicitação e contam como tokens de entrada. Inclua apenas as ferramentas que uma tarefa precisa e mantenha a lista idêntica entre as solicitações para que cache de prompts pode se aplicar em modelos que o suportem.

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.

Chamada de função entre endpoints

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.
  • Voz em tempo real modelos que suportam a chamada de funções durante uma conversa ao vivo: você declara ferramentas em 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.

Ferramentas funcionais e ferramentas integradas

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.

Os modelos no EmpirioLabs AI

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

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

Por 1M de tokens, pela tarifa de entrada

ModeloEntradaSaída
GLM 4.5 Flash Z.aiGrátisGrátis
GLM 4.6V Flash Z.aiGrátisGrátis
GLM 4.7 Flash Z.aiGrátisGrá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
Ver todos os 70 modelos
ModeloEntradaSaí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

Perguntas frequentes

O modelo executa minhas funções?

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.

Qual é a diferença entre chamada de função e saída estruturada?

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.

Um modelo pode chamar várias funções ao mesmo tempo?

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.

Definições de ferramentas custam tokens?

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.

Pronto para usar endpoints melhores?

Confira nossos preços ou entre em contato se quiser que seu próprio modelo seja implementado em nossa pilha.