Texto
Obtener respuesta
Recupera una respuesta almacenada por ID, o consulta el estado de una respuesta en segundo plano.
Descripción general
Devuelve una respuesta creada mediante Crear respuesta. Úselo para consultar una respuesta background hasta que su status sea definitivo, o para leer una respuesta almacenada nuevamente.
- Qué respuestas: Respuestas creadas con
storedistinto defalse, y respuestasbackground. Constore: false, TokenLab no guarda nada para devolver. - Retención: TokenLab mantiene una respuesta almacenada durante 24 horas. Algunas permanecen recuperables hasta por 30 días, pero no dependa de ello: guarde el resultado que necesite. Después de su periodo de retención, el ID devolverá
404. - Propiedad: Solo puede leer respuestas creadas en su propia cuenta. Un ID de otra cuenta devolverá
404, igual que un ID desconocido. - Estado:
queued,in_progress,completed,incomplete,failedocancelled. Verifique elstatus, no solo el código HTTP.
stream y starting_after se aplican mientras una respuesta aún está en ejecución. Una respuesta finalizada se devuelve como JSON. include e include_obfuscation se reenvían cuando el modelo los admite.
Solicitud
curl -X GET "https://api.tokenlab.sh/v1/responses/resp_abc123" \
-H "Authorization: Bearer sk-your-api-key"Respuesta
{
"id": "resp_abc123",
"object": "response",
"created_at": 1706000000,
"status": "completed",
"model": "gpt-5.6-terra",
"output": [
{
"id": "msg_abc123",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [
{"type": "output_text", "text": "Hello! How can I help you today?", "annotations": []}
]
}
],
"usage": {
"input_tokens": 10,
"output_tokens": 12,
"total_tokens": 22
}
}Errores
| Estado | Código | Significado |
|---|---|---|
404 | response_not_found | El ID es desconocido, pertenece a otra cuenta, fue eliminado, se creó con store: false o ha superado su periodo de retención. |
502 | upstream_response_read_failed | TokenLab no pudo leer la respuesta del servicio que la produjo. Inténtelo de nuevo más tarde. |
503 | response_state_unavailable, response_result_unavailable | El estado de la respuesta no está disponible temporalmente. Inténtelo de nuevo más tarde. |
Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de ruta
ID de respuesta devuelto por POST /v1/responses.
Parámetros de consulta
Campos de respuesta adicionales a incluir, reenviados donde el modelo los admite.
Indica si los eventos transmitidos incluyen campos de ofuscación, reenviados donde el modelo los admite.
Indica si se debe recuperar la respuesta como un flujo de eventos. Se aplica mientras la respuesta aún se está ejecutando; una respuesta finalizada se devuelve como JSON.
Número de secuencia a partir del cual se devuelven los eventos de streaming. Se aplica solo con stream.
Respuesta
application/json
application/json
application/json
application/json