POST /v1/chat/completions

OpenAI Chat Completions 兼容。需要 text scope，按 tokens 计费（输入 / 输出 / 缓存读取分开计价）。

非流式

curl https://ai-gateway-6a41e6.preview.tencent-zeabur.cn/v1/chat/completions \
  -H "Authorization: Bearer agw_你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "azure-ai-foundry-deepseek-v4-pro",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手。"},
      {"role": "user", "content": "介绍一下你自己"}
    ],
    "user": "user-1234"
  }'

响应为标准 OpenAI 格式，usage 字段返回本次 token 用量（计费依据）：

{
  "id": "chatcmpl-...",
  "choices": [{ "message": { "role": "assistant", "content": "..." } }],
  "usage": { "prompt_tokens": 25, "completion_tokens": 180, "total_tokens": 205 }
}

流式（SSE）

curl https://ai-gateway-6a41e6.preview.tencent-zeabur.cn/v1/chat/completions \
  -H "Authorization: Bearer agw_你的key" \
  -H "Content-Type: application/json" \
  -d '{"model": "baidu-qianfan-glm-5-2", "stream": true,
       "messages": [{"role": "user", "content": "写一首短诗"}],
       "user": "user-1234"}'

stream: true 时返回 text/event-stream，以 data: [DONE] 结束。供应商切换只发生在首个数据块之前，流中断不会静默换供应商。

支持的参数

常用 OpenAI 参数（temperature、max_tokens、tools / tool_choice、response_format 等）按上游模型能力透传；模型是否支持工具调用/视觉见模型目录的能力标志。

使用 OpenAI SDK

网关完全兼容 OpenAI SDK，改 base_url 和 api_key 即可：

from openai import OpenAI

client = OpenAI(
    base_url="https://ai-gateway-6a41e6.preview.tencent-zeabur.cn/v1",
    api_key="agw_你的key",
)
resp = client.chat.completions.create(
    model="volcengine-doubao-seed-2-1-pro",
    messages=[{"role": "user", "content": "你好"}],
    user="user-1234",
)