Claude Haiku 5.5

استخدم claude-haiku-5-5 مع POST https://api.seedrouter.ai/v1/messages. يقبل النموذج النصوص والصور والمستندات ويُرجع نصًا أو طلبات أدوات. تعرض صفحة النموذج أسعار الرموز الحالية.

يتبع العقد أدناه وثائق Anthropic الخاصة بالنموذج، التي روجعت في 9 أكتوبر 2026. حدود القدرات الرسمية والتحقق من المسار الكامل أمران منفصلان: قبول حقل لا يثبت حدوث أثره المقصود. راجع نتائج التوافق أدناه قبل استخدام الخيارات المتقدمة.

بدء سريع

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Classify this request as billing, technical or account: I was charged twice. Return only the label."}]
  }'

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["SEEDROUTER_API_KEY"],
    base_url="https://api.seedrouter.ai",
)
message = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize the purpose of a database index."}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

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

const client = new Anthropic({
  apiKey: process.env.SEEDROUTER_API_KEY,
  baseURL: 'https://api.seedrouter.ai',
});
const message = await client.messages.create({
  model: 'claude-haiku-5-5',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Summarize the purpose of a database index.' }],
});
for (const block of message.content) {
  if (block.type === 'text') console.log(block.text);
}

احتفظ بمفتاح API على الخادم. اختر كتل الاستجابة بحسب type؛ فقد تبدأ الاستجابة بتفكير أو استدعاء أداة.

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "os"
    "time"
)

func main() {
    body, err := json.Marshal(map[string]any{
        "model": "claude-haiku-5-5",
        "max_tokens": 1024,
        "messages": []map[string]string{
            {"role": "user", "content": "Summarize the purpose of a database index."},
        },
    })
    if err != nil { panic(err) }
    req, err := http.NewRequest("POST", "https://api.seedrouter.ai/v1/messages", bytes.NewReader(body))
    if err != nil { panic(err) }
    req.Header.Set("x-api-key", os.Getenv("SEEDROUTER_API_KEY"))
    req.Header.Set("anthropic-version", "2023-06-01")
    req.Header.Set("Content-Type", "application/json")
    client := &http.Client{Timeout: 2 * time.Minute}
    res, err := client.Do(req)
    if err != nil { panic(err) }
    defer res.Body.Close()
    data, err := io.ReadAll(res.Body)
    if err != nil { panic(err) }
    if res.StatusCode >= 400 { panic(fmt.Sprintf("HTTP %d: %s", res.StatusCode, data)) }
    fmt.Println(string(data))
}

معاملات الطلب

يتضمن العقد الأصلي 25 حقلًا على المستوى الأعلى. الاختيارية لا تعني قبول القيمة الخالية: الصفوف التي تذكر null صراحةً هي وحدها التي تقبلها. تُحذف الحقول غير المعروفة وحقول أخذ العينات غير المدعومة قبل الإرسال، وفق سياسة معاملات النماذج النصية. تُرجع القيم غير الصالحة للحقول المدعومة invalid_request_error قبل التوليد.

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

التفكير والجهد

الإعداد الافتراضي هو التفكير التكيفي بجهد medium مع حذف نص التفكير. يقبل الجهد low أو medium أو high أو xhigh أو max، أو null لاستخدام الإعداد الافتراضي.

{
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "medium"}
}

لتعطيل التفكير، استخدم {"type":"disabled"} بجهد low أو medium أو high. لا تضمّن display أو block_binding في وضع disabled. القيم enabled وbudget_tokens وbetween_tools والتفكير المعطّل عند xhigh/max غير صالحة.

يقبل display في وضع adaptive القيم omitted أو summarized أو null. تتطلب قيمة beta العامة updates الترويسة thinking-display-updates-2026-08-18؛ لا تثبت Anthropic حاليًا توفر تحديثات تقدم مقروءة لـHaiku، لذا لا تعتمد على هذا الإخراج.

يتطلب thinking.block_binding الاختياري thinking-binding-controls-2026-08-01. وهو null أو كائن تكون فيه prefix_mismatch_behavior هي error أو drop_block أو null. أبقِ أدوار المحادثة السابقة وكتل التفكير كاملةً دون تغيير عند إعادة تشغيل السجل. ترتبط تواقيع التفكير بالحساب الذي أنشأها أو بحساب مرتبط به.

يكون output_config.task_budget هو null أو { "type": "tokens", "total": 20000 } مع remaining اختياري من نوع عدد صحيح/null. يتطلب task-budgets-2026-03-13؛ ويجب ألا يقل total عن 20000. لا يُفرض هنا نطاق إضافي لـremaining.

