كيفية استخدام Claude Haiku 5.5 API؟

لاستخدام واجهة برمجة تطبيقات Claude Haiku 5.5، أرسل طلب POST إلى https://api.anthropic.com/v1/messages مع "model": "claude-haiku-5-5"، ومفتاحك في ترويسة x-api-key، و anthropic-version: 2023-06-01. تكلفتها 0.10 دولار / 0.50 دولار لكل مليون رمز إدخال/إخراج للمطالبات التي تصل إلى 100 ألف رمز (0.50 دولار / 2.50 دولار فوق ذلك)، وتقرأ ما يصل إلى مليون رمز سياقي، وتكتب ما يصل إلى 128 ألف رمز، وتستخدم بشكل افتراضي مستوى جهد medium مع تفعيل التفكير التكيفي.

أطلقت Anthropic نموذج Haiku 5.5 في 7 أكتوبر 2026، وهو أول نموذج Haiku بمستويات جهد (ما هو Claude Haiku 5.5 يغطي المواصفات والموضع). يغطي هذا الدليل أول استدعاء باستخدام curl و Python و TypeScript، ثم الجهد والتفكير والتخزين المؤقت والدفعات والرفض ومجموعات أدوات الوكيل. يمكنك حفظ كل طلب أدناه والتحقق منه في Apidog.

button

نظرة سريعة على واجهة برمجة تطبيقات Claude Haiku 5.5

المصادر: صفحة نموذج Haiku 5.5 ووثائق تسعير واجهة برمجة تطبيقات Claude.

أول استدعاء لواجهة برمجة تطبيقات Claude Haiku 5.5

أنشئ مفتاحًا في وحدة تحكم Claude (يشرح دليل مفتاح API الخاص بـ Anthropic كيفية القيام بذلك) وقم بتصديره كـ ANTHROPIC_API_KEY. لا تلصق المفتاح أبدًا في التعليمات البرمجية. ثم أرسل هذا:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 4096,
    "output_config": {"effort": "medium"},
    "thinking": {"type": "adaptive", "display": "summarized"},
    "messages": [{"role": "user", "content": "Classify this ticket as billing, bug, or feature request: The export button times out on large projects."}]
  }'

تقوم حزمة تطوير البرامج (SDK) لـ Python بالتقاط ANTHROPIC_API_KEY من البيئة:

import anthropic

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=4096,
    output_config={"effort": "medium"},
    thinking={"type": "adaptive", "display": "summarized"},
    messages=[{"role": "user", "content": "Classify this ticket as billing, bug, or feature request: The export button times out on large projects."}],
)

for block in response.content:
    if block.type == "thinking":
        print("[thinking]", block.thinking)
    elif block.type == "text":
        print(block.text)
print(response.stop_reason, response.usage)

تتبع TypeScript نفس الشكل:

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();
const response = await client.messages.create({
  model: "claude-haiku-5-5",
  max_tokens: 4096,
  output_config: { effort: "medium" },
  thinking: { type: "adaptive", display: "summarized" },
  messages: [
    { role: "user", content: "Classify this ticket as billing, bug, or feature request: The export button times out on large projects." },
  ],
});

for (const block of response.content) {
  if (block.type === "text") console.log(block.text);
}
console.log(response.stop_reason, response.usage);

ثلاث عادات تبقي هذه التعليمات البرمجية تعمل. حدد كتل المحتوى بواسطة type، لأن الاستجابة يمكن أن تبدأ بكتلة thinking و content[0].text سيتعطل. اترك مساحة إضافية في max_tokens، لأن رموز التفكير تُحتسب ضمنها. وحافظ على نظافة نص الطلب: لا temperature، ولا top_p، ولا top_k، ولا budget_tokens، ولا ملء مساعد مسبقًا. كل واحد منها يُرجع 400 في هذا النموذج. إذا كنت تنقل تعليمات برمجية قديمة، فإن دليل مقارنة Haiku 5.5 بـ Haiku 4.5 يسرد كل تغيير جذري مع JSON قبل/بعد.

اختر مستوى الجهد

