Create a model response
OpenAI Responses API-compatible endpoint. A successful non-streaming response uses the Responses object shape; when stream=true the endpoint returns Responses SSE events. A failed Responses object can use status=failed with error={code,message} even when the HTTP request itself completed.
- input必填
- 類型: string
- 類型: stringmodel必填
- 類型: array string[]include
- 類型: stringinstructions
- 類型: integermax
_output _tokens 最小值:1Integer numbers.
- 類型: objectmetadata
- property類型: anything
Name
- 類型: stringprevious
_response _id - 類型: objectreasoning
- property類型: anything
Name
- 類型: booleanstore
- 類型: booleanstream
- 類型: numbertemperature最小值:0
- 類型: objecttext
- property類型: anything
Name
- 類型: anythingproperty
Name
- tool
_choice - 類型: string
- 類型: array object[]tools
- property類型: anything
Name
- 類型: numbertop
_p 最小值:0最大值:1 - 類型: anythingproperty
Name
- 類型: object · ResponsesResponse200
Response object or streaming response events
- 類型: 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
Provider usage object. Fields vary by endpoint and provider.
- property類型: anything
Name
- 類型: anythingproperty
Name
- 類型: object · OpenAIErrorResponse400
Invalid request, model, or provider mapping
OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
OpenAI-compatible error type when supplied.
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse401
Invalid or missing Felo API key
OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
OpenAI-compatible error type when supplied.
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse402
Insufficient balance
OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
OpenAI-compatible error type when supplied.
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse403
Account is not permitted to use the model. Disabled models are also rejected before upstream calls. Existing accepted requests and tasks continue.
OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
OpenAI-compatible error type when supplied.
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse429
Spending or request limit reached
OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
OpenAI-compatible error type when supplied.
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse502
Upstream provider request failed
OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
OpenAI-compatible error type when supplied.
- property類型: anything
Name
- 類型: anythingproperty
Name
application/json - 類型: object · OpenAIErrorResponse503
Provider or billing service unavailable
OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
- 類型: objecterror必填
- message類型: string必填
- code類型: string | null
- param類型: string | null
- type類型: string
OpenAI-compatible error type when supplied.
- 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"
}