快速开始

三步接入，全程不需要改动业务代码，也不需要对接多家上游供应商。

前提

你需要一个 API Key。如果你还没有：

• 已在测试阶段：使用我们发给你的测试密钥（注意有效期）。
• 尚未开通：请联系平台商务申请测试账号。我们会为你开通账号并发放固定额度的测试密钥。

第 1 步：获取 API Key

登录控制台，在「API 密钥」页面创建或查看你的密钥。密钥形如：

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

密钥安全

API Key 等同于账号凭证，请勿提交到代码仓库、写入前端代码或分享给他人。 建议为不同应用创建不同的密钥，便于单独吊销与用量归因。

第 2 步：替换 Base URL

我们是完全兼容 OpenAI 协议的服务，所以只需把 SDK 的 Base URL 指向我们：

https://cn.guanqiintelligence.com/v1

第 3 步：发起第一个请求

curl https://cn.guanqiintelligence.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GQI_API_KEY" \
  -d '{
    "model": "doubao-seed-2-1-turbo-260628",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

返回结构与 OpenAI 一致：

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "doubao-seed-2-1-turbo-260628",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 34,
    "total_tokens": 46
  }
}

下一步

• 认证方式 — 密钥类型、权限与安全建议
• 调用示例 — curl / Python / Node / Claude / Gemini
• 模型列表 — 选一个适合你任务的模型
• 计费说明 — 看清费用是怎么算的

遇到问题？

1. 确认 Base URL 以 /v1 结尾，且没有多余的斜杠。
2. 确认请求头是 Authorization: Bearer <你的密钥>。
3. 确认 model 填的是模型列表里的模型 ID（不是显示名称）。
4. 若仍失败，对照错误码排查，或联系平台商务。