빠른 답변
기억해 두십시오: OpenAI 모델은
/v1가 필요하고, Claude는 루트 도메인만 사용하며, Gemini는 /v1beta가 필요합니다. 잘못된 Base URL은 가장 흔한 통합 문제입니다.왜 모델마다 기본 URL이 다른가요?
이는 각 벤더의 SDK 구현 방식에 따라 결정됩니다.- OpenAI SDK:
base_url뒤에 리소스 경로를 추가하므로/v1이 포함되어야 합니다 - Anthropic SDK: 내부적으로
/v1/messages를 덧붙입니다. 따라서/v1를 직접 추가하면/v1/v1/messages(404 오류)가 발생합니다 - Google GenAI SDK:
/v1beta경로를 사용하며, SDK가 연결을 자동으로 처리합니다
코드 예제
OpenAI 호환 모델 (GPT / DeepSeek / Llama 등)
Claude 모델 (Anthropic SDK)
Gemini 모델 (Google GenAI SDK)
도메인 노드 선택
APIYI는 네트워크 라우팅과 배포 아키텍처만 다르고 기능은 동일한 4개의 도메인 노드를 제공합니다:🌏 해외용 권장 글로벌 직결
vip.apiyi.com백엔드로 직접 연결되어 지연 시간이 가장 짧습니다. 중국 본토가 아닌 모든 고객에게 권장됩니다.🇨🇳 중국 기본값 본토용 권장
api.apiyi.com중국 본토 네트워크에 최적화되어 있습니다. 중국 본토 고객의 기본값입니다.🏢 중국 백업 / 비즈니스
b.apiyi.com백업 노드와 Business 엔터프라이즈 라인입니다. 기본 노드를 사용할 수 없을 때 사용합니다.⚡ Cloudflare CDN 글로벌 가속
api-cf.apiyi.comCloudflare 글로벌 CDN 가속입니다. 텍스트 전용 API 호출에 사용합니다. 100초 타임아웃 제한이 있습니다.일반적인 오류 해결
전체 설정 레퍼런스
OpenAI 호환 모델
Claude 모델 (Anthropic SDK)
Gemini 모델
Google GenAI SDK를 Gemini에 사용할 때는
base_url를 루트 도메인으로 설정하고 api_version: "v1beta"를 설정하십시오 — SDK가 전체 경로를 자동으로 구성합니다.