الملفات والدفعات
استرجاع نتائج دفعة الرسائل
بث نتائج دفعة الرسائل (Message Batch) بتنسيق JSONL.
نظرة عامة
قم ببث نتائج دفعة الرسائل بتنسيق JSONL، سطر واحد لكل طلب. اقرأ النتائج بعد أن تصبح حالة processing_status هي ended. هذا هو نفس الرابط الموجود في results_url داخل كائن الدفعة.
ملاحظات
- كل سطر هو
{"custom_id": "...", "result": {...}}. الأسطر ليست بترتيب ثابت؛ قم بمطابقة كل منها باستخدامcustom_id. result.typeيكون إماsucceeded(معmessage، وهو نفس نص استجابة إنشاء رسالة)، أوerrored(معerror)، أوcanceled، أوexpired.- في
message،modelهو معرف النموذج الذي أرسلته في الطلب. - الدفعة غير الموجودة أو التي تم حذفها تُرجع
404. الدفعة التي لم تصبح جاهزة للقراءة بعد قد تُرجع409؛ حاول مرة أخرى لاحقاً.
الطلب
curl -X GET "https://api.tokenlab.sh/v1/messages/batches/msgbatch_01ABC123/results" \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01"الاستجابة
{"custom_id":"request-1","result":{"type":"succeeded","message":{"id":"msg_abc123","type":"message","role":"assistant","content":[{"type":"text","text":"Hello! How can I help you today?"}],"model":"claude-sonnet-5","stop_reason":"end_turn","stop_sequence":null,"usage":{"input_tokens":10,"output_tokens":9}}}}
{"custom_id":"request-2","result":{"type":"errored","error":{"type":"error","error":{"type":"invalid_request_error","message":"messages: at least one message is required"}}}}
{"custom_id":"request-3","result":{"type":"canceled"}}
{"custom_id":"request-4","result":{"type":"expired"}}حقول هامة
custom_idstring
معرف
custom_id الذي قمت بتعيينه في الطلب.result.typestring
إما
succeeded أو errored أو canceled أو expired.result.messageobject
الرسالة، عندما يكون
result.type هو succeeded.result.errorobject
الخطأ، عندما يكون
result.type هو errored.التفويض
BearerAuth AuthorizationBearer <token>
مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
message_batch_id*string
معرف دفعة الرسائل.
الاستجابة
application/x-ndjson
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json