FAQ

常见问题

这里整理 PionicAI 用户最常遇到的兑换、Key、Base URL、模型、扣费、图片生成和工具配置问题。

快速开始

  • 控制台地址: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 Studiohttps://api.pionicai.com/v1
Claude Code / CC Switchhttps://api.pionicai.com
图片生成 APIhttps://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 时请尽快下载保存,避免临时链接失效。