Responses

La API de Responses usa input como un campo de entrada unificado. Está diseñada para los modelos más recientes de estilo OpenAI Responses y admite streaming, herramientas, opciones de razonamiento y continuación de respuestas.

Puntos de conexión

Método	Ruta	Descripción
`POST`	`/v1/responses`	Crear una respuesta
`POST`	`/v1/responses/compact`	API de compactación de Responses con menos campos

Campos de la solicitud

Campo	Tipo	Requerido	Descripción
`model`	string	Sí	ID del modelo
`input`	string o array	Sí	Contenido de entrada. Puede incluir `input_text`, `input_image` y `input_file`
`instructions`	string	No	Instrucciones a nivel de sistema
`stream`	boolean	No	Devuelve un stream SSE
`max_output_tokens`	integer	No	Máximo de tokens de salida
`temperature`, `top_p`	number	No	Controles de muestreo
`tools`, `tool_choice`	array/object	No	Configuración de herramientas
`parallel_tool_calls`	boolean	No	Permite llamadas paralelas a herramientas
`max_tool_calls`	integer	No	Máximo de llamadas a herramientas
`previous_response_id`	string	No	Continúa desde una respuesta anterior
`reasoning`	object	No	Opciones de razonamiento, como `effort` y `summary`
`text`	object	No	Configuración de salida de texto
`include`, `truncation`	any	No	Campos de extensión de OpenAI Responses
`metadata`, `user`	any	No	Metadatos o identificador de usuario
`store`, `service_tier`, `safety_identifier`	any	No	Campos de extensión de OpenAI; la configuración del canal puede filtrarlos

curl

curl https://api.tensoraxis.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "input": "Explain what an API gateway is in two sentences"
  }'

Entrada multimodal

{
  "model": "gpt-4o",
  "input": [
    {
      "role": "user",
      "content": [
        {"type": "input_text", "text": "Describe this image"},
        {"type": "input_image", "image_url": "https://example.com/image.png"}
      ]
    }
  ]
}

API de compactación

/v1/responses/compact acepta un cuerpo de solicitud más pequeño:

Campo	Tipo	Requerido	Descripción
`model`	string	Sí	ID del modelo
`input`	any	No	Entrada para compactar
`instructions`	any	No	Instrucciones
`previous_response_id`	string	No	ID de la respuesta anterior

Estructura de la respuesta

Las respuestas siguen la forma de estilo OpenAI Responses. Los campos principales incluyen id, model, output y usage. Las respuestas en streaming devuelven contenido incremental como eventos SSE.