مرجع Anthropic Messages لكل النماذج
مرجع صيغة Anthropic Messages الأصلية لنماذج Claude والصالحة لنماذج GPT وGemini، وأثر كل معامل هنا، والتفكير، والتخزين المؤقت، والأخطاء.
في هذه الصفحة
صيغة Anthropic. مع نماذج Claude يمرّ طلبك بصيغته كما هو دون تحويل. وتعمل نماذج GPT وGemini هنا أيضًا، مع الفروق المبيّنة في جدول المعاملات.
https:/ / api.5abeer.ai/ v1/ messagesالمصادقة#
أرسل مفتاحك في الترويسة x-api-key مع anthropic-version: 2023-06-01. العنوان الأساسي بلا /v1، لأن المكتبات تضيف المسار بنفسها. مع مكتبة Anthropic الرسمية اضبط ANTHROPIC_BASE_URL وANTHROPIC_API_KEY، والتفاصيل في العناوين الأساسية. أدوات مثل Claude Code ترسل المفتاح في Authorization: Bearer، وهذا يعمل أيضًا.
مثال سريع#
curl --request POST "https://api.5abeer.ai/v1/messages" \
--header "x-api-key: $KHABEER_API_KEY" \
--header "Content-Type: application/json" \
--header "anthropic-version: 2023-06-01" \
--data '{"model":"claude-sonnet-5.5","max_tokens":512,"messages":[{"role":"user","content":"اكتب فكرة منتج في سطر واحد"}]}'{
"id": "msg_01Xh7",
"type": "message",
"role": "assistant",
"model": "claude-sonnet-5.5",
"content": [
{
"type": "text",
"text": "مرحبًا! كيف أساعدك اليوم؟"
}
],
"stop_reason": "end_turn",
"usage": {
"input_tokens": 21,
"output_tokens": 12
}
}المفتاح يُقرأ من متغير البيئة KHABEER_API_KEY، فلا يظهر في الكود.
المعاملات#
يبيّن كل صف ما يحدث للمعامل مع كل عائلة نماذج: مدعوم أي أننا نمرّره إلى النموذج؛ ويُتجاهل أي أن الطلب يُقبل لكن المعامل بلا أثر، فلا تعتمد عليه؛ ويُرفض أي أن الطلب يفشل. قسنا هذه الحالات على البوابة نفسها.
messagesarrayمطلوبالمحادثة بالدورين user وassistant، والمحتوى نص أو كتل منها الصور ونتائج الأدوات.ClaudeمدعومGPTمدعومGeminiمدعومmax_tokensintegerمطلوبأقصى عدد من توكنات الإخراج.ClaudeمدعومGPTيُتجاهلGeminiمدعومsystemstring | arrayتعليمات النظام، نصًا أو كتلًا.ClaudeمدعومGPTمدعومGeminiمدعومtemperaturenumberدرجة العشوائية في الرد.ClaudeمدعومGPTيُتجاهلGeminiمدعومtop_pnumberأخذ العينات من الاحتمالات الأعلى فقط.ClaudeمدعومGPTيُتجاهلGeminiمدعومtop_kintegerأخذ العينات من أعلى عدد محدد من الخيارات.ClaudeمدعومGPTيُتجاهلGeminiيُتجاهلstop_sequencesarrayنصوص يتوقف عندها الرد.ClaudeمدعومGPTيُتجاهلGeminiمدعومtool_choiceobjectauto أو any أو none أو أداة بعينها.ClaudeمدعومGPTمدعومGeminiيُتجاهلthinkingobjectتفعيل التفكير الممتد وميزانيته budget_tokens.ClaudeمدعومGPTيُتجاهلGeminiيُتجاهلoutput_configobjecteffort لعمق التفكير: low أو medium أو high.ClaudeمدعومGPTمدعومGeminiيُتجاهلcache_controlobjectعلى كتلة محتوى: علامة التخزين المؤقت. التفاصيل في التخزين المؤقت.ClaudeمدعومGPTيُتجاهلGeminiيُتجاهلmetadataobjectuser_id لمعرّف المستخدم النهائي في نظامك.ClaudeمدعومGPTيُتجاهلGeminiيُتجاهلعدّ التوكنات#
يقبل POST /v1/messages/count_tokens الجسم نفسه دون max_tokens، ويعيد input_tokens دون استدعاء النموذج. وإذا لم يتوفر العدّ للنموذج يصلك 404 مع not_found_error، فاجعل العدّ اختياريًا في برنامجك.
الصور في الطلب#
أضف كتلة image إلى content في رسالة user، وفيها source من نوع base64 مع media_type، بجانب كتلة text، كما في مثال الصورة.
البث المتدفق#
مع "stream": true يصلك الرد أحداثًا مسمّاة: message_start، ثم لكل كتلة content_block_start وcontent_block_delta وcontent_block_stop، ثم message_delta بسبب التوقف وأرقام الإخراج، ثم message_stop. الفشل في المنتصف يصلك حدثًا من نوع error ومعه الرمز. التفاصيل في البث المتدفق.
أمثلة#
بث متدفق#
curl -N https://api.5abeer.ai/v1/messages \
-H "x-api-key: $KHABEER_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "Write a product idea in one sentence."
}
],
"stream": true
}'event: message_start
data: {"type":"message_start","message":{"id":"msg_p8a01","type":"message","role":"assistant","model":"claude-opus-5","content":[],"stop_reason":null,"usage":{"input_tokens":21,"output_tokens":1}}}
event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Lumen Notes: "}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"a notebook that turns voice memos "}}
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"into tidy to-do lists."}}
event: content_block_stop
data: {"type":"content_block_stop","index":0}
event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"output_tokens":18}}
event: message_stop
data: {"type":"message_stop"}استدعاء أداة#
curl https://api.5abeer.ai/v1/messages \
-H "x-api-key: $KHABEER_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5",
"max_tokens": 1024,
"tools": [
{
"name": "get_weather",
"description": "Get the weather for a city",
"input_schema": {
"type": "object",
"properties": {
"city": {
"type": "string"
}
},
"required": [
"city"
]
}
}
],
"tool_choice": {
"type": "auto"
},
"messages": [
{
"role": "user",
"content": "What is the weather in Cairo?"
}
]
}'{
"id": "msg_p8a01",
"type": "message",
"role": "assistant",
"model": "claude-opus-5",
"content": [
{
"type": "tool_use",
"id": "toolu_p8a01",
"name": "get_weather",
"input": {
"city": "Cairo"
}
}
],
"stop_reason": "tool_use",
"stop_sequence": null,
"usage": {
"input_tokens": 21,
"output_tokens": 18
}
}التفكير الممتد#
curl https://api.5abeer.ai/v1/messages \
-H "x-api-key: $KHABEER_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5",
"max_tokens": 4096,
"thinking": {
"type": "enabled",
"budget_tokens": 2048
},
"messages": [
{
"role": "user",
"content": "Plan a three-step launch for a note-taking app."
}
]
}'{
"id": "msg_p8a01",
"type": "message",
"role": "assistant",
"model": "claude-opus-5",
"content": [
{
"type": "thinking",
"thinking": "Three steps: audience, channel, timing.",
"signature": "sig_p8a"
},
{
"type": "text",
"text": "Lumen Notes: a notebook that turns voice memos into tidy to-do lists."
}
],
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 21,
"output_tokens": 18
}
}عمق التفكير مع نموذج GPT#
curl https://api.5abeer.ai/v1/messages \
-H "x-api-key: $KHABEER_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"max_tokens": 1024,
"output_config": {
"effort": "low"
},
"messages": [
{
"role": "user",
"content": "Write a product idea in one sentence."
}
]
}'{
"id": "msg_p8a01",
"type": "message",
"role": "assistant",
"model": "gpt-5.6-sol",
"content": [
{
"type": "text",
"text": "Lumen Notes: a notebook that turns voice memos into tidy to-do lists."
}
],
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 21,
"output_tokens": 18
}
}تخزين التعليمات الطويلة مؤقتًا#
curl https://api.5abeer.ai/v1/messages \
-H "x-api-key: $KHABEER_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5",
"max_tokens": 512,
"system": [
{
"type": "text",
"text": "You are the support assistant for Lumen Notes. Product manual: ...",
"cache_control": {
"type": "ephemeral"
}
}
],
"messages": [
{
"role": "user",
"content": "How do I export a note?"
}
]
}'{
"id": "msg_p8a01",
"type": "message",
"role": "assistant",
"model": "claude-opus-5",
"content": [
{
"type": "text",
"text": "Lumen Notes: a notebook that turns voice memos into tidy to-do lists."
}
],
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 21,
"output_tokens": 18
}
}صورة مع السؤال#
curl https://api.5abeer.ai/v1/messages \
-H "x-api-key: $KHABEER_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": [
{
"type": "image",
"source": {
"type": "base64",
"media_type": "image/png",
"data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
}
},
{
"type": "text",
"text": "What is in this image?"
}
]
}
]
}'{
"id": "msg_p8a01",
"type": "message",
"role": "assistant",
"model": "claude-opus-5",
"content": [
{
"type": "text",
"text": "Lumen Notes: a notebook that turns voice memos into tidy to-do lists."
}
],
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 21,
"output_tokens": 18
}
}إعدادات العينة#
curl https://api.5abeer.ai/v1/messages \
-H "x-api-key: $KHABEER_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-pro",
"max_tokens": 300,
"system": "Answer in one sentence.",
"temperature": 0.4,
"top_p": 0.9,
"top_k": 40,
"stop_sequences": [
"END"
],
"metadata": {
"user_id": "user-123"
},
"messages": [
{
"role": "user",
"content": "Write a product idea."
}
]
}'{
"id": "msg_p8a01",
"type": "message",
"role": "assistant",
"model": "gemini-3.1-pro",
"content": [
{
"type": "text",
"text": "Lumen Notes: a notebook that turns voice memos into tidy to-do lists."
}
],
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {
"input_tokens": 21,
"output_tokens": 18
}
}الطلب أعلاه جُرِّب على بيئة الاختبار المحلية يوم 2026-10-02؛ الرد يوضح الشكل، والنص فيه مثال.
الأخطاء#
تصلك الأخطاء بشكل Anthropic، أي "type": "error" والتفاصيل داخل error، ما عدا فحوص المفتاح والرصيد والحدود، فهي تجيب بـ {"code", "message"}. الرموز الشائعة هي نفسها في Chat Completions، والأشكال والرموز التي تظهر أثناء تنفيذ الطلب في الحدود ورموز الأخطاء.
النماذج المتاحة لهذه الصيغة#
Claude Sonnet 5.5الافتراضيالإدخال30 ج.مالإخراج150 ج.مالسياق1M
Claude Opus 5.5الإدخال60 ج.مالإخراج300 ج.مالسياق1M
Claude Fable 5.1الإدخال150 ج.مالإخراج750 ج.مالسياق—
Claude Fable 5الإدخال150 ج.مالإخراج750 ج.مالسياق1M
Claude Opus 4.6الإدخال75 ج.مالإخراج375 ج.مالسياق1M
Claude Opus 4.7الإدخال75 ج.مالإخراج375 ج.مالسياق1M
السعر الرسمي من صفحة المزوّد، بتاريخ 19 أكتوبر 2026.
كل النماذج والأسعارنماذج GPT وGemini تعمل هنا أيضًا، وتجدها في قائمة النماذج.
هل كانت هذه الصفحة مفيدة؟