快速开始
从创建可用 Token 到发出第一条请求,用最短路径完成 AIGCDesk API 连通性验证。
这是一条从 0 到 1 的操作流:登录 AIGCDesk API 控制台,准备一枚可用 Token,确认可用模型名称,然后发出第一条请求。
对调用方来说,你最终使用的是 API Key;在 AIGCDesk API 控制台里,它对应的是一枚 Token。
按顺序完成这 4 步
Section titled “按顺序完成这 4 步”登录控制台并进入 API 令牌页
AIGCDesk API 的用户调用凭证来自控制台里的 API 令牌 / Token 页面。先确认你能登录控制台并看到令牌管理入口。
创建或确认一枚可用 Token
创建新 Token,或确认现有 Token 仍可用。首次验证时,只需要一枚能正常调用的 Token。若控制台启用了额度、过期时间或模型限制,也请一并确认。
记下实际模型名称
请求里的 model 必须使用当前站点允许调用的名称。如果站点启用了模型映射,请使用映射后的外部名称,而不是渠道侧的原始模型名。
发送最小请求
把下面的 YOUR_API_KEY 和 YOUR_MODEL 替换成你自己的值,然后执行这条请求。
curl -X POST https://api.aigcdesk.com/v1/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "YOUR_MODEL", "messages": [ { "role": "user", "content": "hello" } ] }' 接口返回 200这说明基础地址、鉴权头和请求体结构至少已经打通。 API Key 可持续管理验证通过后,再去做 Token 额度、模型限制、轮换和停用策略。 继续配置 Claude Code如需在客户端中使用 AIGCDesk API,可继续查看 Claude Code 接入指南。 继续配置 Codex如需在本地编码代理中使用 AIGCDesk API,可继续查看 Codex 接入指南。 继续配置 OpenClaw如需让 OpenClaw 通过 AIGCDesk 调用模型,可继续查看 OpenClaw 接入指南。 响应里能看到关键信息重点确认输出内容,以及便于排障的
request_id 等字段。 失败时先查这 4 项
Section titled “失败时先查这 4 项”- Base URL 是否写成了
https://api.aigcdesk.com - 请求头是否使用
Authorization: Bearer YOUR_API_KEY model是否填写了当前站点允许调用的名称,是否受模型映射影响- 请求体是否至少包含
model和messages
如果调用返回额度不足、Token 无效、模型不可用之类的问题,优先回到控制台检查 Token 的额度、过期时间、模型限制和使用日志。