واجهة API لـ Claude Fable 5

مرجع API كامل لنماذج LLM من Claude Fable 5 المدعومة من Anthropic.

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

تدعم واجهة API هذه ثلاثة متغيرات من نموذج Claude Fable 5:

مقارنة سريعة

Claude Fable 5 Text to Text

Endpoint

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

Claude Fable 5 Web Search

Endpoint

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-fable-5-web-search',
    messages: [
      {
        role: 'user',
        content: 'Find the latest public information about Claude Fable 5 and summarize it for a product brief.'
      }
    ],
    stream: true,
    max_tokens: 2048,
    top_p: 0.9,
    top_k: 50
  })
});

Claude Fable 5 File Analysis

Endpoint

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-fable-5-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.9,
    top_k: 50
  })
});

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

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

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

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

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

data: {"id":"chatcmpl-...","object":"chat.completion.chunk","created":1710000000,"model":"claude-fable-5-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[] بدلا من تسطيح السياق في prompt واحد.
2. اختر متغير النموذج المناسب: استخدم Text to Text للاستدلال النصي فقط، وWeb Search عندما تكون هناك حاجة إلى سياق حالي من الإنترنت، وFile Analysis عندما تكون الملفات أو الصور مطلوبة.
3. اضبط معاملات Claude بعناية: يتم دعم top_p وtop_k عبر متغيرات Claude Fable 5 ويمكنهما تغيير تنوع الإخراج.
4. استهلك أحداث SSE: ألحق choices[0].delta.content لعرض streaming وتعامل مع data: [DONE] باعتباره اكتمالا ناجحا.
5. أرسل فقط المدخلات المدعومة: لا ترسل أجزاء ملف أو صورة إلى مسارات Text to Text أو Web Search.