API 参考

POST /v1/chat/completions

OpenAI 兼容的对话补全端点

OpenAI 风格的对话补全。GPT 系、xAI、以及各家自营对话模型都走这里,请求与响应结构与 OpenAI 保持一致,现成的 OpenAI SDK 只改 Base URL 就能用。

请求参数

字段	类型	必填	说明
`model`	string	是	模型名,如 `gpt-5.5`、`grok-4.20-fast`
`messages`	array	是	对话消息列表,每项含 `role` 与 `content`
`temperature`	number	否	采样温度,默认按上游
`max_tokens`	int	否	本次回复最大 token 数
`stream`	bool	否	当前请置为 `false`

请求示例

bash

curl https://coder.aicoderbox.com/v1/chat/completions \
  -H "Authorization: Bearer sk-acb-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "你是一个简洁的代码助手"},
      {"role": "user", "content": "用 Python 写一个判断质数的函数"}
    ],
    "stream": false
  }'

响应示例

json

{
  "id": "chatcmpl-3f9a2b",
  "object": "chat.completion",
  "created": 1751856000,
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "def is_prime(n):\n    if n < 2:\n        return False\n    for i in range(2, int(n ** 0.5) + 1):\n        if n % i == 0:\n            return False\n    return True"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 46,
    "total_tokens": 74
  }
}

扣费发生在成功之后: 本次调用会扣掉 gpt-5.5 的单价(30 积分),并写一条 ok 的调用日志。若上游报错,这 30 分会自动退回,日志记为 refunded。

用 Python SDK

python

from openai import OpenAI

client = OpenAI(
    base_url="https://coder.aicoderbox.com/v1",
    api_key="sk-acb-xxxx",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

错误示例

json

// HTTP 402
{ "detail": "积分不足" }