从其他服务迁移到 1折AI
按地址、密钥、模型、协议和功能逐项迁移，保留可回退的原配置。
迁移前保存原配置。先在单独的终端或开发环境里验证，确认成功后再更改常用工具或线上服务。
四项配置一起核对
“四项配置一起核对”小节链接| 配置 | 1折AI 的写法 | 常见遗漏 |
|---|---|---|
| OpenAI Base URL | https://1zheai.com/v1 | 多写 /chat/completions，或漏掉 /v1 |
| Anthropic Base URL | https://1zheai.com | SDK 又追加一次 /v1 |
| API 密钥 | 在本站控制台创建的密钥 | 沿用旧供应商的密钥 |
| 模型 ID | 本站 /v1/models 返回的完整 ID | 沿用带 vendor/ 前缀或自定义后缀的名称 |
原始 HTTP 请求需要完整端点路径；SDK 和桌面工具通常只要求 Base URL。以对应工具教程为准。
按顺序验证
“按顺序验证”小节链接检查模型列表
按照模型查询接口调用一次。失败时先修正地址、凭据或访问条件，不要同时调整多项业务参数。
跑通最小文本请求
选择 Chat Completions、Responses 或 Messages。保持原客户端所需协议，先去掉可选参数。
逐项恢复业务功能
依次验证流式、多轮历史、工具调用和所需的其他能力。每次只加一项，保留可对比的错误响应。普通文本成功不代表 Agent 的文件、搜索和辅助模型全部兼容。
核对实际请求来源
在调用日志确认请求时间与模型。重启需要重载配置的终端、IDE 或后台服务，避免它仍使用旧的环境变量。
环境变量生效范围
“环境变量生效范围”小节链接终端里的 export 只影响当前 shell 和之后启动的子进程。桌面应用、容器、定时任务和系统服务可能使用另一套环境；在实际运行程序的地方配置凭据。
配置文件中的同名字段也可能覆盖环境变量。Claude Code、Codex 等工具分别参考各自教程，不要把所有供应商变量同时堆进全局 shell 配置。
切换失败时回退
“切换失败时回退”小节链接恢复之前保存的供应商、地址与模型配置，并重新启动客户端。若你正在迁移生产业务，先对少量请求验证，再扩大范围；保留应用层配置切换方式，方便恢复服务。
不确定功能是否开放时，到模型目录核对或联系支持。不要因为其他平台提供 Embeddings、Batch 或某种专有图片模型，就假设本站也提供相同服务。