الأدوات والإخراج المنظّم

تتطلب أدوات العميل اسمًا من 1–128 حرفًا أو رقمًا أو شرطة سفلية أو شرطة، وinput_schema يتضمن type: "object". استخدم tool_choice: {"type":"any"} أو {"type":"tool","name":"lookup"} لفرض أداة معلنة. مع التفكير التكيفي، تبدأ استجابة الأداة المفروضة باستدعاء الأداة دون كتلة تفكير.

يكون disable_parallel_tool_use قيمة منطقية اختيارية لخيارات auto وany وtool؛ وليس حقلًا لخيار none. أعِد نتيجة الأداة مع tool_use_id الأصلي. تعرض ساحة التجربة الاستدعاءات لكنها لا تنفّذ أدوات العميل.

{
  "tools": [{
    "name": "lookup",
    "description": "Look up a product by SKU.",
    "input_schema": {
      "type": "object",
      "properties": {"sku": {"type": "string"}},
      "required": ["sku"],
      "additionalProperties": false
    }
  }],
  "tool_choice": {"type": "tool", "name": "lookup"}
}

تستخدم الاستجابات المنظّمة output_config.format: {"type":"json_schema","schema":{...}}. اتبع مجموعة JSON Schema الفرعية التي تدعمها Anthropic، بما فيها additionalProperties: false للكائنات. البنية الصالحة لا تضمن صحة القيم واقعيًا. للأدوات الصارمة والإخراج المنظّم حدود على مستوى المخطط؛ انظر المرجع الرسمي للإخراج المنظّم.

يتطلب استخدام الحاسوب computer_toolset_20260801؛ إصدارات أدوات الحاسوب القديمة غير صالحة. لاستخدام المتصفح تعريفه الخاص browser_toolset_20260801. تعريف أداة لا يثبت نجاح جلسة أدوات خادم كاملة. راجع دليل الأداة الرسمي وأي متطلبات beta قبل استخدامها.

المحادثات وإدارة السياق

الملء المسبق المعتاد لرسالة المساعد غير مدعوم. تختلف متابعة أداة خادم متوقفة مؤقتًا: أعِد إرسال كتل المساعد كاملةً وفق بروتوكول Messages.

يمكن ظهور رسالة نظام تحتوي محتوى بعد رسالة مستخدم أو نتيجة أداة خادم متوقفة مؤقتًا. يجب أن تليها رسالة مساعد أو أن تكون الرسالة الأخيرة. تُقيّم رسائل النظام المتتالية كمجموعة واحدة. لا تُدرج واحدة بين استدعاء أداة عميل ونتيجته المطلوبة.

يمكن لرسالة نظام خالية المحتوى تغيير output_config.effort فقط مع mid-conversation-output-config-2026-07-01. يمكن أن تظهر في أي موضع. عندما يكون التفكير معطّلًا، لا يمكنها تغيير الجهد الفعلي. يقبل clear_at للنظام القيم never أو next_user_message أو null مع mid-conversation-system-clear-at-2026-08-21؛ الرسائل محدودة الدور تسمح بالنص فقط، دون إعدادات إخراج أو تخزين كتل مؤقت.

تشمل تعديلات السياق:

يتطلب compaction عند الطلب compact-2026-09-04. لا يمكن جمعه مع context_management أو stop_sequences أو تنسيق إخراج أو فرض الأدوات أو task_budget.remaining. لا يمكن أيضًا جمع كتلة ضغط موقّعة مع task_budget.remaining أو الضغط عند عتبة. احتفظ بالكتلة والتوقيع المُعادَين عند المتابعة.

الصور وPDF وحجم الطلب

تُقبل صور JPEG وPNG وGIF وWebP عبر URL أو base64 أو مرجع ملف. تُقبل ملفات PDF عبر URL أو base64 أو مرجع ملف. تتطلب مراجع الملفات beta المناسب لـFiles API وصلاحية وصول للملف. يمكن للمستندات النصية استخدام مصادر نصية أو محتوى.

حد الطلب الأصلي هو 32 MB. حدود الصور الرسمية هي حتى 600 صورة، و10 MB من بيانات base64 لكل صورة و8000 بكسل لأي ضلع؛ وقد تخضع الطلبات ذات الصور الكثيرة لحدود أضيق خاصة بالمنصة. يجب ألا تكون ملفات PDF مشفرة، وألا تتجاوز 600 صفحة لحجم سياق هذا النموذج. تظل API مسؤولة عن فحص الملفات البعيدة؛ فحوص البنية المحلية لا تثبت محتويات URL.

