目标：约 5 分钟完成一条非流式对话请求。

前置条件

  1. API Key — 在控制台创建（见 API 密钥）。
  2. Base URL — OpenAI 兼容调用使用 https://51kik.com/v1（见 Base URL 与环境）。
  3. 模型 id — 无需认证拉取目录：
curl -sS "https://51kik.com/v1/models" | head -c 2000

选用返回条目的 id 作为 model（具体值以你的目录为准）。

步骤 1 — 配置环境变量

export API_KEY="YOUR_API_KEY"
export MODEL_ID="YOUR_MODEL_ID_FROM_CATALOG"

勿将密钥提交到仓库；CI 请用密钥管理（见 从环境变量配置）。

步骤 2 — 调用 chat completions

curl -sS "https://51kik.com/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-trace-id: quickstart-$(date +%s)" \
  -d "{
    \"model\": \"$MODEL_ID\",
    \"messages\": [{ \"role\": \"user\", \"content\": \"请只回复：ok\" }]
  }"

x-trace-id 为可选业务追踪头，便于排障与用量关联（见 请求关联）。

步骤 3 — 校验响应

200 成功时响应体与 OpenAI Chat Completions 一致，例如：

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "choices": [
    {
      "message": { "role": "assistant", "content": "ok" },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0
  }
}

具体 token 数由上游决定。

常见失败

HTTP排查
401密钥缺失、错误或过期
403模型未授权、余额不足、IP 不在白名单
400JSON 或 messages / model 不合法
429限流 — 退避重试（见 限流与配额）

完整说明见 错误响应。

下一步