v0.4.0

OpenAPI 3.1.0

إنشاء رسالة Claude

Felo API Support

MIT

الخادم

https://openapi.felo.ai

مكتبات العملاء

Shell Curl

إنشاء رسالة Claude

نقطة نهاية متوافقة مع واجهة Messages من Claude. اضبط stream=true لتلقي أحداث بث الرسائل بنمط Claude. تتبع حقول الطلب والاستجابة وأخطاء التحقق بروتوكول Messages من Claude؛ وقد يعيد Router أيضًا مغلّف خطأ بوابة مُعقَّمًا لأعطال البنية التحتية.

الرؤوس

X-Felo-Channel
النوع: string

رموز قنوات عامة مرتبة ومفصولة بفواصل. احذف هذه الترويسة لاستخدام default؛ ويجب استخدام default وحده. في وضع المحفظة، يفحص default ترتيب القنوات العامة الفعلية للنموذج بترتيب عكسي، ويتخطى القنوات غير المنشورة أو غير المتاحة، ويختار مزوّد أول قناة متاحة. ويشمل نقاط النهاية المتاحة من ذلك المزوّد ذات معرّف النموذج الأعلى ومستوى الخدمة نفسيهما. تُتحقق القنوات الصريحة بالترتيب الذي يحدده العميل؛ ولا تُقدَّم سوى مجموعة مزوّد القناة الأولى. لا يوجد رجوع تلقائي إلى مزوّدين آخرين. لا يمكن لترويسات المزوّد القديمة تجاوز توجيه القنوات.

الجسم·ClaudeMessagesRequest

مطلوب

application/json

max_tokens
النوع: integer
الحد الأدنى:
1
مطلوب

Integer numbers.
messages
النوع: array object[] · ClaudeMessage[] 1…
مطلوب
- content
  مطلوب
  النوع: string
- role
  النوع: string تعداد
  مطلوب
  القيم
  user
  assistant
- propertyName
  النوع: anything
model
النوع: string
مطلوب
metadata
النوع: object
- propertyName
  النوع: anything
service_tier
النوع: string | null

لا يُدعم حاليًا سوى default (standard). عند الحذف أو null أو الأسماء البديلة أو السلاسل غير المدعومة، يحدث رجوع إلى default؛ وتعيد الأنواع الأخرى HTTP 400. تبقى القنوات والأسعار المُهيَّأة دون تغيير. ترسل واجهات API النصية القيمة القياسية للمزوّد؛ وتحذف واجهات Decisions والتوليد حقل المنبع.
stop_sequences
النوع: array string[]
stream
النوع: boolean
system
النوع: string
temperature
النوع: number
الحد الأدنى:
0
الحد الأقصى:
1
thinking
النوع: object
- propertyName
  النوع: anything
tool_choice
النوع: string
tools
النوع: array object[]
- propertyName
  النوع: anything
propertyName
النوع: anything

top_k
النوع: integer
الحد الأدنى:
0

Integer numbers.
top_p
النوع: number
الحد الأدنى:
0
الحد الأقصى:
1
propertyName
النوع: anything

الاستجابات

200
النوع: object · ClaudeMessageResponse

رسالة Claude أو استجابة بث
content
النوع: array object[] · ClaudeContentBlock[]
مطلوب
type
النوع: string تعداد
مطلوب
القيم
text
image
document
tool_use
tool_result
thinking
content
النوع: string | array
id
النوع: string
input
النوع: object
propertyName
النوع: anything
name
النوع: string
source
النوع: object
propertyName
النوع: anything
text
النوع: string
propertyName
النوع: anything
id
النوع: string
مطلوب
model
النوع: string
مطلوب
role
ثابت:
assistant
مطلوب
stop_reason
النوع: string | null
مطلوب
type
ثابت:
message
مطلوب
stop_sequence
النوع: string | null
usage
النوع: object · Usage

كائن استخدام المزوّد. تختلف الحقول حسب نقطة النهاية والمزوّد.

