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 enumstatusобязательнозначения
- 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"
}