Văn bản
Truy xuất phản hồi
Truy xuất một phản hồi đã lưu theo ID, hoặc thăm dò (poll) một phản hồi chạy nền.
Tổng quan
Trả về một phản hồi được tạo bởi Tạo Response. Sử dụng phương thức này để thăm dò một phản hồi background cho đến khi status của nó ở trạng thái cuối cùng, hoặc để đọc lại một phản hồi đã lưu.
- Các phản hồi nào: Các phản hồi được tạo với
storekhông được đặt thànhfalse, và các phản hồibackground. Vớistore: false, TokenLab không lưu trữ bất kỳ dữ liệu nào để trả về. - Thời gian lưu trữ: TokenLab lưu giữ một phản hồi đã lưu trong 24 giờ. Một số phản hồi có thể truy xuất được lên đến 30 ngày, nhưng đừng dựa vào điều đó: hãy lưu lại kết quả bạn cần. Sau thời gian lưu trữ, ID sẽ trả về
404. - Quyền sở hữu: Bạn chỉ có thể đọc các phản hồi được tạo trong tài khoản của chính mình. Một ID từ tài khoản khác sẽ trả về
404, tương tự như một ID không xác định. - Trạng thái:
queued,in_progress,completed,incomplete,failed, hoặccancelled. Hãy kiểm trastatus, không chỉ mã HTTP.
stream và starting_after được áp dụng khi phản hồi vẫn đang chạy. Một phản hồi đã hoàn tất sẽ được trả về dưới dạng JSON. include và include_obfuscation được chuyển tiếp nếu mô hình hỗ trợ chúng.
Yêu cầu
curl -X GET "https://api.tokenlab.sh/v1/responses/resp_abc123" \
-H "Authorization: Bearer sk-your-api-key"Phản hồi
{
"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
}
}Lỗi
| Trạng thái | Mã | Ý nghĩa |
|---|---|---|
404 | response_not_found | ID không xác định, thuộc về tài khoản khác, đã bị xóa, được tạo với store: false, hoặc đã quá thời gian lưu trữ. |
502 | upstream_response_read_failed | TokenLab không thể đọc phản hồi từ dịch vụ đã tạo ra nó. Hãy thử lại sau. |
503 | response_state_unavailable, response_result_unavailable | Trạng thái phản hồi tạm thời không khả dụng. Hãy thử lại sau. |
Xác thực
BearerAuth Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.
Vị trí: header
Tham số đường dẫn
ID phản hồi được trả về bởi POST /v1/responses.
Tham số truy vấn
Các trường phản hồi bổ sung cần bao gồm, được chuyển tiếp nếu model hỗ trợ.
Liệu các sự kiện stream có bao gồm các trường làm nhiễu (obfuscation) hay không, được chuyển tiếp nếu model hỗ trợ.
Liệu có truy xuất phản hồi dưới dạng event stream hay không. Áp dụng khi phản hồi vẫn đang chạy; phản hồi đã hoàn tất sẽ được trả về dưới dạng JSON.
Số thứ tự mà sau đó các sự kiện streaming được trả về. Chỉ áp dụng với stream.
Phản hồi
application/json
application/json
application/json
application/json