创建 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(standard)。省略、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"
}