跳转至

OpenAI API 兼容

Creates a model response for the given chat conversation.

POST /v1/chat/completions

当前文档仅列举 OpenAI Chat Completion 基础功能，如 OpenAI 模型可使用更多参数功能，请参考 OpenAI API Reference。

Authorizations

参数 类型 位置 必填 说明
Authorization string header 是 身份验证标头格式为 Bearer <API_KEY>，其中 <API_KEY> 是您的API令牌。

Body

application/json

参数 类型 必填 说明
model string 是 要使用的模型的 ID。例如："gpt-5.1"
messages object[] 是 以聊天格式生成聊天完成的消息。
stream boolean 否 是否流式对话。默认：false
max_completion_tokens integer 否 最大完成令牌数
temperature number 否 温度参数，控制输出的随机性。默认：1
top_p number 否 核采样参数。默认：1

messages 子属性

参数 类型 必填 说明
role string 是 角色。可选值：user、system、developer、assistant
content string | array 是 文本内容（字符串）或多模态内容数组

Response

200 - Model response

参数 类型 说明
id string 请求ID标识符
object string 对象类型
created integer 创建时间戳
model string 模型版本
choices array 响应选择数组
usage object 用量统计

choices 子属性

参数 类型 说明
index integer 索引
message object 消息对象，包含 role 和 content
finish_reason string 完成原因

usage 子属性

参数 类型 说明
prompt_tokens integer 提示词令牌数
completion_tokens integer 完成令牌数
total_tokens integer 总令牌数
prompt_tokens_details object 提示词令牌详情（cached_tokens, audio_tokens）
completion_tokens_details object 完成令牌详情（reasoning_tokens, audio_tokens 等）

请求示例

curl --request POST \
  --url https://cdn.12ai.org/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.1",
  "messages": [
    {
      "role": "user",
      "content": "Hello, how are you?"
    }
  ]
}'

from openai import OpenAI

client = OpenAI(
    api_key="<token>",
    base_url="https://cdn.12ai.org/v1"
)

response = client.chat.completions.create(
    model="gpt-5.1",
    messages=[
        {"role": "user", "content": "Hello, how are you?"}
    ]
)

print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: '<token>',
    baseURL: 'https://cdn.12ai.org/v1'
});

const response = await client.chat.completions.create({
    model: 'gpt-5.1',
    messages: [
        { role: 'user', content: 'Hello, how are you?' }
    ]
});

console.log(response.choices[0].message.content);

响应示例

{
  "id": "<string>",
  "object": "<string>",
  "created": 123,
  "model": "<string>",
  "choices": [
    {
      "index": 123,
      "message": {
        "role": "<string>",
        "content": "<string>"
      },
      "finish_reason": "<string>"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123,
    "prompt_tokens_details": {
      "cached_tokens": 123,
      "audio_tokens": 123
    },
    "completion_tokens_details": {
      "reasoning_tokens": 123,
      "audio_tokens": 123,
      "accepted_prediction_tokens": 123,
      "rejected_prediction_tokens": 123
    }
  }
}