> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 解答接入地址、模型、客户端、数据与费用疑问。

先用最小请求确认地址、密钥和模型，再检查客户端的附加配置。

| 遇到的问题 | 先做什么 | 继续阅读 |
| - | - | - |
| 401、404 或模型不可用 | 核对地址、鉴权、模型 ID 和 Key 权限 | [错误码与排查](https://apione.ai/docs/support/errors.md) |
| cURL 成功，SDK 或客户端失败 | 检查实际请求地址、环境变量和代理配置 | [SDK 接入](https://apione.ai/docs/guides/sdks.md) |
| 200 但回复为空或不完整 | 检查结束原因、工具调用和流式错误 | [流式处理](https://apione.ai/docs/models/streaming.md) |
| 费用与预期不一致 | 核对输入、输出、缓存及 Key 所选分组 | [用量与计费](https://apione.ai/docs/account/usage.md) |

## Base URL 是否包含 /v1？

OpenAI SDK 填 `https://api.apione.ai/v1`；Anthropic SDK 填 `https://api.apione.ai`，不带 `/v1`。如果客户端要求完整端点，按其要求填写完整路径。见[接口地址与鉴权](https://apione.ai/docs/api/overview.md)。

## 能否使用原厂商 API Key？

发往 APIONE 的请求使用 APIONE 控制台创建的密钥。域名和密钥要配套，避免把密钥发给错误的服务地址。

## 为什么示例模型无法调用？

示例中的模型不一定对当前 Key 开放。查询[当前 Key 可用的模型](https://apione.ai/docs/models/catalog.md)，复制准确的模型 ID，再检查 Key 权限、分组与余额。平台模型目录中的展示名称不一定是请求使用的 ID。

## 兼容 OpenAI 是否意味着所有能力都能用？

接口、模型和客户端都需要支持目标能力。图片输入、结构化输出、工具调用和 Responses 要分别核对，不能只凭“兼容 OpenAI”判断。见[模型能力检查](https://apione.ai/docs/models/catalog.md)和[结构化输出与工具调用](https://apione.ai/docs/models/advanced.md)。

## 为什么多轮对话忘记上一轮内容？

Chat Completions 由应用发送所需的历史消息。只发送本轮用户消息，不会自动包含之前的对话。见[对话调用](https://apione.ai/docs/models/chat.md)。

## HTTP 200 但没有完整回复怎么办？

检查 `finish_reason`、流式错误和连接是否中断。工具调用可能没有普通正文；`length` 可能表示输出被截断。HTTP 200 只说明请求或流已开始成功返回，仍需检查完整结果。见[流式处理](https://apione.ai/docs/models/streaming.md)。

## 后台显示密钥有效，接口却提示过期怎么办？

`API token has expired` 表示接口返回了过期错误。若控制台显示该密钥仍有效，需要进一步核对鉴权记录。

1. 确认客户端使用的是该条密钥，检查是否有旧环境变量、旧进程或重复鉴权头。
2. 直接调用 `GET https://api.apione.ai/v1/models`，保留状态码与响应正文。
3. 记录请求时间和时区，以及响应中的 `X-Request-ID` 或 `X-Maxx-Trace-Id`；若返回其他请求标识，也一并保留。
4. 将后台有效状态与接口错误交给支持核查，重点检查有效期存储、时间单位、永久有效值和鉴权缓存。

提交问题时使用[支持模板](https://apione.ai/docs/support/contact.md)，密钥仅提供页面可识别的名称或脱敏尾号。

## 失败调用会收费吗？

平台最终判定失败的模型调用不收费。客户端显示超时、主动取消、连接中断，或生成成功后下载失败，不等于平台调用失败；若平台已完成生成或确认了实际用量，相应费用按该模型和分组的规则结算。

流式请求应结合最终状态与实际用量判断，不能只看 HTTP 200、客户端错误提示或是否收到了全部输出。已生成的内容未被完整接收，也不代表没有发生调用。

状态或扣费有疑问时，保留请求 ID、发生时间和时区、模型、最终状态及错误信息，联系支持核查。核实误扣或重复扣费后更正账目；不要在状态未知时连续重新创建任务。

## 能否直接在浏览器放 API Key？

平台 Key 应保存在自己的服务端。为终端用户配置应用级鉴权和限额，避免把 Key 写入公开网页代码、日志或截图。见[密钥管理](https://apione.ai/docs/getting-started/api-keys.md)。

## 是否承诺零数据存储或固定服务等级？

数据处理范围与服务条件见 APIONE 当前[隐私说明](https://apione.ai/zh/api-docs/docs/privacy)和[服务条款](https://apione.ai/zh/api-docs/docs/terms)。有敏感数据或企业服务要求时，向[支持](https://apione.ai/docs/support/contact.md)确认适用条件。

## APIONE 价格是否固定等于官方 API？

不是固定同价。APIONE 按调用时当前分组的生效单价与实际用量结算，生效价已包含该分组折扣。模型广场当前展示多个折扣分组，实际价格通常可以低于供应商官方价格；最终以调用时的模型详情、控制台和账单为准。

## 网页对话和 API 共用余额吗？

是。网页对话、图像、视频和 API 用量共用 APIONE 余额。不同套餐额度的使用顺序和有效期以控制台及正式规则为准。

## 供应商故障时一定会自动成功吗？

不保证。智能路由会在同一模型的可用线路间选择或切换，但模型、参数、权限或余额错误无法通过换线路解决；所有线路都不可用时请求仍会失败。

## 消费如何获得积分？

网页对话和 API 调用每消费 `$1` 获得 5 积分。100 积分可兑换 `$1` 使用额度，相当于返 5%。积分不能提现，自实际到账之日起 6 个月内有效。

## 邀请返利和首充奖励怎么计算？

好友每充值 `$1`，邀请人获得 5 积分，积分冻结 7–15 天后到账。被邀请人的首笔充值也按每 `$1` 赠送 5 积分，单笔最多 500 积分，即最多可兑换 `$5` 使用额度。同一设备、IP 或支付账号只计算一次奖励资格，异常行为会取消相关奖励。完整规则见[积分与邀请奖励](https://apione.ai/docs/account/rewards.md)。

## 套餐会自动续费吗，升级后有效期会重算吗？

Plus、Pro、Max 都是一次性购买，全部额度购买后一次性发放，统一 28 天有效，不按天发放、不自动续费。升级只补按剩余时间折算的价差并增加额度差，保留剩余额度和原到期时间。不能降级；套餐到期后自行重新购买，未使用的套餐额度清零，独立的按量计费余额不受影响。完整价格与公式见[用量与套餐规则](https://apione.ai/docs/account/usage.md)。

当前分组生效价已经包含该分组折扣，按用量计算时不要再次乘折扣。只有明确标为基础价时才按分组规则折算一次。见[价格与对账示例](https://apione.ai/docs/account/pricing-groups.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.