Create a chat completion
OpenAI-compatible Chat Completions API. Set stream=true to receive Server-Sent Events. The response and error envelope follow the Chat Completions/OpenAI-compatible shape.
- 型: array object[] · ChatMessage[] 1…messages必須
- contentnull 許容必須
- 型: string
- role型: string 列挙値必須値
- system
- developer
- user
- assistant
- tool
- name型: string
- tool型: string
_call _id - tool型: array object[]
_calls - property型: anything
Name
- property型: anything
Name
- 型: stringmodel必須
- 型: integermax
_completion _tokens 最小値:1Integer numbers.
- 型: integermax
_tokens 最小値:1Integer numbers.
- 型: integern最小値:1
Integer numbers.
- 型: objectresponse
_format - property型: anything
Name
- null 許容stop
- 型: string
- 型: booleanstream
- 型: numbertemperature最小値:0
- tool
_choice - 型: string
- 型: array object[]tools
- property型: anything
Name
- 型: numbertop
_p 最小値:0最大値:1 - 型: anythingproperty
Name
- 型: stringuser
- 型: anythingproperty
Name
- 型: object · ChatCompletionResponse200
Chat completion or streaming response
- 型: array object[] · ChatChoice[]choices必須
- finish型: string | null
_reason - index型: integer
Integer numbers.
- logprobs型: object | null
- property型: anything
Name
- message型: object · ChatMessage
- contentnull 許容必須
- 型: string
- role型: string 列挙値必須値
- system
- developer
- user
- assistant
- tool
- name型: string
- tool型: string
_call _id - tool型: array object[]
_calls - property型: anything
Name
- property型: anything
Name
- property型: anything
Name
- 型: stringid必須
- 型: stringobject必須
Usually chat.completion for non-streaming responses.
- 型: integer 形式: int64created
Signed 64-bit integers (long type).
- 型: stringmodel
- 型: stringsystem
_fingerprint - 型: 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/chat/completions \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"model": "gpt-5.5",
"messages": [
{
"role": "user",
"content": "Write a one-sentence greeting."
}
],
"stream": false
}'
{
"id": "string",
"object": "string",
"created": 1,
"model": "string",
"choices": [
{
"index": 1,
"message": {
"role": "system",
"content": "string",
"name": "string",
"tool_call_id": "string",
"tool_calls": [
{
"additionalProperty": "anything"
}
],
"additionalProperty": "anything"
},
"finish_reason": null,
"logprobs": null,
"additionalProperty": "anything"
}
],
"usage": {
"additionalProperty": "anything"
},
"system_fingerprint": "string",
"additionalProperty": "anything"
}