Texto

Obtener respuesta

Recupera una respuesta almacenada por ID, o consulta el estado de una respuesta en segundo plano.

GET
/v1/responses/{id}

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 store distinto de false, y respuestas background. Con store: 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, failed o cancelled. Verifique el status, 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.

Ejemplo

Solicitud

cURL
curl -X GET "https://api.tokenlab.sh/v1/responses/resp_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

Ejemplo de respuesta

Respuesta

200 OK
{
  "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

EstadoCódigoSignificado
404response_not_foundEl ID es desconocido, pertenece a otra cuenta, fue eliminado, se creó con store: false o ha superado su periodo de retención.
502upstream_response_read_failedTokenLab no pudo leer la respuesta del servicio que la produjo. Inténtelo de nuevo más tarde.
503response_state_unavailable, response_result_unavailableEl estado de la respuesta no está disponible temporalmente. Inténtelo de nuevo más tarde.

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de ruta

id*string

ID de respuesta devuelto por POST /v1/responses.

Parámetros de consulta

include?array<string>

Campos de respuesta adicionales a incluir, reenviados donde el modelo los admite.

include_obfuscation?boolean

Indica si los eventos transmitidos incluyen campos de ofuscación, reenviados donde el modelo los admite.

stream?boolean

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.

starting_after?integer

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