> ## 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.

# 迁移已有 OpenAI 兼容应用

> 更换地址、凭证和模型，分阶段验证兼容性。

迁移时先验证最小文本请求，再逐项验证业务所需能力。接口格式兼容不意味着不同模型的参数和行为完全相同。

## 修改三项配置

| 配置 | APIONE 设置 |
| - | - |
| Base URL | `https://api.apione.ai/v1` |
| API Key | APIONE 控制台创建的密钥 |
| `model` | 当前 Key 可调用的模型 ID |

地址、密钥和模型作为一组配置切换。不要继续使用原厂商密钥，也不要把 APIONE Key 发往旧服务地址。完整代码见[SDK 教程](https://apione.ai/docs/guides/sdks.md)，模型 ID 见[模型查询](https://apione.ai/docs/models/catalog.md)。

如果项目使用 Anthropic 或 Gemini 原生格式，按[接口地址与鉴权](https://apione.ai/docs/api/overview.md)配置相应协议，不能直接套用上表的 OpenAI SDK 地址。

## 分阶段验收

1. 在测试环境验证单轮文本与多轮历史。
2. 检查输出上限、结束原因和错误响应。
3. 分别验证业务必需的流式、JSON、工具调用或图像输入。
4. 用同一组任务比较质量、用量和耗时，避免凭单次回复判断稳定性。
5. 小范围切换流量，观察错误率与费用，再扩大使用。

APIONE 的权限按自身 API Key 生效，OpenAI 的 `organization`、`project` 设置不生效。上游模型的可选参数也需逐项核对，见[兼容范围](https://apione.ai/zh/api-docs/docs/openai-compat)。

## 迁移后常见问题

| 现象 | 优先检查 | 参考 |
| - | - | - |
| cURL 成功，项目失败 | SDK 实际地址、环境变量、重复路径和代理设置 | [SDK 接入](https://apione.ai/docs/guides/sdks.md) |
| 模型不可用或返回 403 | 模型 ID、当前 Key 权限和所选分组 | [模型选择](https://apione.ai/docs/models/catalog.md) |
| 文本正常，流式或工具调用失败 | 目标模型能力、事件解析和可选参数 | [流式处理](https://apione.ai/docs/models/streaming.md)、[工具调用](https://apione.ai/docs/models/advanced.md) |
| 费用与旧平台不同 | APIONE 分组价格、输入输出和其他计费项目 | [用量与费用](https://apione.ai/docs/account/usage.md) |

## 回退与数据

保留经过验证的上一份配置。回退时同时切换地址、密钥和模型，避免混用。日志和配置对比中不要输出密钥。

其他平台的备用域名、优惠、路由模型名、账单规则、工作区功能和数据保留承诺不自动适用于 APIONE。收费与限制以 APIONE 控制台和当前公开说明为准。


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