الجهد، المحدد في output_config.effort، هو المفتاح الرئيسي للجودة والتأخير والتكلفة. يقدم دليل المطالبات نقاط البداية هذه:

• low: المستوى الأرخص والأسرع، للمحادثة، ومهام الأدوات القصيرة، والطلبات البسيطة ذات الحجم الكبير.
• medium: الافتراضي. ابدأ من هنا لمعظم الأعمال، بما في ذلك البرمجة الوسيطة (agentic coding).
• high: أعمال المعرفة، مهام الوكيل الأطول، واتباع التعليمات الصارمة.
• xhigh و max: فقط عندما تُظهر تقييماتك تحسنًا. تقترح Anthropic تشغيل نفس التقييمات على Claude Sonnet 5.5 والمقارنة.

منحنى التكلفة حاد. إليك نتائج تشغيل Anthropic الخاصة بـ OSWorld 2.1 (مجموعة فرعية غير متصلة بالإنترنت) من الرسوم البيانية للإطلاق، مع درجة الائتمان الجزئي والتكلفة لكل محاولة:

الانتقال من xhigh إلى max يضاعف التكلفة لأقل من خمس نقاط. يحتوي تحليل معايير Haiku 5.5 على الرسوم البيانية الأخرى لكل مستوى جهد.

ملاحظة غريبة: عند استخدام xhigh في المحادثات متعددة الأدوار، يكتب النموذج أحيانًا إجابته كاملة في جزء "التفكير" وينهي الدور بدون نص مرئي. تحقق من وجود رد فارغ قبل عرضه للمستخدم.

التحكم في التفكير

التفكير التكيفي مفعل افتراضيًا، وقد تغير شيئان عن Haiku 4.5. أولاً، العرض الافتراضي يخفي النص. تعود كل كتلة thinking بحقل thinking فارغ وتوقيع signature فقط. عيّن "display": "summarized" (كما في الاستدعاء الأول) عندما تريد ملخصات قابلة للقراءة في السجلات أو واجهة المستخدم. للحصول على تفكير أقل، قلل الجهد؛ مطالبة النموذج بالإجابة مباشرة لم توقفه في اختبارات Anthropic.

ثانيًا، يمكنك إيقاف التفكير، ولكن فقط عند مستوى جهد high أو أقل:

{
  "model": "claude-haiku-5-5",
  "max_tokens": 1024,
  "thinking": {"type": "disabled"},
  "output_config": {"effort": "low"},
  "messages": [{"role": "user", "content": "Extract the invoice number from: INV-2291, due Nov 3."}]
}

نفس النص عند xhigh أو max يُرجع 400. يتم قبول tool_choice الإجباري (any أو أداة مسماة)، لكن الاستجابة تبدأ باستدعاء الأداة ولا تحتوي على كتلة تفكير.

للمحادثات متعددة الأدوار وحلقات الوكيل، أعد كل كتلة تفكير كما هي واجعل السجل مضافًا إليه فقط. تغيير system أو tools أو messages السابقة قبل كتلة تفكير مسترجعة يمكن أن يُرجع 400، وتعمل كتل التفكير فقط في الحساب الذي أنتجها (أو حساب مرتبط به).

تخزين المطالبات والمهام الدفعية مؤقتًا

التخزين المؤقت هو ما يجعل Haiku 5.5 رخيصًا. للمطالبات التي تصل إلى 100 ألف رمز، تكلف قراءة ذاكرة التخزين المؤقت 0.01 دولار لكل مليون رمز مقابل 0.10 دولار للإدخال الجديد، وتكلفة الكتابة في ذاكرة التخزين المؤقت لمدة 5 دقائق 0.125 دولار، وتكلفة الكتابة لمدة ساعة واحدة 0.20 دولار. الحد الأدنى للمطالبة القابلة للتخزين المؤقت هو 512 رمزًا، انخفاضًا من 4,096 في Haiku 4.5، لذا فإن مطالبات النظام القصيرة وقوائم الأدوات مؤهلة الآن. ضع علامة على البادئة الثابتة باستخدام cache_control:

