创建模型响应
兼容 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(standard)。省略、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"
}