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.
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
storenon défini surfalse, ainsi que les réponsesbackground. Avecstore: 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,failedoucancelled. Vérifiez lestatus, 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.
Requête
curl -X GET "https://api.tokenlab.sh/v1/responses/resp_abc123" \
-H "Authorization: Bearer sk-your-api-key"Réponse
{
"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
| Statut | Code | Signification |
|---|---|---|
404 | response_not_found | L'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. |
502 | upstream_response_read_failed | TokenLab n'a pas pu lire la réponse du service qui l'a produite. Réessayez plus tard. |
503 | response_state_unavailable, response_result_unavailable | L'état de la réponse est temporairement indisponible. Réessayez plus tard. |
Autorisation
BearerAuth 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 de réponse renvoyé par POST /v1/responses.
Paramètres de requête
Champs de réponse supplémentaires à inclure, transmis si le modèle les prend en charge.
Indique si les événements diffusés incluent des champs d'obfuscation, transmis si le modèle les prend en charge.
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.
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