POST/v1/chat/completions

/v1/chat/completions

用任何 OpenAI SDK 呼叫这个端点。Request body 完全沿用 OpenAI 的 chat completions schema。model 栏位必须是 GET /v1/models 回传的值。

请求#

把 MODEL_ID 换成 GET /v1/models 回传的模型 ID。

在 Studio 试
curl https://api.atptoken.ai/v1/chat/completions \
  -H "Authorization: Bearer $ATP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "hi"}]
  }'

参数#

字段类型说明
modelstring · 必填来自 GET /v1/models 的模型 ID。
messagesarray · 必填对话消息,每则为 { role, content }。
max_tokensinteger最大输出 token 数。reasoning 模型的思考也吃这个额度——设太低会拿到内容为空的 200(见错误)。
temperaturenumber取样温度,0–2。
streamboolean以 SSE chunk 串流回应。
toolsarrayTool/function 定义(OpenAI tool schema)。

回应#

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "<model>",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "..." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21 }
}
这页有帮助吗?