> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 常见问题总览
> API易 常见问题总索引：新手接入、模型调用、令牌与日志、充值计费、企业服务、账号登录，全部 FAQ 支持按主题与按症状两种方式检索。
这里汇总了 API易 全部常见问题。第一次来的话，先看**新手三步**和**高频问题**；已经在用、遇到具体报错的，直接跳到**按症状排查**；想系统翻一遍的，往下看**按主题浏览**。
## 🚀 新手三步
支持 Gmail、Outlook、Foxmail 及全球高校邮箱，也可用 GitHub 一键登录
在控制台令牌页拿到默认令牌，或新建一个专用 KEY 并选好分组
OpenAI 格式填 `/v1`，Claude 填根域名，Gemini 填 `/v1beta`
## 🔥 高频问题
获取默认令牌与新建 KEY 的完整步骤
`/v1`、根域名、`/v1beta` 三种填法分别对应哪类模型
按场景、成本、速度三个维度做模型选型
九成是 Base URL 与 KEY 不配套，先按这篇自查
预扣费机制与 max\_tokens 设置过大导致的余额判定
倍率是人民币计价单位，乘固定汇率才是美元等效价
首充加赠、阶梯加赠与企业客户政策
同一个模型，官网聊得聪明、API 却像变笨的原因
***
## 🔧 按症状排查
遇到具体问题时，先在这张表里对号入座。同一个现象可能跨多个主题，这里按你实际看到的表现重新串了一遍。
| 你遇到的现象 | 可能原因 | 去看 |
| ------------------- | --------------------------- | ------------------------------------------------------------------------------------------- |
| 提示 API Key 无效 / 401 | Base URL 与 KEY 不配套，或 KEY 填错 | [API Key 无效](/faq/invalid-api-key) · [Base URL 怎么填](/faq/base-url-config) |
| 有余额却跑不通 | 预扣费机制，或 max\_tokens 设得过大 | [余额跑不通](/faq/balance-insufficient) · [预扣费机制](/faq/pre-deduction-quota) |
| 请求超时 / 中途断连 | 客户端 timeout 太短，推理型模型耗时长 | [如何避免接口超时](/faq/timeout-configuration) |
| 429 并发报错 | 触达并发配额上限 | [API 可以开多少并发](/faq/api-concurrency) |
| 输出被截断、写到一半停 | max\_tokens 未设或设得太小 | [max\_tokens 是什么](/faq/max-tokens) |
| 某个模型调不了 | 账号权限未解锁，或令牌模型白名单限制 | [为什么有些模型用不了](/faq/model-availability) · [令牌可用模型](/faq/token-model-whitelist) |
| 出图失败 / 返回空结果 | 触发谷歌内容安全机制 | [Nano Banana 出图失败](/faq/nano-banana-image-failure) |
| 生成图与参考图差很多 | 参考图需用 base64 格式上传 | [出图与参考图不符](/faq/image-result-differs-from-reference) |
| 白底图出现黑点 / 脏块 | AI Studio 通道纯白背景的已知表现 | [白底图脏块](/faq/white-background-image-artifacts) |
| 想用任务 ID 查出图结果 | 图片生成均为同步调用 | [图片生成有异步接口吗](/faq/image-async-api) |
| 模型自称别家模型 / 说不出版本号 | 模型自我认知本就不可靠 | [Claude 自称 Qwen](/faq/claude-identity-confusion) · [模型不知道自己版本](/faq/model-version-identity) |
| 官网聪明、API 变笨 | 官网带系统提示词与工具链，API 是裸模型 | [网页版与 API 的差异](/faq/webapp-vs-api-difference) |
| KEY 有陌生调用 | KEY 可能已泄露，需定位去向并停用 | [排查莫名的 KEY 调用](/faq/troubleshoot-key-usage) · [安全管理 API Key](/faq/key-security-management) |
| 账单对不上 / 看不懂扣了多少 | 按量与按次计费口径不同 | [看懂日志计费金额](/faq/log-billing-explained) · [模型倍率](/faq/model-multiplier) |
| 图片视频下载很慢 | 海外 CDN 在特定服务器上的链路问题 | [CDN 下载慢](/faq/cdn-download-slow) |
| 需不需要挂代理 | 国内可直连，无需代理 | [是否需要代理网络](/faq/network-proxy) |
| GitHub 登录提示「该账户已绑定」 | 该 GitHub 账户已绑到别的邮箱 | [GitHub 绑定报错](/faq/github-bindng-bindng-error) |
| 忘记密码登不进去 | 邮箱重置或联系客服找回 | [忘记密码怎么办](/faq/forgot-password) |
***
## 📚 按主题浏览
### 🧭 网站功能介绍（3 篇）
| 问题 | 一句话答案 |
| ------------------------------------------------ | --------------------- |
| [令牌与分组](/faq/token-and-groups) | KEY 怎么建、分组怎么选 |
| [什么是分组？用户分组与令牌分组解析](/faq/groups-explained) | 实际生效的始终是令牌上选的分组 |
| [为什么 API易 没有一键对接功能？](/faq/one-click-integration) | 模型接入方式不统一，改用右上角 AI 助手 |
### ⚙️ 模型与调用（15 篇）
| 问题 | 一句话答案 |
| -------------------------------------------------------------------------- | ---------------------------------- |
| [Google 系模型走的是 AI Studio 还是 Vertex？](/faq/google-upstream-aistudio-vertex) | 默认分组走官转 AI Studio 线路 |
| [白底图出现黑点 / 脏块 / 模糊色块怎么办？](/faq/white-background-image-artifacts) | 提示词改用浅色背景可规避 |
| [如何选择合适的 AI 模型？](/faq/model-selection-guide) | 按场景、成本、速度三维度选型 |
| [为什么有些模型我用不了？](/faq/model-availability) | 部分模型需解锁权限后才可调用 |
| [为什么官方网页版和 API 返回结果不同？](/faq/webapp-vs-api-difference) | 官网带系统提示词，API 是裸模型 |
| [为什么大模型不知道自己的版本号？](/faq/model-version-identity) | 模型自我认知不可靠，不能当依据 |
| [为什么 Claude 会自称 Qwen 或 DeepSeek？](/faq/claude-identity-confusion) | 身份幻觉，不代表模型被换 |
| [模型名称后缀 -c 是什么意思？](/faq/model-name-suffix-c) | 标识不同通道，计费有差别 |
| [Base URL 怎么填？/v1、根域名、/v1beta 有什么区别？](/faq/base-url-config) | 按 OpenAI / Claude / Gemini 三种格式分别填 |
| [如何避免接口超时？](/faq/timeout-configuration) | 放宽客户端 timeout，推理模型尤其慢 |
| [API 可以开多少并发？](/faq/api-concurrency) | 分模型类型限制，可申请提额 |
| [max\_tokens 是什么？不设置会怎样？](/faq/max-tokens) | 控制最大输出长度，不设有默认值 |
| [Nano Banana 系列出图失败，常见原因有哪些？](/faq/nano-banana-image-failure) | 多数是触发谷歌内容安全机制 |
| [接入模型后生成的图片和参考图相差很大怎么办？](/faq/image-result-differs-from-reference) | 参考图必须用 base64 格式上传 |
| [图片生成有异步接口吗？支持任务 ID 查询结果吗？](/faq/image-async-api) | 均为同步调用，无任务 ID 查询 |
### 🔑 令牌与日志（9 篇）
| 问题 | 一句话答案 |
| ------------------------------------------------ | --------------------- |
| [如何创建 KEY？](/faq/token-management) | 控制台令牌页获取默认令牌或新建 |
| [令牌需要设置可用模型吗？](/faq/token-model-whitelist) | 可选，多项目隔离时建议设 |
| [如何安全地管理 API Key？](/faq/key-security-management) | IP 白名单、模型白名单与日常使用习惯 |
| [令牌的按量优先/按次计费有什么区别？](/faq/token-billing-modes) | 五种计费模式各自的适用场景 |
| [如何查看我的调用记录？](/faq/call-logs) | 控制台日志页查调用与计费明细 |
| [怎么看懂日志里的计费金额？](/faq/log-billing-explained) | 按量与按次口径不同，可用 usage 自算 |
| [调用日志保存多久？多久清理一次？](/faq/log-retention-policy) | 当月加此前两个自然月，每月 5 日清理 |
| [为方便排查问题，可以在后台看到详细日志吗？](/faq/user-logs-control) | 管理员可临时开启详细日志 |
| [如何排查莫名的 KEY 调用？](/faq/troubleshoot-key-usage) | 按日志里的真实 IP 定位并及时停用 |
### 🏢 企业服务（7 篇）
| 问题 | 一句话答案 |
| -------------------------------------------------------------------- | ------------------ |
| [什么是企业分组（Enterprise）？什么时候该用？](/faq/enterprise-group-vertex-fallback) | 模型专属分组，供给更稳但倍率略高 |
| [API易 的企业服务值得信任吗？模型保真吗？](/faq/enterprise-trust) | 纯透明官转，不路由、不降智、不换模型 |
| [企业客户和个人用户有什么区别？](/faq/enterprise-vs-individual) | 账号属性相同，差别在协作与议价政策 |
| [企业客户如何充值？](/faq/enterprise-recharge) | 推荐对公转账，可开增值税发票 |
| [高校客户如何无忧报销？](/faq/university-reimbursement) | 提供发票、采购清单、盖章等报销材料 |
| [APIYI 有 SLA 保障吗？](/faq/sla-guarantee) | 有，含异常计费补偿与额度补发 |
| [智能体小程序需要做算法备案吗？](/faq/agent-miniapp-algorithm-filing) | 通常需要，本文说明一般流程 |
### 💰 充值与安全（14 篇）
| 问题 | 一句话答案 |
| ------------------------------------------------------- | --------------------------- |
| [价格和官网一样，为什么选择 API易？](/faq/official-pricing-advantages) | 同价但有充值加赠，可叠加分组折扣 |
| [为什么 API易 能比官网价格低？](/faq/why-cheaper-than-official) | 规模化采购与厂商渠道分发，不是降智 |
| [系统里模型的【倍率】是什么？](/faq/model-multiplier) | 人民币计价单位，乘固定汇率得美元等效价 |
| [100 元人民币可以兑换多少算力？](/faq/rmb-to-computing-power) | 兑换比例由客户自己的系统决定 |
| [API易支持缓存计费吗？](/faq/cache-billing) | 主流通道均支持，命中率因厂商而异 |
| [API 调用的预扣费机制是什么？](/faq/pre-deduction-quota) | 请求前按预估扣，结束后按实际结算 |
| [为什么还有余额跑不通？](/faq/balance-insufficient) | 预扣费判定或 max\_tokens 设得过大 |
| [如何设置余额告警提醒？](/faq/balance-alerts) | 邮件、群机器人、余额提醒 API 三选一 |
| [APIYI 支持哪些充值方式？](/faq/payment-methods) | 微信、支付宝、USDT、Stripe、PayPal 等 |
| [网站有什么充值活动吗？](/faq/recharge-promotions) | 首充加赠、阶梯加赠与发票服务 |
| [如何申请代理合作？可以邀请好友返佣吗？](/faq/referral-program) | 默认有邀请返佣，无需单独申请 |
| [API易 的退款政策是怎样的？](/faq/refund-policy) | 退款条件、流程、手续费与发票说明 |
| [内容安全如何合规性？](/faq/content-safety) | 内容审核机制与违规处理措施 |
| [API易如何保障数据安全？](/faq/data-security) | 加密传输、最小化存储、访问控制 |
### 🌐 网络与连接（3 篇）
| 问题 | 一句话答案 |
| ---------------------------------------------- | ------------------- |
| [使用 API 接口需要代理网络吗？](/faq/network-proxy) | 国内可直连，不需要代理或 VPN |
| [API易的服务器在哪里？应该选择什么服务器？](/faq/server-location) | 节点分布、延迟测试与选购建议 |
| [下载 CDN 图片/视频很慢怎么办？](/faq/cdn-download-slow) | 排查海外 CDN 在特定服务器上的链路 |
### 👤 账号与登录（6 篇）
| 问题 | 一句话答案 |
| ---------------------------------------------------------- | --------------------------- |
| [API易 支持哪些邮箱注册？](/faq/email-registration) | Gmail、Outlook、Foxmail 及高校邮箱 |
| [如何使用 Passkey 登录？](/faq/passkey-login) | 个人中心绑定后可用指纹或面容登录 |
| [GitHub 登录提示「该账户已绑定」怎么办？](/faq/github-bindng-bindng-error) | 该 GitHub 账户已绑到其他邮箱 |
| [忘记密码了怎么办？](/faq/forgot-password) | 邮箱重置或联系客服协助找回 |
| [为什么提示 API Key 无效？](/faq/invalid-api-key) | Base URL 与 KEY 不配套是最常见原因 |
| [如何注销账户？](/faq/account-deletion) | 个人中心一键注销，数据不可恢复 |
***
## 💬 没找到答案？
Cherry Studio、Claude Code、Cursor 等具体工具的接入指南
全部模型的实时定价总表与详情页
模型状态、供给变化、故障播报的每日更新
新模型上线、价格调整、功能更新的公告汇总
还是没解决？欢迎直接联系我们：
* 📧 **邮件咨询**：[support@apiyi.com](mailto:support@apiyi.com)
* 🌐 **访问控制台**：[api.apiyi.com](https://api.apiyi.com)
* 💰 **查看价格**：[价格页面](https://api.apiyi.com/account/pricing)
没找到的问题欢迎反馈给客服，我们会评估后补进 FAQ。新用户注册即可获得测试额度，可以先跑通再决定是否充值。