propertyName
النوع: anything
propertyName
النوع: anything
400
النوع: object · ClaudeErrorResponse

خطأ invalid_request_error من Claude أو خطأ تحقق الطلب من Router

مغلّف أخطاء متوافق مع واجهة Errors من Claude لطلبات Messages.
error
النوع: object
مطلوب
message
النوع: string
مطلوب
type
النوع: string
مطلوب
propertyName
النوع: anything
type
ثابت:
error
مطلوب
request_id
النوع: string
propertyName
النوع: anything
application/json
401
النوع: object · ClaudeErrorResponse

مفتاح API من Felo غير صالح أو مفقود

مغلّف أخطاء متوافق مع واجهة Errors من Claude لطلبات Messages.
error
النوع: object
مطلوب
message
النوع: string
مطلوب
type
النوع: string
مطلوب
propertyName
النوع: anything
type
ثابت:
error
مطلوب
request_id
النوع: string
propertyName
النوع: anything
application/json
402
النوع: object · ClaudeErrorResponse

الرصيد غير كافٍ

مغلّف أخطاء متوافق مع واجهة Errors من Claude لطلبات Messages.
error
النوع: object
مطلوب
message
النوع: string
مطلوب
type
النوع: string
مطلوب
propertyName
النوع: anything
type
ثابت:
error
مطلوب
request_id
النوع: string
propertyName
النوع: anything
application/json
403
النوع: object · ClaudeErrorResponse

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

مغلّف أخطاء متوافق مع واجهة Errors من Claude لطلبات Messages.
error
النوع: object
مطلوب
message
النوع: string
مطلوب
type
النوع: string
مطلوب
propertyName
النوع: anything
type
ثابت:
error
مطلوب
request_id
النوع: string
propertyName
النوع: anything
application/json
429
النوع: object · ClaudeErrorResponse

تم بلوغ حد الإنفاق أو حد الطلبات

مغلّف أخطاء متوافق مع واجهة Errors من Claude لطلبات Messages.
error
النوع: object
مطلوب
message
النوع: string
مطلوب
type
النوع: string
مطلوب
propertyName
النوع: anything
type
ثابت:
error
مطلوب
request_id
النوع: string
propertyName
النوع: anything
application/json
502
النوع: object · ClaudeErrorResponse

فشل طلب مزوّد المنبع

مغلّف أخطاء متوافق مع واجهة Errors من Claude لطلبات Messages.
error
النوع: object
مطلوب
message
النوع: string
مطلوب
type
النوع: string
مطلوب
propertyName
النوع: anything
type
ثابت:
error
مطلوب
request_id
النوع: string
propertyName
النوع: anything
application/json
503
النوع: object · ClaudeErrorResponse

المزوّد أو خدمة الفوترة غير متاح

مغلّف أخطاء متوافق مع واجهة Errors من Claude لطلبات Messages.
error
النوع: object
مطلوب
message
النوع: string
مطلوب
type
النوع: string
مطلوب
propertyName
النوع: anything
type
ثابت:
error
مطلوب
request_id
النوع: string
propertyName
النوع: anything
application/json

post/api/v1/messages

curl https://openapi.felo.ai/api/v1/messages \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "model": "claude-sonnet-4-5",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Write a one-sentence greeting."
    }
  ],
  "stream": false
}'

عرض المخطط

{
  "id": "string",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "string",
      "id": "string",
      "name": "string",
      "input": {
        "additionalProperty": "anything"
      },
      "content": "string",
      "source": {
        "additionalProperty": "anything"
      },
      "additionalProperty": "anything"
    }
  ],
  "model": "string",
  "stop_reason": null,
  "stop_sequence": null,
  "usage": {
    "additionalProperty": "anything"
  },
  "additionalProperty": "anything"
}

رسالة Claude أو استجابة بث

إنشاء رسالة Claude

المصادقةRequired

إنشاء رسالة Claude