La API de Responses y function_call_output
En esta página
La API de Responses: el nuevo endpoint
La API de Responses es el nuevo endpoint principal de xAI, distinto del endpoint de Chat Completions compatible con OpenAI. Introduce un formato diferente para las llamadas a funciones, utilizando el tipo function_call_output para devolver los resultados de las herramientas.
Diferencias respecto a Chat Completions
El endpoint de Chat Completions (compatible con OpenAI) utiliza mensajes con el rol tool para devolver resultados. La API de Responses emplea un formato distinto, estructurado en torno a tipos de eventos.
Chat Completions (formato heredado)
# Devolver el resultado mediante un mensaje con rol "tool"
messages.append({
"role": "tool",
"tool_call_id": "call_abc123",
"content": {temp: 22, city: Paris}
})
API de Responses (nuevo formato)
# Devolver el resultado mediante un objeto function_call_output
{
"type": "function_call_output",
"call_id": "call_abc123",
"output": {temp: 22, city: Paris}
}
Diferencias clave:
type: "function_call_output"sustituye arole: "tool"call_idsustituye atool_call_idoutputsustituye acontent
Uso de la API de Responses con el SDK de OpenAI
Puedes utilizar el SDK de OpenAI para llamar a la API de Responses de xAI:
from openai import OpenAI
client = OpenAI(
api_key="votre-cle-api",
base_url="https://api.x.ai/v1"
)
# Crear una respuesta con herramientas
response = client.responses.create(
model="grok-4.5",
input="What's the weather like in Paris?",
tools=[{
"type": "function",
"name": "get_weather",
"description": "Get the weather for a city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string"}
},
"required": ["city"]
}
}]
)
Ten en cuenta que la API de Responses utiliza input en lugar de messages, y la estructura de las herramientas es ligeramente diferente (no hay un objeto function anidado).
Gestión de la respuesta
La respuesta de la API de Responses contiene un array output con eventos:
for item in response.output:
if item.type == "function_call":
print(f"Function: {item.name}")
print(f"Arguments: {item.arguments}")
print(f"Call ID: {item.call_id}")
# Ejecutar la función
result = get_weather(city="Paris")
# Continuar la conversación con el resultado
follow_up = client.responses.create(
model="grok-4.5",
input=[
{"type": "function_call_output",
"call_id": item.call_id,
"output": json.dumps(result)}
],
tools=tools,
previous_response_id=response.id
)
El campo previous_response_id
La API de Responses introduce un mecanismo de encadenamiento de conversaciones mediante previous_response_id. En lugar de reenviar todo el historial de mensajes, basta con hacer referencia a la respuesta anterior:
# Primera solicitud
response1 = client.responses.create(
model="grok-4.5",
input="Look up the weather in Paris"
)
# Segunda solicitud (encadenada)
response2 = client.responses.create(
model="grok-4.5",
input=[{
"type": "function_call_output",
"call_id": response1.output[0].call_id,
"output": {temp: 22}
}],
previous_response_id=response1.id
)
Esto simplifica la gestión del contexto y reduce el tamaño de las solicitudes.
Almacenamiento de mensajes en el servidor
Con store_messages=True, xAI almacena los mensajes en sus servidores:
response = client.responses.create(
model="grok-4.5",
input="User question",
tools=tools,
store_messages=True
)
Combinado con previous_response_id, esto te permite mantener conversaciones largas sin necesidad de reenviar el historial completo en cada solicitud.
¿Cuándo usar la API de Responses?
Para un proyecto nuevo construido específicamente sobre xAI, la API de Responses es la opción predeterminada por varias razones acumulativas. Las innovaciones llegan aquí primero: las nuevas funcionalidades se añaden a la API de Responses antes que a ningún otro lugar, y a veces de forma exclusiva. Ciertas herramientas integradas del servidor solo están disponibles a través de este canal. Además, para conversaciones largas, el encadenamiento mediante previous_response_id es estructuralmente más eficiente que reenviar el historial completo en cada turno: se transfieren menos tokens y hay menos código de gestión de estado en tu lado.
Chat Completions mantiene dos casos de uso sólidos: el código existente escrito para la API de OpenAI, que funciona tal cual cambiando la URL base, y los proyectos con múltiples proveedores donde la portabilidad tiene prioridad; en estas situaciones, la compatibilidad pesa más que las funcionalidades exclusivas.
Puntos clave
- La API de Responses utiliza
function_call_outputen lugar del roltool - Los campos cambian:
call_iden lugar detool_call_id,outputen lugar decontent previous_response_idpermite encadenar conversaciones sin reenviar el historialstore_messages=Truehabilita el almacenamiento en el servidor- La API de Responses es el endpoint recomendado para nuevos proyectos en xAI
- Chat Completions sigue disponible para la compatibilidad hacia atrás con OpenAI