快速开始

约 5 分钟 完成首次模型 API 调用。

首次使用可先阅读 模型与 Token 入门，了解 Token 与上下文等基础概念。

前置条件

项要求
账号已注册 控制台open in new window
计费已购 Token 套餐，或账户 有余额 > 0（按量）
工具终端可执行 curl，或已安装 Python 3.8+

三步判断用哪种接口

步骤做什么
1在 模型广场 或 GET /v1/models 确定 接口模型名称
2看该模型文档：支持 OpenAI 则地址为 .../v1/chat/completions；支持 Anthropic 则为 .../anthropic/v1/messages
3在 API KEY 创建对应计费方式的密钥（套餐需绑定套餐）

步骤一：选择计费方式

方式 A：Token 套餐（预算可控）

  1. 控制台 套餐订阅 → 选购并支付（每次只能买 1 份）。
  2. 套餐管理 中确认剩余 Token、有效期为可用。
  3. 创建密钥时选 套餐计费，并 绑定 该套餐。

每次调用按返回的 Token 总数 扣减套餐额度。

方式 B：按量调用（用量灵活）

  1. 控制台 充值，保证余额充足。
  2. 创建密钥时选 按量计费。
  3. 可选：设置密钥 日/月消费上限（元）（0 表示不限）。

费用按单价折算为人民币，由系统定期汇总后从余额扣除（后付费，详见 收支明细）。详见 计费方式说明。

步骤二：创建 API 密钥

  1. 控制台 API KEY → 创建
  2. 填写名称（如 prod-chat）
  3. 选择计费方式并完成绑定或限额设置
  4. 立即复制 完整密钥（sk- 开头）—— 只显示一次

DANGER

密钥丢失无法找回，只能作废后新建。请勿告诉他人或写在公开网页上。

步骤三：确认模型名称

在终端执行（使用步骤二创建的密钥）：

curl -sS https://mass.gogpu.cn/v1/models \
  -H "X-API-Key: sk-你的密钥"

在返回结果中找到要用的模型 id，与控制台 接口模型名称 一致；请求里的 model 字段须 完全相同（区分大小写）。

步骤四：发起首次对话

将下面命令中的密钥和模型名换成您的实际值：

curl https://mass.gogpu.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk-你的密钥" \
  -d "{\"model\":\"你的模型名称\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}"

成功时返回 JSON，其中 choices[0].message.content 为模型回复；usage 中为本次 Token 用量。

若返回 {"code":7,"msg":"..."}，表示未通过校验，请根据 msg 处理（常见：密钥错误、余额不足、模型名错误），详见 API 调用指南 · 常见报错对照。

若 JSON 不便手写，也可用多行格式（注意引号转义）：

curl https://mass.gogpu.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk-你的密钥" \
  -d '{
    "model": "你的模型名称",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

步骤五：确认扣费

计费方式在控制台查看
套餐套餐管理 → 剩余 Token 减少；调用统计 有记录
按量调用统计 有记录；稍后 收支明细 出现余额扣费

使用 Python（可选）

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://mass.gogpu.cn/v1",
)

resp = client.chat.completions.create(
    model="你的模型名称",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

下一步

目标文档
流式输出、更多工具配置API 调用指南
请求体字段与 JSON 示例请求参数说明
价格与结算计费方式说明
控制台功能控制台使用指南
报错排查常见问题
复制 MD