واجهة API لـ Claude Opus 4.8

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

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

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

مقارنة سريعة

Claude Opus 4.8 نص إلى نص

نقطة النهاية

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-opus-4.8-text-to-text',
    messages: [
      {
        role: 'user',
        content: 'Draft a technical decision memo for this architecture choice.'
      }
    ],
    stream: true,
    max_tokens: 2048
  })
});

Claude Opus 4.8 تحليل الملفات

نقطة النهاية

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-opus-4.8-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
  })
});

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

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

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

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

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"claude-opus-4.8-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-opus-4.8-file-analysis","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"claude-opus-4.8-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. استهلك أحداث SSE: أضف choices[0].delta.content للعرض المتدفق وتعامل مع data: [DONE] كاكتمال ناجح.
4. أرسل المدخلات المدعومة فقط: تتجاهل نماذج النص أجزاء الملفات والصور غير المدعومة في العميل الحالي.