Base URL 是否包含 /v1？
OpenAI SDK 填https://api.apione.ai/v1；Anthropic SDK 填 https://api.apione.ai，不带 /v1。如果客户端要求完整端点，按其要求填写完整路径。见接口地址与鉴权。
能否使用原厂商 API Key？
发往 APIONE 的请求使用 APIONE 控制台创建的密钥。域名和密钥要配套，避免把密钥发给错误的服务地址。为什么示例模型无法调用？
示例中的模型不一定对当前 Key 开放。查询当前 Key 可用的模型，复制准确的模型 ID，再检查 Key 权限、分组与余额。平台模型目录中的展示名称不一定是请求使用的 ID。兼容 OpenAI 是否意味着所有能力都能用？
接口、模型和客户端都需要支持目标能力。图片输入、结构化输出、工具调用和 Responses 要分别核对，不能只凭“兼容 OpenAI”判断。见模型能力检查和结构化输出与工具调用。为什么多轮对话忘记上一轮内容？
Chat Completions 由应用发送所需的历史消息。只发送本轮用户消息，不会自动包含之前的对话。见对话调用。HTTP 200 但没有完整回复怎么办？
检查finish_reason、流式错误和连接是否中断。工具调用可能没有普通正文；length 可能表示输出被截断。HTTP 200 只说明请求或流已开始成功返回，仍需检查完整结果。见流式处理。
后台显示密钥有效，接口却提示过期怎么办？
API token has expired 表示接口返回了过期错误。若控制台显示该密钥仍有效，需要进一步核对鉴权记录。
- 确认客户端使用的是该条密钥，检查是否有旧环境变量、旧进程或重复鉴权头。
- 直接调用
GET https://api.apione.ai/v1/models，保留状态码与响应正文。 - 记录请求时间和时区，以及响应中的
X-Request-ID或X-Maxx-Trace-Id；若返回其他请求标识，也一并保留。 - 将后台有效状态与接口错误交给支持核查，重点检查有效期存储、时间单位、永久有效值和鉴权缓存。
失败调用会收费吗？
平台最终判定失败的模型调用不收费。客户端显示超时、主动取消、连接中断，或生成成功后下载失败，不等于平台调用失败；若平台已完成生成或确认了实际用量，相应费用按该模型和分组的规则结算。 流式请求应结合最终状态与实际用量判断，不能只看 HTTP 200、客户端错误提示或是否收到了全部输出。已生成的内容未被完整接收，也不代表没有发生调用。 状态或扣费有疑问时，保留请求 ID、发生时间和时区、模型、最终状态及错误信息，联系支持核查。核实误扣或重复扣费后更正账目；不要在状态未知时连续重新创建任务。能否直接在浏览器放 API Key？
平台 Key 应保存在自己的服务端。为终端用户配置应用级鉴权和限额，避免把 Key 写入公开网页代码、日志或截图。见密钥管理。是否承诺零数据存储或固定服务等级？
数据处理范围与服务条件见 APIONE 当前隐私说明和服务条款。有敏感数据或企业服务要求时，向支持确认适用条件。APIONE 价格是否固定等于官方 API？
不是固定同价。APIONE 按调用时当前分组的生效单价与实际用量结算，生效价已包含该分组折扣。模型广场当前展示多个折扣分组，实际价格通常可以低于供应商官方价格；最终以调用时的模型详情、控制台和账单为准。网页对话和 API 共用余额吗？
是。网页对话、图像、视频和 API 用量共用 APIONE 余额。不同套餐额度的使用顺序和有效期以控制台及正式规则为准。供应商故障时一定会自动成功吗？
不保证。智能路由会在同一模型的可用线路间选择或切换，但模型、参数、权限或余额错误无法通过换线路解决；所有线路都不可用时请求仍会失败。消费如何获得积分？
网页对话和 API 调用每消费$1 获得 5 积分。100 积分可兑换 $1 使用额度，相当于返 5%。积分不能提现，自实际到账之日起 6 个月内有效。
邀请返利和首充奖励怎么计算？
好友每充值$1，邀请人获得 5 积分，积分冻结 7–15 天后到账。被邀请人的首笔充值也按每 $1 赠送 5 积分，单笔最多 500 积分，即最多可兑换 $5 使用额度。同一设备、IP 或支付账号只计算一次奖励资格，异常行为会取消相关奖励。完整规则见积分与邀请奖励。