Create chat completion

POST

/chat/completions

OpenAI-compatible chat completions endpoint. Supports single-provider requests via
model as well as automatic failover across providers via models.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Single providerAutomatic fallback

{
    "model": "openai/gpt-4o-mini",
    "messages": [
        {
            "role": "system",
            "content": "You are a precise assistant."
        },
        {
            "role": "user",
            "content": "Outline a launch plan for CCAPI."
        }
    ],
    "stream": false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Single providerAutomatic fallback

curl --location --request POST 'http://prod-cn.your-api-server.com/chat/completions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "openai/gpt-4o-mini",
    "messages": [
        {
            "role": "system",
            "content": "You are a precise assistant."
        },
        {
            "role": "user",
            "content": "Outline a launch plan for CCAPI."
        }
    ],
    "stream": false
}'

Responses

🟢200OK

application/json

Chat completion response. SSE stream when stream=true.

Body

Example

{
    "id": "chatcmpl-123",
    "object": "chat.completion",
    "created": 1717430400,
    "model": "openai/gpt-4o-mini",
    "provider": "openai",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "1. Align requirements...\n"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 120,
        "completion_tokens": 256,
        "total_tokens": 376,
        "input_cost": 0.024,
        "output_cost": 0.051
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠402Payment Required

🟠429Too Many Requests

🔴500Internal Server Error

Modified at 2025-11-12 07:09:16

Convert text to speech