TokenLab

Texte

Récupérer une réponse

Récupère une réponse stockée par ID, ou interroge une réponse en arrière-plan.

GET
/v1/responses/{id}

Aperçu

Renvoie une réponse créée par Créer une réponse. Utilisez-la pour interroger une réponse background jusqu'à ce que son status soit final, ou pour lire à nouveau une réponse stockée.

  • Quelles réponses : Les réponses créées avec store non défini sur false, ainsi que les réponses background. Avec store: false, TokenLab ne conserve rien à renvoyer.
  • Rétention : TokenLab conserve une réponse stockée pendant 24 heures. Certaines restent récupérables jusqu'à 30 jours, mais ne comptez pas là-dessus : enregistrez le résultat dont vous avez besoin. Après sa période de rétention, l'ID renvoie 404.
  • Propriété : Vous ne pouvez lire que les réponses créées dans votre propre compte. Un ID provenant d'un autre compte renvoie 404, tout comme un ID inconnu.
  • Statut : queued, in_progress, completed, incomplete, failed ou cancelled. Vérifiez le status, pas seulement le code HTTP.

stream et starting_after s'appliquent tant qu'une réponse est en cours d'exécution. Une réponse terminée est renvoyée au format JSON. include et include_obfuscation sont transmis lorsque le modèle les prend en charge.

Exemple

Requête

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

Exemple de réponse

Réponse

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
  }
}

Erreurs

StatutCodeSignification
404response_not_foundL'ID est inconnu, appartient à un autre compte, a été supprimé, a été créé avec store: false, ou a dépassé sa période de rétention.
502upstream_response_read_failedTokenLab n'a pas pu lire la réponse du service qui l'a produite. Réessayez plus tard.
503response_state_unavailable, response_result_unavailableL'état de la réponse est temporairement indisponible. Réessayez plus tard.

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Paramètres de chemin

id*string

ID de réponse renvoyé par POST /v1/responses.

Paramètres de requête

include?array<string>

Champs de réponse supplémentaires à inclure, transmis si le modèle les prend en charge.

include_obfuscation?boolean

Indique si les événements diffusés incluent des champs d'obfuscation, transmis si le modèle les prend en charge.

stream?boolean

Indique si la réponse doit être récupérée sous forme de flux d'événements. S'applique tant que la réponse est en cours ; une réponse terminée est renvoyée au format JSON.

starting_after?integer

Numéro de séquence après lequel les événements de flux sont renvoyés. S'applique uniquement avec stream.

Réponse

application/json

application/json

application/json

application/json