Criar uma resposta de modelo
Endpoint compatível com a API Responses da OpenAI. Uma resposta bem-sucedida sem streaming usa o formato do objeto Responses; com stream=true, o endpoint retorna eventos SSE do Responses. Um objeto Responses com falha pode usar status=failed com error={code,message} mesmo quando a própria requisição HTTP foi concluída.
- Tipo: stringX
- Felo - Channel Códigos de canal público separados por vírgula, em ordem. Omita este cabeçalho para usar default; default deve ser usado sozinho. No modo carteira, default percorre a ordem efetiva de canais públicos do modelo em ordem inversa, ignora canais não publicados ou indisponíveis e seleciona o provedor do primeiro canal disponível. Inclui os endpoints disponíveis desse provedor com o mesmo ID de modelo upstream e o mesmo service tier. Canais explícitos são validados na ordem especificada pelo cliente; somente o grupo de provedores do primeiro canal é enviado. Não há fallback automático para outros provedores. Cabeçalhos legados de provedor não podem substituir o roteamento por canal.
- inputobrigatório
- Tipo: string
- Tipo: stringmodelobrigatório
- Tipo: array string[]include
- Tipo: stringinstructions
- Tipo: integermax
_output _tokens mín:1Integer numbers.
- Tipo: objectmetadata
- propertyTipo: anything
Name
- Tipo: stringprevious
_response _id - Tipo: objectreasoning
- propertyTipo: anything
Name
- Tipo: string | nullservice
_tier Atualmente, apenas default (standard) é suportado. Valores omitidos, null, aliases e strings não suportadas usam default; outros tipos retornam HTTP 400. Os canais e preços configurados permanecem inalterados. As APIs de texto enviam o valor padrão do provedor; as APIs Decisions e de geração omitem o campo upstream.
- Tipo: booleanstore
- Tipo: booleanstream
- Tipo: numbertemperaturemín:0
- Tipo: anythingproperty
Name
- Tipo: objecttext
- propertyTipo: anything
Name
- tool
_choice - Tipo: string
- Tipo: array object[]tools
- propertyTipo: anything
Name
- Tipo: numbertop
_p mín:0máx:1 - Tipo: anythingproperty
Name
- Tipo: object · ResponsesResponse200
Objeto de resposta ou eventos de resposta em streaming
- Tipo: stringidobrigatório
- objectconst:responseobrigatório
- Tipo: string enumstatusobrigatóriovalores
- completed
- failed
- in
_progress - cancelled
- queued
- incomplete
- Tipo: object · ResponsesErrorerror
- codeTipo: stringobrigatório
- messageTipo: stringobrigatório
- propertyTipo: anything
Name
- Tipo: objectmetadata
- propertyTipo: anything
Name
- Tipo: stringmodel
- Tipo: array object[]output
- propertyTipo: anything
Name
- Tipo: stringoutput
_text - Tipo: object · Usageusage
Objeto de uso do provedor. Os campos variam conforme o endpoint e o provedor.
- propertyTipo: anything
Name
- Tipo: anythingproperty
Name
- Tipo: object · OpenAIErrorResponse400
Requisição, modelo ou mapeamento de provedor inválido
Envelope de erro compatível com a OpenAI. O Router pode incluir code e message sem todos os campos upstream opcionais.
- Tipo: objecterrorobrigatório
- messageTipo: stringobrigatório
- codeTipo: string | null
- paramTipo: string | null
- typeTipo: string
Tipo de erro compatível com a OpenAI, quando fornecido.
- propertyTipo: anything
Name
- Tipo: anythingproperty
Name
application/json - Tipo: object · OpenAIErrorResponse401
Chave de API da Felo inválida ou ausente
Envelope de erro compatível com a OpenAI. O Router pode incluir code e message sem todos os campos upstream opcionais.
- Tipo: objecterrorobrigatório
- messageTipo: stringobrigatório
- codeTipo: string | null
- paramTipo: string | null
- typeTipo: string
Tipo de erro compatível com a OpenAI, quando fornecido.
- propertyTipo: anything
Name
- Tipo: anythingproperty
Name
application/json - Tipo: object · OpenAIErrorResponse402
Saldo insuficiente
Envelope de erro compatível com a OpenAI. O Router pode incluir code e message sem todos os campos upstream opcionais.
- Tipo: objecterrorobrigatório
- messageTipo: stringobrigatório
- codeTipo: string | null
- paramTipo: string | null
- typeTipo: string
Tipo de erro compatível com a OpenAI, quando fornecido.
- propertyTipo: anything
Name
- Tipo: anythingproperty
Name
application/json - Tipo: object · OpenAIErrorResponse403
A conta não tem permissão para usar o modelo. Modelos desativados também são rejeitados antes das chamadas upstream. Requisições e tarefas já aceitas continuam.
Envelope de erro compatível com a OpenAI. O Router pode incluir code e message sem todos os campos upstream opcionais.
- Tipo: objecterrorobrigatório
- messageTipo: stringobrigatório
- codeTipo: string | null
- paramTipo: string | null
- typeTipo: string
Tipo de erro compatível com a OpenAI, quando fornecido.
- propertyTipo: anything
Name
- Tipo: anythingproperty
Name
application/json - Tipo: object · OpenAIErrorResponse429
Limite de gastos ou de requisições atingido
Envelope de erro compatível com a OpenAI. O Router pode incluir code e message sem todos os campos upstream opcionais.
- Tipo: objecterrorobrigatório
- messageTipo: stringobrigatório
- codeTipo: string | null
- paramTipo: string | null
- typeTipo: string
Tipo de erro compatível com a OpenAI, quando fornecido.
- propertyTipo: anything
Name
- Tipo: anythingproperty
Name
application/json - Tipo: object · OpenAIErrorResponse502
Falha na requisição ao provedor upstream
Envelope de erro compatível com a OpenAI. O Router pode incluir code e message sem todos os campos upstream opcionais.
- Tipo: objecterrorobrigatório
- messageTipo: stringobrigatório
- codeTipo: string | null
- paramTipo: string | null
- typeTipo: string
Tipo de erro compatível com a OpenAI, quando fornecido.
- propertyTipo: anything
Name
- Tipo: anythingproperty
Name
application/json - Tipo: object · OpenAIErrorResponse503
Provedor ou serviço de cobrança indisponível
Envelope de erro compatível com a OpenAI. O Router pode incluir code e message sem todos os campos upstream opcionais.
- Tipo: objecterrorobrigatório
- messageTipo: stringobrigatório
- codeTipo: string | null
- paramTipo: string | null
- typeTipo: string
Tipo de erro compatível com a OpenAI, quando fornecido.
- propertyTipo: anything
Name
- Tipo: 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"
}