建立聊天補全
相容於 OpenAI 的 Chat Completions API。設定 stream=true 即可接收 Server-Sent Events。回應與錯誤封裝皆遵循 Chat Completions/OpenAI 相容格式。
- 類型: stringX
- Felo - Channel 依序排列、以逗號分隔的公開頻道代碼。省略此標頭即使用 default;default 必須單獨使用。在錢包模式下,default 會反向掃描模型實際生效的公開頻道順序,略過未發布或不可用的頻道,並選用第一個可用頻道所屬的供應商。它會納入該供應商底下具有相同上游模型 ID 與服務層級的可用端點。明確指定的頻道會依用戶端指定的順序驗證;只會提交第一個頻道所屬的供應商群組。不會自動回退至其他供應商。舊版的供應商標頭無法覆寫頻道路由。
- 類型: array object[] · ChatMessage[] 1…messages必填
- content可為 null必填
- 類型: string
- role類型: string 列舉必填值
- system
- developer
- user
- assistant
- tool
- name類型: string
- tool類型: string
_call _id - tool類型: array object[]
_calls - property類型: anything
Name
- property類型: anything
Name
- 類型: stringmodel必填
- 類型: integermax
_completion _tokens 最小值:1Integer numbers.
- 類型: integermax
_tokens 最小值:1Integer numbers.
- 類型: integern最小值:1
Integer numbers.
- 類型: objectresponse
_format - property類型: anything
Name
- 類型: string | nullservice
_tier 目前僅支援 default(標準)。省略、null、別名以及不受支援的字串都會回退為 default;其他類型則傳回 HTTP 400。已設定的頻道與價格維持不變。文字 API 會傳送供應商的標準值;Decisions 與生成 API 則會省略上游欄位。
- 可為 nullstop
- 類型: string
- 類型: booleanstream
- 類型: numbertemperature最小值:0
- tool
_choice - 類型: string
- 類型: array object[]tools
- property類型: anything
Name
- 類型: anythingproperty
Name
- 類型: numbertop
_p 最小值:0最大值:1 - 類型: stringuser
- 類型: anythingproperty
Name
- 類型: object · ChatCompletionResponse200
聊天補全或串流回應
- 類型: array object[] · ChatChoice[]choices必填
- finish類型: string | null
_reason - index類型: integer
Integer numbers.
- logprobs類型: object | null
- property類型: anything
Name
- message類型: object · ChatMessage
- content可為 null必填
- 類型: string
- role類型: string 列舉必填值
- system
- developer
- user
- assistant
- tool
- name類型: string
- tool類型: string
_call _id - tool類型: array object[]
_calls - property類型: anything
Name
- property類型: anything
Name
- property類型: anything
Name
- 類型: stringid必填
- 類型: stringobject必填
非串流回應通常為 chat.completion。
- 類型: integer 格式: int64created
Signed 64-bit integers (long type).
- 類型: stringmodel
- 類型: stringsystem
_fingerprint - 類型: object · Usageusage
供應商用量物件。欄位會因端點與供應商而異。
- property類型: anything
Name
- 類型: anythingproperty
Name
- 類型: object · OpenAIErrorResponse400
請求、模型或供應商對應無效
相容於 OpenAI 的錯誤封裝。Router 可能只包含 code 與 message,而不含所有選用的上游欄位。
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
相容於 OpenAI 的錯誤類型(若有提供)。
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse401
Felo API 金鑰無效或未提供
相容於 OpenAI 的錯誤封裝。Router 可能只包含 code 與 message,而不含所有選用的上游欄位。
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
相容於 OpenAI 的錯誤類型(若有提供)。
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse402
餘額不足
相容於 OpenAI 的錯誤封裝。Router 可能只包含 code 與 message,而不含所有選用的上游欄位。
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
相容於 OpenAI 的錯誤類型(若有提供)。
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse403
此帳戶無權使用該模型。已停用的模型同樣會在上游呼叫前遭到拒絕。已受理的請求與任務將繼續執行。
相容於 OpenAI 的錯誤封裝。Router 可能只包含 code 與 message,而不含所有選用的上游欄位。
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
相容於 OpenAI 的錯誤類型(若有提供)。
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse429
已達消費或請求上限
相容於 OpenAI 的錯誤封裝。Router 可能只包含 code 與 message,而不含所有選用的上游欄位。
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
相容於 OpenAI 的錯誤類型(若有提供)。
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse502
上游供應商請求失敗
相容於 OpenAI 的錯誤封裝。Router 可能只包含 code 與 message,而不含所有選用的上游欄位。
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
相容於 OpenAI 的錯誤類型(若有提供)。
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse503
供應商或計費服務暫時無法使用
相容於 OpenAI 的錯誤封裝。Router 可能只包含 code 與 message,而不含所有選用的上游欄位。
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
相容於 OpenAI 的錯誤類型(若有提供)。
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json
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"
}