สร้าง chat completion

Felo API Support

MIT

เซิร์ฟเวอร์

https://openapi.felo.ai

ไลบรารีไคลเอนต์

Shell Curl

สร้าง chat completion

API Chat Completions ที่เข้ากันได้กับ OpenAI ตั้งค่า stream=true เพื่อรับ Server-Sent Events การตอบกลับและซองข้อผิดพลาดเป็นไปตามรูปแบบที่เข้ากันได้กับ Chat Completions/OpenAI

เฮดเดอร์

X-Felo-Channel
ประเภท: string

รหัสช่องทางสาธารณะที่คั่นด้วยเครื่องหมายจุลภาคตามลำดับ หากไม่ส่งเฮดเดอร์นี้จะใช้ default โดยต้องใช้ default เดี่ยว ๆ เท่านั้น ในโหมดกระเป๋าเงิน default จะสแกนลำดับช่องทางสาธารณะที่มีผลของโมเดลจากท้ายไปต้น ข้ามช่องทางที่ยังไม่เผยแพร่หรือไม่พร้อมใช้งาน และเลือกผู้ให้บริการของช่องทางแรกที่พร้อมใช้งาน โดยจะรวม endpoint ที่พร้อมใช้งานของผู้ให้บริการรายนั้นที่มี upstream model ID และระดับบริการเดียวกัน ช่องทางที่ระบุอย่างชัดเจนจะถูกตรวจสอบตามลำดับที่ไคลเอนต์กำหนด และส่งเฉพาะกลุ่มผู้ให้บริการของช่องทางแรกเท่านั้น ไม่มีการสลับไปยังผู้ให้บริการรายอื่นโดยอัตโนมัติ เฮดเดอร์ผู้ให้บริการแบบเดิมไม่สามารถแทนที่การกำหนดเส้นทางตามช่องทางได้

บอดี้·ChatCompletionRequest

จำเป็น

application/json

messages
ประเภท: array object[] · ChatMessage[] 1…
จำเป็น
- content
  เป็น null ได้
  จำเป็น
  ประเภท: string
- role
  ประเภท: string enum
  จำเป็น
  ค่า
  system
  developer
  user
  assistant
  tool
- name
  ประเภท: string
- tool_call_id
  ประเภท: string
- tool_calls
  ประเภท: array object[]
  propertyName
  ประเภท: anything
- propertyName
  ประเภท: anything
model
ประเภท: string
จำเป็น
max_completion_tokens
ประเภท: integer
ต่ำสุด:
1

Integer numbers.
max_tokens
ประเภท: integer
ต่ำสุด:
1

Integer numbers.
n
ประเภท: integer
ต่ำสุด:
1

Integer numbers.
response_format
ประเภท: object
- propertyName
  ประเภท: anything
service_tier
ประเภท: string | null

ขณะนี้รองรับเฉพาะ default (standard) เท่านั้น ค่าที่ไม่ระบุ ค่า null ชื่อแทน และสตริงที่ไม่รองรับจะถูกแทนด้วย default ส่วนประเภทอื่นจะคืน HTTP 400 ช่องทางและราคาที่กำหนดค่าไว้ยังคงเดิม API ข้อความจะส่งค่ามาตรฐานของผู้ให้บริการ ส่วน Decisions และ API การสร้างผลงานจะไม่ส่งฟิลด์ต้นทางนี้
stop
เป็น null ได้
ประเภท: string
stream
ประเภท: boolean
temperature
ประเภท: number
ต่ำสุด:
0
tool_choice
ประเภท: string
tools
ประเภท: array object[]
- propertyName
  ประเภท: anything
propertyName
ประเภท: anything

top_p
ประเภท: number
ต่ำสุด:
0
สูงสุด:
1
user
ประเภท: string
propertyName
ประเภท: anything

การตอบกลับ

200
ประเภท: object · ChatCompletionResponse

ผลลัพธ์ chat completion หรือการตอบกลับแบบสตรีมมิ่ง
choices
ประเภท: array object[] · ChatChoice[]
จำเป็น
finish_reason
ประเภท: string | null
index
ประเภท: integer

Integer numbers.

logprobs
ประเภท: object | null
propertyName
ประเภท: anything
message
ประเภท: object · ChatMessage
content
เป็น null ได้
จำเป็น
ประเภท: string
role
ประเภท: string enum
จำเป็น
ค่า
system
developer
user
assistant
tool
name
ประเภท: string
tool_call_id
ประเภท: string
tool_calls
ประเภท: array object[]
propertyName
ประเภท: anything
propertyName
ประเภท: anything
propertyName
ประเภท: anything
id
ประเภท: string
จำเป็น
object
ประเภท: string
จำเป็น

