¿Qué es la llamada de la función?

La llamada a una función, también llamada llamada llamada a herramientas, permite que un modelo de lenguaje pida a tu aplicación que ejecute una función. Describes cada función con un esquema JSON, el modelo responde con un nombre de función y argumentos, tu código lo ejecuta y el modelo usa el resultado para continuar o responder.

Conceptos

Cómo funciona la llamada a funciones

Un modelo de lenguaje por sí solo genera texto. La llamada a funciones le proporciona una forma estructurada de pedir algo que no puede hacer solo, como leer una base de datos, comprobar un pedido o llamar a otra API. Un ciclo se ve así:

  1. Envías la conversación con Herramientas. Cada herramienta tiene un Nombre, a Descripción y parámetros escrito como JSON Schema.
  2. El modelo decide si una herramienta ayudaría. Si lo hiciera, la respuesta continúa tool_calls con el nombre de la función y los argumentos JSON, y finish_reason es tool_calls.
  3. Tu código revisa los argumentos y ejecuta la función.
  4. Envías la conversación de nuevo con el resultado añadido como mensaje con el Herramienta rol.
  5. El modelo responde a partir del resultado o llama a otra herramienta.

Por ejemplo, con un get_order_status función que toma un order_id, el mensaje Consulta el estado de la orden 1042 produce una llamada a get_order_status con {"order_id": "1042"}. Tu código busca el pedido, devuelve su estado y el modelo convierte ese estado en una respuesta.

El modelo nunca ejecuta código en sí mismo. Propone una llamada, y tu aplicación decide si ejecutarla y cómo ejecutarla, lo que mantiene los permisos y efectos secundarios bajo tu control.

Control del uso de herramientas

  • tool_choice Establece cómo utiliza el modelo las herramientas: Auto Déjalo decidir, ninguno previene llamadas, obligatorio hace que llame a una herramienta, y un objeto que nombra una función fuerza esa función. Algunos modelos solo aceptan Auto, o Auto y ninguno; Cada página del modelo indica lo que acepta.
  • parallel_tool_calls, en los modelos que lo ofrecen, permite al modelo solicitar varias llamadas en un solo turno. Ejecútalas y luego devuelve un resultado por cada llamada.
  • Las descripciones guían la elección. El modelo elige herramientas a partir de sus nombres y descripciones, así que indica qué hace cada función y cuándo usarla, y mantén los esquemas de parámetros estrictos con los campos obligatorios y enum valores.
  • Las definiciones son introducidas. Las definiciones de herramientas se envían con cada solicitud y cuentan como tokens de entrada. Incluye solo las herramientas que necesita una tarea y mantén la lista idéntica entre solicitudes para que caché de prompts puede aplicarse en modelos que lo soporten.

En algunos modelos de razonamiento, una solicitud que fuerza una llamada a una herramienta se ejecuta sin razonamiento a menos que también se configure habilitar pensar.

Llamada a funciones entre puntos finales

EmpirioLabs AI acepta herramientas en forma de cada API con la que es compatible:

  • /v1/chat/completions Toma Herramientas y tool_choice como se ha descrito anteriormente y retornos tool_calls.
  • /v1/responses devuelve llamadas como function_call elementos de salida.
  • /v1/messages Viajes de ida y vuelta tool_use y tool_result bloques de contenido.
  • Voz en tiempo real los modelos que lo soportan llaman a funciones durante una conversación en vivo: declaras las herramientas en session.update y devolver cada resultado como un function_call_output ítem.

El Referencia de Finalizaciones de chat Incluye una solicitud completa de llamada a la herramienta.

Herramientas funcionales y herramientas integradas

Algunos modelos también ofrecen herramientas integradas, como búsqueda web o un intérprete de código, que se ejecutan durante la solicitud sin necesidad de ir y venir a tu código. Los activas con un parámetro del modelo como tool_web_search, o con un web_search Herramienta activada /v1/responses y /v1/messages, en modelos que lo ofrecen. Una herramienta integrada puede añadir su propia tarifa por llamada o por solicitud, indicada en el precio del modelo, mientras que una herramienta de función se ejecuta en tu propia aplicación.

En algunos modelos no se utiliza una herramienta integrada cuando la misma solicitud también tiene herramientas funcionales, así que revisa la página del modelo antes de combinarlas. Examinar Modelos de texto para ver qué función de soporte está llamando, o prueba un modelo en el Playground.

Los modelos en EmpirioLabs AI

82 modelos, del más barato al más caro cuando comparten unidad de facturación. La página de cada modelo tiene su tarjeta de precios completa, parámetros y 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, según la tarifa de entrada

ModeloEntradaSalida
GLM 4.5 Flash Z.aiGratisGratis
GLM 4.6V Flash Z.aiGratisGratis
GLM 4.7 Flash Z.aiGratisGratis
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 los 70 modelos
ModeloEntradaSalida
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

También disponibles: 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

Preguntas frecuentes

¿El modelo ejecuta mis funciones?

No. El modelo devuelve el nombre de la función y los argumentos, y tu aplicación ejecuta la función y envía el resultado. Nada se ejecuta a menos que tu código lo ejecute.

¿Cuál es la diferencia entre llamar a funciones y salida estructurada?

La salida estructurada devuelve JSON como respuesta final. La llamada a función devuelve una petición para que tu código actúe y continúa una vez que envíes el resultado.

¿Puede un modelo llamar a varias funciones a la vez?

Los modelos que ofrecen parallel_tool_calls pueden solicitar varias llamadas en un solo turno. Ejecuta cada una y devuelve un resultado por cada llamada.

¿Las definiciones de herramientas cuestan tokens?

Sí. Las definiciones de herramientas forman parte de la solicitud y cuentan como tokens de entrada en cada llamada, así que incluye solo las herramientas que necesita una tarea.

¿Listo para usar mejores endpoints?

Consulta nuestros precios o contacta con nosotros si quieres que tu propio modelo se implemente en nuestra pila.