v0.3.0

OpenAPI 3.1.0

Create a chat completion

Felo API Support

MIT

伺服器

https://openapi.felo.ai

用戶端程式庫

Shell Curl

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.

請求本文·ChatCompletionRequest

必填

application/json

messages
類型: array object[] · ChatMessage[] 1…
必填
- content
  可為 null
  必填
  類型: string
- role
  類型: string 列舉
  必填
  值
  system
  developer
  user
  assistant
  tool
- name
  類型: string
- tool_call_id
  類型: string
- tool_calls
  類型: array object[]
  propertyName
  類型: anything
- propertyName
  類型: anything
model
類型: string
必填
max_completion_tokens
類型: integer
最小值:
1

Integer numbers.
max_tokens
類型: integer
最小值:
1

Integer numbers.
n
類型: integer
最小值:
1

Integer numbers.
response_format
類型: object
- propertyName
  類型: anything
stop
可為 null
類型: string
stream
類型: boolean
temperature
類型: number
最小值:
0
tool_choice
類型: string
tools
類型: array object[]
- propertyName
  類型: anything
top_p
類型: number
最小值:
0
最大值:
1
propertyName
類型: anything

user
類型: string
propertyName
類型: anything

回應

200
類型: object · ChatCompletionResponse

Chat completion or streaming response
choices
類型: array object[] · ChatChoice[]
必填
finish_reason
類型: string | null
index
類型: integer

Integer numbers.

logprobs
類型: object | null
propertyName
類型: anything
message
類型: object · ChatMessage
content
可為 null
必填
類型: string
role
類型: string 列舉
必填
值
system
developer
user
assistant
tool
name
類型: string
tool_call_id
類型: string
tool_calls
類型: array object[]
propertyName
類型: anything
propertyName
類型: anything
propertyName
類型: anything
id
類型: string
必填
object
類型: string
必填

Usually chat.completion for non-streaming responses.

created
類型: integer 格式: int64

Signed 64-bit integers (long type).

model
類型: string
system_fingerprint
類型: string
usage
類型: object · Usage

Provider usage object. Fields vary by endpoint and provider.

propertyName
類型: anything
propertyName
類型: anything
400
類型: object · OpenAIErrorResponse

Invalid request, model, or provider mapping

OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
error
類型: object
必填
message
類型: string
必填
code
類型: string | null
param
類型: string | null
type
類型: string

OpenAI-compatible error type when supplied.

propertyName
類型: anything
propertyName
類型: anything
application/json
401
類型: object · OpenAIErrorResponse

Invalid or missing Felo API key

OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
error
類型: object
必填
message
類型: string
必填
code
類型: string | null
param
類型: string | null
type
類型: string

OpenAI-compatible error type when supplied.

propertyName
類型: anything
propertyName
類型: anything
application/json
402
類型: object · OpenAIErrorResponse

Insufficient balance

OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
error
類型: object
必填
message
類型: string
必填
code
類型: string | null
param
類型: string | null
type
類型: string

OpenAI-compatible error type when supplied.

propertyName
類型: anything
propertyName
類型: anything
application/json
403
類型: object · OpenAIErrorResponse

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.
error
類型: object
必填
message
類型: string
必填
code
類型: string | null
param
類型: string | null
type
類型: string

OpenAI-compatible error type when supplied.

propertyName
類型: anything
propertyName
類型: anything
application/json
429
類型: object · OpenAIErrorResponse

Spending or request limit reached

OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
error
類型: object
必填
message
類型: string
必填
code
類型: string | null
param
類型: string | null
type
類型: string

OpenAI-compatible error type when supplied.

propertyName
類型: anything
propertyName
類型: anything
application/json
502
類型: object · OpenAIErrorResponse

Upstream provider request failed

OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
error
類型: object
必填
message
類型: string
必填
code
類型: string | null
param
類型: string | null
type
類型: string

OpenAI-compatible error type when supplied.

propertyName
類型: anything
propertyName
類型: anything
application/json
503
類型: object · OpenAIErrorResponse

Provider or billing service unavailable

OpenAI-compatible error envelope. The Router may include code and message without all optional upstream fields.
error
類型: object
必填
message
類型: string
必填
code
類型: string | null
param
類型: string | null
type
類型: string

OpenAI-compatible error type when supplied.

propertyName
類型: anything
propertyName
類型: anything
application/json

post/api/v1/chat/completions

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
}'

顯示 Schema

{
  "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"
}

Chat completion or streaming response

Create a chat completion

身分驗證Required

Create a chat completion