واجهة API لـ Claude Sonnet 4.6

مرجع API كامل لنماذج نماذج اللغة الكبيرة Claude Sonnet 4.6 المدعومة بواسطة Anthropic.

متغيرات النموذج

تدعم واجهة API هذه متغيرين من نماذج Claude Sonnet 4.6:

مقارنة سريعة

Claude Sonnet 4.6 نص إلى نص

نقطة النهاية

httpنسخ
POST /api/v1/chat/completions

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

مطلوب

دعم الرسائل

اختياري

مثال طلب

javascriptنسخ
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'claude-sonnet-4.6-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Write a concise product update for a developer audience.'
      }
    ],
    stream: true,
    max_tokens: 2048,
    top_p: 0.5,
    top_k: 50
  })
});

Claude Sonnet 4.6 تحليل الملفات

نقطة النهاية

httpنسخ
POST /api/v1/chat/completions

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

مطلوب

دعم الرسائل

اختياري

مثال طلب

javascriptنسخ
const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Accept': 'text/event-stream',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'claude-sonnet-4.6-file-analysis',
    messages: [
      {
        role: 'user',
        content: [
          { type: 'text', text: 'Summarize this file and extract the key risks.' },
          {
            type: 'file',
            file: {
              filename: 'demo.pdf',
              file_data: 'https://example.com/demo.pdf'
            }
          }
        ]
      }
    ],
    stream: true,
    max_tokens: 4096,
    top_p: 0.5,
    top_k: 50
  })
});

تنسيق الاستجابة

تعيد نماذج LLM Claude Sonnet 4.6 استجابات completion متوافقة مع OpenAI. عند استخدام stream: true تكون الاستجابة Server-Sent Events؛ وعند استخدام stream: false تكون الاستجابة كائن JSON واحدًا.

استجابة ناجحة

textنسخ
data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"claude-sonnet-4.6-file-analysis","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"claude-sonnet-4.6-file-analysis","choices":[{"index":0,"delta":{"content":"Here is a concise summary"},"finish_reason":null}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"claude-sonnet-4.6-file-analysis","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"claude-sonnet-4.6-file-analysis","choices":[],"usage":{"prompt_tokens":12,"completion_tokens":8,"total_tokens":20}}

data: [DONE]

استجابة خطأ

textنسخ
event: error
data: {"error":{"message":"API requests too frequent, exceeding rate limit","type":"rate_limit_error","code":"1302","param":null}}

أفضل الممارسات

1. استخدم الرسائل المنظمة: أرسل سجل المحادثة عبر messages[] بدلاً من تسطيح السياق في موجه واحد.
2. اختر متغير النموذج المناسب: استخدم Text to Text لـ نماذج اللغة الكبيرة النصي فقط، وFile Analysis عند الحاجة إلى ملفات أو صور.
3. اضبط معاملات Claude بعناية: يتم دعم top_p وtop_k ويمكنهما تغيير تنوع المخرجات.
4. استهلك أحداث SSE: ألحِق choices[0].delta.content للعرض المتدفق واستخدم data: [DONE] كاستجابة نهائية.
5. أرسل المدخلات المدعومة فقط: تتجاهل نماذج النص أجزاء الملفات والصور غير المدعومة في العميل الحالي.