โดยปกติเป็น chat.completion สำหรับการตอบกลับแบบไม่สตรีมมิ่ง

created
ประเภท: integer รูปแบบ: int64

Signed 64-bit integers (long type).

model
ประเภท: string
system_fingerprint
ประเภท: string
usage
ประเภท: object · Usage

ออบเจ็กต์การใช้งานของผู้ให้บริการ ฟิลด์แตกต่างกันตาม endpoint และผู้ให้บริการ

propertyName
ประเภท: anything
propertyName
ประเภท: anything
400
ประเภท: object · OpenAIErrorResponse

คำขอ โมเดล หรือการแมปผู้ให้บริการไม่ถูกต้อง

ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด
error
ประเภท: object
จำเป็น
message
ประเภท: string
จำเป็น
code
ประเภท: string | null
param
ประเภท: string | null
type
ประเภท: string

ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

propertyName
ประเภท: anything
propertyName
ประเภท: anything
application/json
401
ประเภท: object · OpenAIErrorResponse

คีย์ API ของ Felo ไม่ถูกต้องหรือไม่มี

ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด
error
ประเภท: object
จำเป็น
message
ประเภท: string
จำเป็น
code
ประเภท: string | null
param
ประเภท: string | null
type
ประเภท: string

ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

propertyName
ประเภท: anything
propertyName
ประเภท: anything
application/json
402
ประเภท: object · OpenAIErrorResponse

ยอดคงเหลือไม่เพียงพอ

ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด
error
ประเภท: object
จำเป็น
message
ประเภท: string
จำเป็น
code
ประเภท: string | null
param
ประเภท: string | null
type
ประเภท: string

ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

propertyName
ประเภท: anything
propertyName
ประเภท: anything
application/json
403
ประเภท: object · OpenAIErrorResponse

บัญชีไม่ได้รับอนุญาตให้ใช้โมเดลนี้ โมเดลที่ปิดใช้งานจะถูกปฏิเสธก่อนเรียกต้นทางเช่นกัน คำขอและงานที่รับไว้แล้วยังคงดำเนินการต่อ

ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด
error
ประเภท: object
จำเป็น
message
ประเภท: string
จำเป็น
code
ประเภท: string | null
param
ประเภท: string | null
type
ประเภท: string

ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

propertyName
ประเภท: anything
propertyName
ประเภท: anything
application/json
429
ประเภท: object · OpenAIErrorResponse

ถึงขีดจำกัดการใช้จ่ายหรือจำนวนคำขอแล้ว

ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด
error
ประเภท: object
จำเป็น
message
ประเภท: string
จำเป็น
code
ประเภท: string | null
param
ประเภท: string | null
type
ประเภท: string

ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

propertyName
ประเภท: anything
propertyName
ประเภท: anything
application/json
502
ประเภท: object · OpenAIErrorResponse

คำขอไปยังผู้ให้บริการต้นทางล้มเหลว

ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด
error
ประเภท: object
จำเป็น
message
ประเภท: string
จำเป็น
code
ประเภท: string | null
param
ประเภท: string | null
type
ประเภท: string

ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

propertyName
ประเภท: anything
propertyName
ประเภท: anything
application/json
503
ประเภท: object · OpenAIErrorResponse

ผู้ให้บริการหรือบริการเรียกเก็บเงินไม่พร้อมใช้งาน

ซองข้อผิดพลาดที่เข้ากันได้กับ OpenAI Router อาจใส่ code และ message โดยไม่มีฟิลด์ต้นทางที่ไม่บังคับทั้งหมด
error
ประเภท: object
จำเป็น
message
ประเภท: string
จำเป็น
code
ประเภท: string | null
param
ประเภท: string | null
type
ประเภท: string

ประเภทข้อผิดพลาดที่เข้ากันได้กับ OpenAI เมื่อมีการระบุ

propertyName
ประเภท: anything
propertyName
ประเภท: anything
application/json

post/api/v1/chat/completions

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

แสดงสคีมา

{
  "id": "string",
  "object": "string",
  "created": 1,
  "model": "string",
  "choices": [
    {
      "index": 1,
      "message": {
        "role": "system",
        "content": "string",
        "name": "string",
        "tool_call_id": "string",
        "tool_calls": [
          {
            "additionalProperty": "anything"
          }
        ],
        "additionalProperty": "anything"
      },
      "finish_reason": null,
      "logprobs": null,
      "additionalProperty": "anything"
    }
  ],
  "usage": {
    "additionalProperty": "anything"
  },
  "system_fingerprint": "string",
  "additionalProperty": "anything"
}

ผลลัพธ์ chat completion หรือการตอบกลับแบบสตรีมมิ่ง

สร้าง chat completion

การยืนยันตัวตนRequired

สร้าง chat completion