建立模型回應
相容於 OpenAI Responses API 的端點。非串流回應成功時會使用 Responses 物件格式;當 stream=true 時,端點會傳回 Responses SSE 事件。即使 HTTP 請求本身已完成,失敗的 Responses 物件仍可能使用 status=failed 與 error={code,message}。
- 類型: stringX
- Felo - Channel 依序排列、以逗號分隔的公開頻道代碼。省略此標頭即使用 default;default 必須單獨使用。在錢包模式下,default 會反向掃描模型實際生效的公開頻道順序,略過未發布或不可用的頻道,並選用第一個可用頻道所屬的供應商。它會納入該供應商底下具有相同上游模型 ID 與服務層級的可用端點。明確指定的頻道會依用戶端指定的順序驗證;只會提交第一個頻道所屬的供應商群組。不會自動回退至其他供應商。舊版的供應商標頭無法覆寫頻道路由。
- input必填
Reference a Felo PDF with input_file.file_id or an uploaded image with input_image.file_id in a message content array. The model must be enabled for the attachment type. The combined limit for Felo file references is 50 MB per request. PDF file_url/file_data and image_url (HTTPS or a data URL) use the native format.
- 類型: string
Reference a Felo PDF with input_file.file_id or an uploaded image with input_image.file_id in a message content array. The model must be enabled for the attachment type. The combined limit for Felo file references is 50 MB per request. PDF file_url/file_data and image_url (HTTPS or a data URL) use the native format.
- 類型: stringmodel必填
- 類型: array string[]include
- 類型: stringinstructions
- 類型: integermax
_output _tokens 最小值:1Integer numbers.
- 類型: objectmetadata
- property類型: anything
Name
- 類型: stringprevious
_response _id - 類型: objectreasoning
- property類型: anything
Name
- 類型: string | nullservice
_tier 目前僅支援 default(標準)。省略、null、別名以及不受支援的字串都會回退為 default;其他類型則傳回 HTTP 400。已設定的頻道與價格維持不變。文字 API 會傳送供應商的標準值;Decisions 與生成 API 則會省略上游欄位。
- 類型: booleanstore
- 類型: booleanstream
- 類型: numbertemperature最小值:0
- 類型: anythingproperty
Name
- 類型: objecttext
- property類型: anything
Name
- tool
_choice - 類型: string
- 類型: array object[]tools
- property類型: anything
Name
- 類型: numbertop
_p 最小值:0最大值:1 - 類型: anythingproperty
Name
- 類型: object · ResponsesResponse200
回應物件或串流回應事件
- 類型: stringid必填
- object常數:response必填
- 類型: string 列舉status必填值
- completed
- failed
- in
_progress - cancelled
- queued
- incomplete
- 類型: object · ResponsesErrorerror
- code類型: string必填
- message類型: string必填
- property類型: anything
Name
- 類型: objectmetadata
- property類型: anything
Name
- 類型: stringmodel
- 類型: array object[]output
- property類型: anything
Name
- 類型: stringoutput
_text - 類型: 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/responses \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"model": "gpt-5.5",
"input": "Explain why the sky is blue in one sentence.",
"stream": false
}'
{
"id": "string",
"object": "response",
"status": "completed",
"output": [
{
"additionalProperty": "anything"
}
],
"output_text": "string",
"error": {
"code": "string",
"message": "string",
"additionalProperty": "anything"
},
"usage": {
"additionalProperty": "anything"
},
"model": "string",
"metadata": {
"additionalProperty": "anything"
},
"additionalProperty": "anything"
}