常见问题

接入

我已经在用 OpenAI 的 SDK，迁移要改多少代码？

两行配置：base_url 换成 https://api.apione.ai/v1，api_key 换成 APIONE 的 Key。模型名换成 APIONE 上的模型 ID（例如 gpt-5.6-sol）。其余代码不动。

可以同时用 OpenAI 和 Anthropic 两种协议吗？

可以，同一把 Key 同时支持。选哪个取决于你的 SDK 与工具链，见 OpenAI 兼容与 Anthropic 兼容。

支持函数调用 / 结构化输出 / 视觉输入吗？

支持，能力取决于具体模型。每个模型的能力矩阵见模型目录的模型详情页；对不支持的模型传相应参数会返回 400。

能在浏览器里直接调用吗？

技术上可以，但不要这么做——Key 会暴露给所有访客。正确做法是浏览器调用你自己的后端，由后端持 Key 调用 APIONE。

计费

有月费或最低消费吗？

没有。按量使用就是先充值、按实际用量扣减，余额不过期；订阅套餐是可选的优惠方式，见计费说明。

失败的请求会计费吗？

4xx 与未返回内容的 5xx 都不计费；故障转移中失败的尝试也不计费。但流式响应中途中断时，已生成的 token 会计费。详见计费说明。

价格比直接找厂商买贵吗？

每个模型的实际单价都标在模型目录里，可以直接和厂商官方价对比。

稳定性

某个厂商挂了会影响我吗？

同一模型通常有多个渠道，单个渠道故障时网关会在同一次请求内自动转移，见故障转移。只有该模型的全部渠道同时失败才会把错误透传给你。

为什么两次相同请求的延迟差很多？

可能命中了不同渠道，或者上游当时在排队。在控制台 › 用量 › 请求明细里按请求 ID（响应头 X-Maxx-Request-ID）可以看到每次调用的首字延迟；持续偏慢请带上几个请求 ID 联系我们。

有 SLA 吗？

需要书面 SLA 的企业客户，请联系我们沟通具体条款。

合规与数据

你们会存储我的请求内容吗？

默认不在请求结束后保存请求与响应正文，只记录计费所需的 token 计数与元数据。详见隐私政策。

数据会流向哪些第三方？

只流向本次调用实际命中的上游模型服务商，以及完成服务所必需的云、网络、支付与客服服务商，详见隐私政策。

能指定数据处理区域吗？

请求里不能指定渠道或区域，调用内容会发往所选模型的上游服务商所在区域。有强制合规要求的场景请联系我们确认。