---
title: "다른 서비스에서 1折AI로 마이그레이션"
description: "주소, 키, 모델, 프로토콜, 기능을 항목별로 마이그레이션하며 원래 설정을 복구 가능한 상태로 보존합니다."
headingIds: {"네 가지 설정을 함께 확인":"section-1","순서대로 검증":"section-2","환경 변수의 적용 범위":"section-3","전환 실패 시 복구":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

[1ZheAI](https://1zheai.com/en/editorial/#publisher)가 관리하는 문서입니다. [출처 및 수정 사항](https://1zheai.com/en/editorial/).

오류를 발견하셨나요? 페이지 주소와 설명을 첨부하여 [고객 지원](mailto:support@1zheai.com)으로 문의해 주세요. API 키나 계정 정보는 보내지 마세요.

</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만 요구합니다. [해당 도구 튜토리얼](/ko/docs/integrations/)을 기준으로 합니다.

## 순서대로 검증

<Steps>
<Step title="모델 목록 확인">

[모델 조회 인터페이스](/ko/docs/api-models/)에 따라 한 번 호출합니다. 실패하면 주소, 자격 증명 또는 접근 조건을 먼저 수정하고, 여러 비즈니스 파라미터를 동시에 조정하지 마세요.

</Step>
<Step title="최소 텍스트 요청 실행">

[Chat Completions](/ko/docs/api-chat-completions/), [Responses](/ko/docs/api-responses/) 또는 [Messages](/ko/docs/api-messages/) 중에서 선택합니다. 기존 클라이언트에 필요한 프로토콜을 유지하고, 선택적 파라미터를 먼저 제거합니다.

</Step>
<Step title="기능별로 비즈니스 기능 복원">

스트리밍, 다중 턴 대화 기록, 도구 호출 및 필요한 기타 기능을 차례로 검증합니다. 한 번에 하나씩 추가하고 비교 가능한 오류 응답을 보존하세요. 일반 텍스트가 성공한다고 해서 Agent의 파일, 검색 및 보조 모델이 모두 호환된다는 의미는 아닙니다.

</Step>
<Step title="실제 요청 출처 확인">

[호출 로그](/ko/docs/usage-logs/)에서 요청 시간과 모델을 확인합니다. 설정을 다시 불러와야 하는 터미널, IDE 또는 백그라운드 서비스를 재시작하여 이전 환경 변수를 계속 사용하지 않도록 합니다.

</Step>
</Steps>

## 환경 변수의 적용 범위

터미널의 `export`은 현재 셸과 이후에 시작된 하위 프로세스에만 영향을 줍니다. 데스크톱 애플리케이션, 컨테이너, 예약 작업 및 시스템 서비스는 다른 환경을 사용할 수 있습니다. 실제 프로그램이 실행되는 곳에서 자격 증명을 구성하세요.

설정 파일의 동일한 이름의 필드도 환경 변수를 덮어쓸 수 있습니다. Claude Code, Codex 등의 도구는 각각의 튜토리얼을 참고하고, 모든 공급자 변수를 전역 셸 설정에 한꺼번에 쌓지 마세요.

## 전환 실패 시 복구

이전에 저장한 공급자, 주소 및 모델 설정을 복원하고 클라이언트를 다시 시작하세요. 운영 업무를 마이그레이션하는 경우 먼저 소량의 요청으로 검증한 후 범위를 확대하고, 애플리케이션 레벨의 설정 전환 방식을 유지하여 서비스를 복구하기 쉽게 하세요.

기능이 열려 있는지 확실하지 않으면 모델 카탈로그에서 확인하거나 지원팀에 문의하세요. 다른 플랫폼이 Embeddings, Batch 또는 특정 독점 이미지 모델을 제공한다고 해서 이 사이트도 동일한 서비스를 제공한다고 가정하지 마세요.
