常见问题

AIGCDesk 只有 API 产品吗？

不是。

AIGCDesk 是统一的产品平台，api.aigcdesk.com 是当前已发布并提供文档的产品之一。

当前站点提供哪些 AIGCDesk API 文档？

本站提供 AIGCDesk API 产品文档，重点包括：

• AIGCDesk API 概览
• 快速开始
• API Key 管理
• Claude Code 接入
• Codex 接入
• 接口基础信息
• 配额与速率限制
• 接入排查

规划中的产品有哪些？

当前已经纳入文档架构考虑的方向包括：

• AI Coding
• 绘画
• 视频

这些产品目前仍处于规划阶段。正式发布后，会补充各自的入口页、使用说明和参考文档。

我应该先看哪一页？

• 先确认站点里有哪些产品：看 产品目录
• 先了解 AIGCDesk 平台和产品矩阵：看 平台概览
• 统一理解平台、产品与接入术语：看 术语说明
• 先确认 AIGCDesk API 的入口与推荐路径：看 AIGCDesk API 概览
• 想直接打开当前产品站点：访问 https://api.aigcdesk.com
• 开始接入 AIGCDesk API：看 快速开始
• 管理或轮换密钥：看 API Key 管理
• 接入 Claude Code：看 接入 Claude Code
• 接入 Codex：看 接入 Codex
• 核对请求格式：看 接口基础信息
• 确认限制信息：看 配额与速率限制
• 按症状排查失败请求：看 接入排查

API 地址是什么？

当前统一使用以下基础地址：

https://api.aigcdesk.com

如果你在 Claude Code 中配置，请把它填到 ANTHROPIC_BASE_URL。

如果你在 Codex 中配置，请把它写入 config.toml 里 provider 的 base_url，并保留 /v1 路径。

API Key 应该怎么用？

• 在 AIGCDesk API 控制台里，它对应一枚 Token；对调用方来说，最终仍然作为 API Key 使用
• 直接调用 API 时，将 API Key 放进请求头：Authorization: Bearer YOUR_API_KEY
• 接入 Claude Code 时，将 API Key 写入 settings.json 中的 ANTHROPIC_AUTH_TOKEN，并同时设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 为 1
• 接入 Codex 时，可将 API Key 写入 ~/.codex/auth.json 的 OPENAI_API_KEY，并在 config.toml 对应 provider 中设置 requires_openai_auth = true
• 使用前请先确认对应 Token 仍可用，且没有被额度、过期时间或模型限制拦住

模型名称应该怎么填？

请求里的 model 必须使用当前站点允许调用的名称。

如果站点启用了模型映射，请直接使用映射后的外部名称，不要照抄渠道侧的原始模型名。

第一次请求失败，先检查什么？

• 基础地址是否写成了 https://api.aigcdesk.com
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 是否写成了 1
• 对应 Token 是否可用，是否还有额度
• 模型名称是否与当前站点允许调用的名称一致，是否受模型映射影响
• 请求体字段是否完整
• 日志里是否能看到对应的 request_id

如果仍然没有定位到原因，继续查看 接入排查。

开始接入前需要先通读整站吗？

不需要。

如果你要开始接入 AIGCDesk API，直接从 快速开始、接入 Claude Code 或 接口基础信息 进入即可。需要了解平台结构与产品范围时，再查看 平台概览。

如果你刚从搜索结果或外部链接进入站点，也可以先看 产品目录 或 AIGCDesk API 概览，再按目标进入具体页面。

如果你要把 AIGCDesk API 接到本地编码代理里，也可以直接从 接入 Codex 进入。

这个站点支持哪些语言？

当前支持：

• 简体中文：根路径 /
• English：/en/