Ir al contenido principal
Español— Elegir un idioma
Menú

La API de Responses y function_call_output

Lección 10 de 14 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. La API de Responses: el nuevo endpoint
  2. Diferencias respecto a Chat Completions
  3. Uso de la API de Responses con el SDK de OpenAI
  4. Gestión de la respuesta
  5. El campo previous_response_id
  6. Almacenamiento de mensajes en el servidor
  7. ¿Cuándo usar la API de Responses?
  8. Puntos clave

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 a role: "tool"
  • call_id sustituye a tool_call_id
  • output sustituye a content

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_output en lugar del rol tool
  • Los campos cambian: call_id en lugar de tool_call_id, output en lugar de content
  • previous_response_id permite encadenar conversaciones sin reenviar el historial
  • store_messages=True habilita 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