Referencia de la API
Responses
Crea respuestas multimodales con la API de estilo OpenAI 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.ai/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.