{
  "model": "claude-haiku-5-5",
  "max_tokens": 1024,
  "system": [{
    "type": "text",
    "text": "You are a support triage assistant. <long, stable policy text here>",
    "cache_control": {"type": "ephemeral"}
  }],
  "messages": [{"role": "user", "content": "Ticket: refund not received after 10 days."}]
}

تغيير مستوى effort العلوي بين الطلبات يبطل ذاكرة التخزين المؤقت؛ الجهد لكل رسالة (ترويسة تجريبية mid-conversation-output-config-2026-07-01، واجهة برمجة تطبيقات Claude و Google Cloud) يحافظ عليها. تغطي وثائق التخزين المؤقت للمطالبات قيم TTL، ويغطي شرحنا للتخزين المؤقت للمطالبات المفهوم.

للعمل الذي يمكن أن ينتظر، تقلل واجهة برمجة تطبيقات دفعات الرسائل الإدخال والإخراج بنسبة 50%: 0.05 دولار / 0.25 دولار للمطالبات التي تصل إلى 100 ألف رمز و 0.25 دولار / 1.25 دولار فوق ذلك. الدفعات هي أيضًا الطريق الوحيد للحصول على 300 ألف رمز إخراج، باستخدام ترويسة التجريبية output-300k-2026-03-24.

راقب حد الـ 100 ألف: "المطالبة التي تتجاوز 100,000 رمز تدفع أسعارًا أعلى،" على حد تعبير Anthropic. يستعرض دليل تسعير Haiku 5.5 أمثلة من الجانبين.

التعامل مع stop_reason "الرفض"

يشغل Haiku 5.5 مصنفات أمان يمكنها رفض طلب، ولا يحتوي على حل بديل من جانب الخادم. يعود الطلب المرفوض بـ stop_reason: "refusal"، والفئات هي cyber، frontier_llm، bio، و general_harms. إذا كنت تنتقل من Haiku 4.5، فهذه الرفوضات جديدة. إعادة إرسال نفس الطلب عادة ما يُرجع رفضًا آخر، لذا لا تُعد المحاولة بشكل أعمى:

def run(client, messages):
    response = client.messages.create(
        model="claude-haiku-5-5",
        max_tokens=4096,
        messages=messages,
    )
    if response.stop_reason == "refusal":
        details = getattr(response, "stop_details", None)
        category = getattr(details, "category", "unknown")
        log_refusal(category, messages)  # your logging
        return {"status": "refused", "category": category}
    text = "".join(b.text for b in response.content if b.type == "text")
    return {"status": "ok", "text": text}

قم بالتحقق من stop_reason قبل قراءة content، ووجّه الرفض إلى شخص أو نموذج آخر في التعليمات البرمجية الخاصة بك. يمكن للفرق التي تقوم بعمل مشروع في مجالات الأمن أو علوم الحياة وتم حظرها بواسطة مصنفات cyber أو bio التقديم لبرنامج التحقق من الأمن السيبراني أو برنامج التحقق من علوم الحياة في Anthropic.

استخدام الكمبيوتر واستخدام المتصفح

على واجهة برمجة تطبيقات Claude و Google Cloud، يدعم Haiku 5.5 استخدام الكمبيوتر فقط من خلال مجموعة أدوات computer_toolset_20260801، والتي لا تحتاج إلى ترويسة تجريبية؛ الإعلان عن computer_20250124 يُرجع 400. يتم استخدام المتصفح عبر browser_toolset_20260801، الذي لا يدعمه Haiku 4.5. أضافت حزم تطوير البرامج (SDKs) لـ Python و TypeScript فئات تجريبية لكليهما في يوم الإطلاق. راجع وثائق أداة استخدام الكمبيوتر للأدوات الأعضاء.

حدود المعدل

يمتلك Haiku 5.5 نفس حدود المعدل مثل Haiku 4.5: 1,000 طلب، 2 مليون رمز إدخال و 400 ألف رمز إخراج في الدقيقة على مستوى Start، حتى 10,000 طلب، 10 مليون إدخال و 2 مليون إخراج على مستوى Scale. لا يتم دعم مستوى الأولوية. للتعامل مع رمز 429، راجع دليل تجاوز حد المعدل.

