---
title: 从其他服务迁移到 1折AI
description: 按地址、密钥、模型、协议和功能逐项迁移，保留可回退的原配置。
---

<aside className="docs-publication" data-pagefind-ignore>文档由 <a href="https://1zheai.com/editorial/#publisher">1折AI</a> 维护。<a href="https://1zheai.com/editorial/">来源、商业关系与纠错说明</a>。发现错误，请向 <a href="mailto:support@1zheai.com">support@1zheai.com</a> 提供页面地址与可核查依据，不要发送密钥或账号资料。</aside>

迁移前保存原配置。先在单独的终端或开发环境里验证，确认成功后再更改常用工具或线上服务。

## 四项配置一起核对

| 配置 | 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。以[对应工具教程](/docs/integrations/)为准。

## 按顺序验证

<Steps>
<Step title="检查模型列表">

按照[模型查询接口](/docs/api-models/)调用一次。失败时先修正地址、凭据或访问条件，不要同时调整多项业务参数。

</Step>
<Step title="跑通最小文本请求">

选择 [Chat Completions](/docs/api-chat-completions/)、[Responses](/docs/api-responses/) 或 [Messages](/docs/api-messages/)。保持原客户端所需协议，先去掉可选参数。

</Step>
<Step title="逐项恢复业务功能">

依次验证流式、多轮历史、工具调用和所需的其他能力。每次只加一项，保留可对比的错误响应。普通文本成功不代表 Agent 的文件、搜索和辅助模型全部兼容。

</Step>
<Step title="核对实际请求来源">

在[调用日志](/docs/usage-logs/)确认请求时间与模型。重启需要重载配置的终端、IDE 或后台服务，避免它仍使用旧的环境变量。

</Step>
</Steps>

## 环境变量生效范围

终端里的 `export` 只影响当前 shell 和之后启动的子进程。桌面应用、容器、定时任务和系统服务可能使用另一套环境；在实际运行程序的地方配置凭据。

配置文件中的同名字段也可能覆盖环境变量。Claude Code、Codex 等工具分别参考各自教程，不要把所有供应商变量同时堆进全局 shell 配置。

## 切换失败时回退

恢复之前保存的供应商、地址与模型配置，并重新启动客户端。若你正在迁移生产业务，先对少量请求验证，再扩大范围；保留应用层配置切换方式，方便恢复服务。

不确定功能是否开放时，到模型目录核对或联系支持。不要因为其他平台提供 Embeddings、Batch 或某种专有图片模型，就假设本站也提供相同服务。