الملفات والدفعات

استرجاع نتائج دفعة الرسائل

بث نتائج دفعة الرسائل (Message Batch) بتنسيق JSONL.

GET
/v1/messages/batches/{message_batch_id}/results

نظرة عامة

قم ببث نتائج دفعة الرسائل بتنسيق JSONL، سطر واحد لكل طلب. اقرأ النتائج بعد أن تصبح حالة processing_status هي ended. هذا هو نفس الرابط الموجود في results_url داخل كائن الدفعة.

ملاحظات

  • كل سطر هو {"custom_id": "...", "result": {...}}. الأسطر ليست بترتيب ثابت؛ قم بمطابقة كل منها باستخدام custom_id.
  • result.type يكون إما succeeded (مع message، وهو نفس نص استجابة إنشاء رسالة)، أو errored (مع error)، أو canceled، أو expired.
  • في message، model هو معرف النموذج الذي أرسلته في الطلب.
  • الدفعة غير الموجودة أو التي تم حذفها تُرجع 404. الدفعة التي لم تصبح جاهزة للقراءة بعد قد تُرجع 409؛ حاول مرة أخرى لاحقاً.

مثال

الطلب

cURL
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"

الاستجابة

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