اختبر واجهة برمجة تطبيقات Claude Haiku 5.5 في Apidog

الطلبات المحفوظة تجعل مقارنات الجهد وتصحيح أخطاء الرفض قابلة للتكرار. إليك الإعداد في Apidog:

1. أنشئ بيئة وأضف ANTHROPIC_API_KEY كمتغير سري. ارجع إليه كـ {{ANTHROPIC_API_KEY}} في ترويسة x-api-key، بجوار anthropic-version: 2023-06-01 و content-type: application/json.
2. أنشئ طلب POST إلى https://api.anthropic.com/v1/messages، الصق نص الاستدعاء الأول، واحفظه.
3. أضف تأكيدات: الحالة هي 200، $.stop_reason يساوي end_turn، $.usage.output_tokens أكبر من 0، و $.content[*].type يحتوي على text. الآن يفشل الرفض أو رد xhigh الفارغ الاختبار بدلاً من المرور.
4. انسخ الطلب أربع مرات باستخدام low، high، xhigh، و max، وشغل المجلد. ستحصل على usage لكل مستوى جهد على المطالبة الخاصة بك.
5. أضف المتغير ذو المطالبة النظامية المخزنة مؤقتًا وتأكد من أن $.usage.cache_read_input_tokens أكبر من 0 في التشغيل الثاني.

لأنماط أوسع، راجع اختبار تطبيقات LLM.

الأسئلة الشائعة

ما هو معرف نموذج Claude Haiku 5.5؟ claude-haiku-5-5، بدون لاحقة تاريخ وبدون اسم مستعار منفصل، على واجهة برمجة تطبيقات Claude، و Google Cloud، و Microsoft Foundry، و Claude Platform على AWS. على Amazon Bedrock هو anthropic.claude-haiku-5-5.

هل توجد واجهة برمجة تطبيقات Claude Haiku 5.5 مجانية؟ لا توجد طبقة مجانية مستمرة، ولكن يحصل مستخدمو واجهة برمجة التطبيقات الجدد على كمية صغيرة من الرصيد المجاني لاختبار واجهة برمجة التطبيقات. يمكن لمستخدمي Claude.ai المجانيين تحديد Haiku 5.5 في الدردشة، ولكن هذا ليس مفتاح API. تتضمن خطط Max و Team الآن أرصدة API شهرية. يغطي دليل الوصول المجاني ما يُحتسب وما لا يُحتسب.

لماذا يُرجع طلب Haiku 4.5 الخاص بي 400؟ تحقق من budget_tokens، أو temperature أو top_p غير الافتراضي، أو أي top_k، أو ملء مساعد مسبقًا، أو أداة computer_20250124 القديمة. هذه هي الأسباب المعتادة.

هل يمكنني استخدام Haiku 5.5 في Claude Code؟ نعم، بدءًا من الإصدار 2.1.293. على واجهة برمجة تطبيقات Anthropic، يشير الاسم المستعار haiku إلى Haiku 5.5. راجع Claude Haiku 5.5 في Claude Code.

هل يجب علي استخدام Haiku 5.5 أم Sonnet 5.5 للبرمجة الوسيطة (agentic coding)؟ تقول Anthropic إن Sonnet 5.5 و Opus 5.5 "يظلان خيارات أفضل لمهام البرمجة الوسيطة المعقدة." استخدم Haiku 5.5 للأعمال ذات النطاق الضيق: التصنيف، التلخيص، الضغط، الوكلاء الفرعيين، واستخدام المتصفح.

الخطوة التالية

أرسل طلب الاستدعاء الأول على مستوى medium، ثم أعد تشغيله على مستوى low و high باستخدام مطالبة من عبء عملك الخاص وقارن usage.output_tokens وجودة الإجابة. قم بتنزيل Apidog للاحتفاظ بجميع عمليات التشغيل الثلاث مع التأكيدات، بحيث يكون إصدار النموذج التالي تغييرًا في حقل واحد.

button