快速开始
- 控制台地址:https://api.pionicai.com/dashboard/overview。
- OpenAI 兼容 Base URL:
https://api.pionicai.com/v1。 - Claude/CC 根地址:
https://api.pionicai.com。 - 先创建 API Key,再配置客户端,最后用小任务验证。
Base URL 怎么选
| Codex / OpenCode / Cursor / Cline / Cherry Studio | https://api.pionicai.com/v1 |
| Claude Code / CC Switch | https://api.pionicai.com |
| 图片生成 API | https://api.pionicai.com/v1/images/generations |
常见错误
- 401 Unauthorized:Key 错误、复制不完整、填成登录密码。
- 404 model not found:模型名不正确或当前分组没有权限。
- No available channel:渠道不可用、分组不匹配或模型暂时不可调度。
- 余额不足 / 402:钱包余额或 Key 限额不足。
- 请求超时:上游繁忙、图片生成耗时、上下文过长或本地网络问题。
如何控制成本
- 不同工具单独创建 Key,并设置额度。
- 先小任务测试,再做长上下文任务。
- 编程 Agent 不要一开始就扫描整个仓库。
- 图片生成先用小尺寸测试提示词,再生成高清图。
图片生成问题
- 图片模型是否可用以控制台模型列表为准。
- 文生图使用 /v1/images/generations。
- 图生图或编辑使用 /v1/images/edits,并用 multipart/form-data 上传图片。
- 返回 URL 时请尽快下载保存,避免临时链接失效。