建立 Claude 訊息
相容於 Claude Messages API 的端點。設定 stream=true 即可接收 Claude 風格的訊息串流事件。請求、回應與驗證錯誤欄位皆遵循 Claude Messages 協定;若發生基礎設施故障,Router 也可能傳回經過清理的閘道錯誤封裝。
- 類型: stringX
- Felo - Channel 依序排列、以逗號分隔的公開頻道代碼。省略此標頭即使用 default;default 必須單獨使用。在錢包模式下,default 會反向掃描模型實際生效的公開頻道順序,略過未發布或不可用的頻道,並選用第一個可用頻道所屬的供應商。它會納入該供應商底下具有相同上游模型 ID 與服務層級的可用端點。明確指定的頻道會依用戶端指定的順序驗證;只會提交第一個頻道所屬的供應商群組。不會自動回退至其他供應商。舊版的供應商標頭無法覆寫頻道路由。
- 類型: integermax
_tokens 最小值:1必填Integer numbers.
- 類型: array object[] · ClaudeMessage[] 1…messages必填
Use a document block for a PDF or an image block for a picture. Set source to {type: 'file', file_id: 'felo_file_...'} for an uploaded Felo attachment, {type: 'url', url: 'https://...'} for an HTTPS URL, or provide type, media_type and data for a base64 source. PDF and image URL support are enabled per model.
- content必填
- 類型: string
- role類型: string 列舉必填值
- user
- assistant
- property類型: anything
Name
- 類型: stringmodel必填
- 類型: objectmetadata
- property類型: anything
Name
- 類型: string | nullservice
_tier 目前僅支援 default(標準)。省略、null、別名以及不受支援的字串都會回退為 default;其他類型則傳回 HTTP 400。已設定的頻道與價格維持不變。文字 API 會傳送供應商的標準值;Decisions 與生成 API 則會省略上游欄位。
- 類型: array string[]stop
_sequences - 類型: booleanstream
- system
- 類型: string
- 類型: numbertemperature最小值:0最大值:1
- 類型: objectthinking
- property類型: anything
Name
- tool
_choice - 類型: string
- 類型: array object[]tools
- property類型: anything
Name
- 類型: anythingproperty
Name
- 類型: integertop
_k 最小值:0Integer numbers.
- 類型: numbertop
_p 最小值:0最大值:1 - 類型: anythingproperty
Name
- 類型: object · ClaudeMessageResponse200
Claude 訊息或串流回應
- 類型: array object[] · ClaudeContentBlock[]content必填
- type類型: string 列舉必填值
- text
- image
- document
- tool
_use - tool
_result - thinking
- content類型: string | array
- id類型: string
- input類型: object
- property類型: anything
Name
- name類型: string
- source類型: object
- property類型: anything
Name
- text類型: string
- property類型: anything
Name
- 類型: stringid必填
- 類型: stringmodel必填
- role常數:assistant必填
- 類型: string | nullstop
_reason 必填 - type常數:message必填
- 類型: string | nullstop
_sequence - 類型: object · Usageusage
供應商用量物件。欄位會因端點與供應商而異。
- property類型: anything
Name
- 類型: anythingproperty
Name
- 類型: object · ClaudeErrorResponse400
Claude 的 invalid_request_error 或 Router 請求驗證錯誤
用於 Messages 請求、相容於 Claude Errors API 的錯誤封裝。
- 類型: objecterror必填
- message類型: string必填
- type類型: string必填
- property類型: anything
Name
- type常數:error必填
- 類型: stringrequest
_id - 類型: anythingproperty
Name
application/json - 類型: object · ClaudeErrorResponse401
Felo API 金鑰無效或未提供
用於 Messages 請求、相容於 Claude Errors API 的錯誤封裝。
- 類型: objecterror必填
- message類型: string必填
- type類型: string必填
- property類型: anything
Name
- type常數:error必填
- 類型: stringrequest
_id - 類型: anythingproperty
Name
application/json - 類型: object · ClaudeErrorResponse402
餘額不足
用於 Messages 請求、相容於 Claude Errors API 的錯誤封裝。
- 類型: objecterror必填
- message類型: string必填
- type類型: string必填
- property類型: anything
Name
- type常數:error必填
- 類型: stringrequest
_id - 類型: anythingproperty
Name
application/json - 類型: object · ClaudeErrorResponse403
此帳戶無權使用該模型。已停用的模型同樣會在上游呼叫前遭到拒絕。已受理的請求與任務將繼續執行。
用於 Messages 請求、相容於 Claude Errors API 的錯誤封裝。
- 類型: objecterror必填
- message類型: string必填
- type類型: string必填
- property類型: anything
Name
- type常數:error必填
- 類型: stringrequest
_id - 類型: anythingproperty
Name
application/json - 類型: object · ClaudeErrorResponse429
已達消費或請求上限
用於 Messages 請求、相容於 Claude Errors API 的錯誤封裝。
- 類型: objecterror必填
- message類型: string必填
- type類型: string必填
- property類型: anything
Name
- type常數:error必填
- 類型: stringrequest
_id - 類型: anythingproperty
Name
application/json - 類型: object · ClaudeErrorResponse502
上游供應商請求失敗
用於 Messages 請求、相容於 Claude Errors API 的錯誤封裝。
- 類型: objecterror必填
- message類型: string必填
- type類型: string必填
- property類型: anything
Name
- type常數:error必填
- 類型: stringrequest
_id - 類型: anythingproperty
Name
application/json - 類型: object · ClaudeErrorResponse503
供應商或計費服務暫時無法使用
用於 Messages 請求、相容於 Claude Errors API 的錯誤封裝。
- 類型: objecterror必填
- message類型: string必填
- type類型: string必填
- property類型: anything
Name
- type常數:error必填
- 類型: stringrequest
_id - 類型: anythingproperty
Name
application/json
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"
}