ترفع ساحة التجربة المرفقات قبل إرسال عناوين URL. يدعم JSON المحادثة أيضًا كتل محتوى الوسائط الأصلية. اختبارات حدود حجم الوسائط ونافذة السياق الكاملة منفصلة عن طلب مثال صغير.

تخزين التعليمات مؤقتًا والفوترة

الحد الأدنى للتعليمات القابلة للتخزين المؤقت في Haiku هو 512 رمزًا. يمكن تشغيل تعليمات معلّمة أصغر دون إنشاء إدخال تخزين مؤقت. استخدم أربع نقاط فصل تخزين مؤقت كحد أقصى؛ التحكم التلقائي على المستوى الأعلى يستهلك نقطة واحدة. ضع بادئات التخزين الأطول عمرًا قبل الأقصر عمرًا.

يطلب max_tokens: 0 تهيئة التخزين المؤقت دون توليد إجابة. لا يمكن جمعه مع stream: true أو الإخراج المنظّم أو فرض استخدام الأدوات. أبقِ إعدادات التفكير والجهد متسقة بين إعداد التخزين المؤقت والطلبات التي تعيد استخدامه.

اقرأ usage.input_tokens وoutput_tokens وcache_creation_input_tokens وcache_read_input_tokens، وتفصيل 5m/1h ضمن cache_creation. التفكير مشمول في رموز الإخراج؛ تفصيل رموز التفكير المبلّغ عنه ليس رسومًا إضافية تُجمع مجددًا. الأسعار الحالية في قسم الأسعار، مع شرح إضافي في دليل الأسعار.

الاستجابات والبث والأخطاء

تحتوي الاستجابة المكتملة على id وtype: "message" وrole: "assistant" وmodel وcontent وstop_reason وstop_sequence وusage. تُحفظ الحقول الاختيارية container وdiagnostics وcontext_management وstop_details وinput_transformations عند إرجاعها.

تعامل مع end_turn وmax_tokens وstop_sequence وtool_use وpause_turn وcompaction وrefusal وmodel_context_window_exceeded. التوقف عند حد أو الرفض ليس خطأ HTTP. لا تفترض أبدًا أن أول كتلة محتوى نصية بالضرورة.

يستخدم البث أحداث Messages SSE: message_start وcontent_block_start وcontent_block_delta وcontent_block_stop وmessage_delta وmessage_stop. تعامل أيضًا مع أحداث ping وerror. احتفظ بتواقيع التفكير وكتل الأدوات اللازمة للأدوار اللاحقة.

تستخدم الأخطاء تنسيق Anthropic:

{"type":"error","error":{"type":"invalid_request_error","message":"max_tokens must be an integer from 0 to 128000."}}

لا تُفرض رسوم على الطلبات التي تُرجع خطأ. انظر معالجة الأخطاء لأنواع الأخطاء المشتركة.

التنسيقات المتوافقة مع OpenAI

المعرّف نفسه متاح مع /v1/chat/completions و/v1/responses. استخدم حقولهما الأصلية: يستخدم Chat حقل messages؛ ويستخدم Responses حقل input. خيارات Claude الأصلية تخص Messages، ولا ينبغي نسخها بالكامل إلى جسم بتنسيق OpenAI.

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'

curl https://api.seedrouter.ai/v1/responses \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-5-5","max_output_tokens":256,"input":"Reply with OK."}'

نتائج التوافق

تم الفحص في 9 أكتوبر 2026 في بيئة التطوير. تثبت هذه الفحوص السلوك المرصود لطلبات محددة، وليس كل حد رسمي أو النشر في الإنتاج.

لم تجتز فوترة كتابة التخزين المؤقت لساعة والضغط التحقق المطلوب للإصدار. لم تُختبر عمليات السياق/الإخراج الأقصى أو الأدوات المستضافة ذات الرسوم المنفصلة أو الوصول إلى Files API أو استرداد رصيد البدائل. احتفظ ببنى الطلب الرسمية؛ ولا تستنتج الدعم من حالة نجاح وحدها.

المراجع

• نظرة عامة على نموذج Haiku 5.5
• دليل ترحيل Haiku 5.5
• مرجع Messages
• مرجع Beta Messages
• التفكير، الجهد، ميزانيات المهام
• الضغط عند الطلب، تعديل السياق
• تخزين التعليمات مؤقتًا، الرؤية، دعم PDF