انتقل إلى المحتوى

مرجع Anthropic Messages لكل النماذج

مرجع صيغة Anthropic Messages الأصلية لنماذج Claude والصالحة لنماذج GPT وGemini، وأثر كل معامل هنا، والتفكير، والتخزين المؤقت، والأخطاء.

آخر تحديث 2 أكتوبر 2026
في هذه الصفحة

صيغة Anthropic. مع نماذج Claude يمرّ طلبك بصيغته كما هو دون تحويل. وتعمل نماذج GPT وGemini هنا أيضًا، مع الفروق المبيّنة في جدول المعاملات.

POSThttps://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⁩، فلا يظهر في الكود.

المعاملات#

يبيّن كل صف ما يحدث للمعامل مع كل عائلة نماذج: مدعوم أي أننا نمرّره إلى النموذج؛ ويُتجاهل أي أن الطلب يُقبل لكن المعامل بلا أثر، فلا تعتمد عليه؛ ويُرفض أي أن الطلب يفشل. قسنا هذه الحالات على البوابة نفسها.

المعاملالوصفClaudeGPTGemini
modelstringمطلوبمعرّف النموذج كما في قائمة النماذج.ClaudeمدعومGPTمدعومGeminiمدعوم
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مدعوم
streambooleanأرسل الرد أحداثًا متتابعة. التفاصيل في البث المتدفق.ClaudeمدعومGPTمدعومGeminiمدعوم
toolsarrayالأدوات بمخطط input_schema. التفاصيل في استدعاء الأدوات.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 تعمل هنا أيضًا، وتجدها في قائمة النماذج.