Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

ایجاد یک پیام Claude

Felo API Support
MIT
سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت
Shell Curl

ایجاد یک پیام Claude

​

نقطه پایانی سازگار با Claude Messages API. برای دریافت رویدادهای جریان پیام به سبک Claude، stream=true را تنظیم کنید. فیلدهای درخواست، پاسخ و خطای اعتبارسنجی از پروتکل Claude Messages پیروی می‌کنند؛ 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 (استاندارد) پشتیبانی می‌شود. مقادیر حذف‌شده، null، نام‌های مستعار و رشته‌های پشتیبانی‌نشده به default بازمی‌گردند؛ انواع دیگر HTTP 400 برمی‌گردانند. کانال‌ها و قیمت‌های پیکربندی‌شده بدون تغییر می‌مانند. APIهای متنی مقدار استاندارد ارائه‌دهنده را ارسال می‌کنند؛ 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

    Claude invalid_request_error یا خطای اعتبارسنجی درخواست Router

    پاکت خطای سازگار با Claude Errors API برای درخواست‌های Messages.

    • error
      نوع: object
      الزامی
      • message
        نوع: string
        الزامی
      • type
        نوع: string
        الزامی
      • propertyName
        نوع: anything
    • type
      مقدار ثابت:  
      error
      الزامی
    • request_id
      نوع: string
    • propertyName
      نوع: anything
    application/json
  • 401
    نوع: object · ClaudeErrorResponse

    کلید API Felo نامعتبر است یا وجود ندارد.

    پاکت خطای سازگار با Claude Errors API برای درخواست‌های Messages.

    • error
      نوع: object
      الزامی
      • message
        نوع: string
        الزامی
      • type
        نوع: string
        الزامی
      • propertyName
        نوع: anything
    • type
      مقدار ثابت:  
      error
      الزامی
    • request_id
      نوع: string
    • propertyName
      نوع: anything
    application/json
  • 402
    نوع: object · ClaudeErrorResponse

    موجودی ناکافی

    پاکت خطای سازگار با Claude Errors API برای درخواست‌های Messages.

    • error
      نوع: object
      الزامی
      • message
        نوع: string
        الزامی
      • type
        نوع: string
        الزامی
      • propertyName
        نوع: anything
    • type
      مقدار ثابت:  
      error
      الزامی
    • request_id
      نوع: string
    • propertyName
      نوع: anything
    application/json
  • 403
    نوع: object · ClaudeErrorResponse

    حساب مجاز به استفاده از این مدل نیست. مدل‌های غیرفعال نیز پیش از فراخوانی‌های بالادست رد می‌شوند. درخواست‌ها و وظایف پذیرفته‌شده موجود ادامه می‌یابند.

    پاکت خطای سازگار با Claude Errors API برای درخواست‌های Messages.

    • error
      نوع: object
      الزامی
      • message
        نوع: string
        الزامی
      • type
        نوع: string
        الزامی
      • propertyName
        نوع: anything
    • type
      مقدار ثابت:  
      error
      الزامی
    • request_id
      نوع: string
    • propertyName
      نوع: anything
    application/json
  • 429
    نوع: object · ClaudeErrorResponse

    سقف هزینه یا درخواست به پایان رسیده است

    پاکت خطای سازگار با Claude Errors API برای درخواست‌های Messages.

    • error
      نوع: object
      الزامی
      • message
        نوع: string
        الزامی
      • type
        نوع: string
        الزامی
      • propertyName
        نوع: anything
    • type
      مقدار ثابت:  
      error
      الزامی
    • request_id
      نوع: string
    • propertyName
      نوع: anything
    application/json
  • 502
    نوع: object · ClaudeErrorResponse

    درخواست ارائه‌دهنده بالادست ناموفق بود

    پاکت خطای سازگار با Claude Errors API برای درخواست‌های Messages.

    • error
      نوع: object
      الزامی
      • message
        نوع: string
        الزامی
      • type
        نوع: string
        الزامی
      • propertyName
        نوع: anything
    • type
      مقدار ثابت:  
      error
      الزامی
    • request_id
      نوع: string
    • propertyName
      نوع: anything
    application/json
  • 503
    نوع: object · ClaudeErrorResponse

    ارائه‌دهنده یا سرویس صورت‌حساب در دسترس نیست

    پاکت خطای سازگار با Claude Errors API برای درخواست‌های Messages.

    • error
      نوع: object
      الزامی
      • message
        نوع: string
        الزامی
      • type
        نوع: string
        الزامی
      • propertyName
        نوع: anything
    • type
      مقدار ثابت:  
      error
      الزامی
    • request_id
      نوع: string
    • propertyName
      نوع: anything
    application/json
Request Example for 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 یا پاسخ جریان‌سازی

Create a Claude message