빠른 답변
기억해 두십시오: 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는 기능은 동일하지만 네트워크 라우팅 및 배포 아키텍처가 다른 3개의 도메인 노드를 제공합니다:🌏 기본 (권장)
api.apiyi.com기본 메인 회선입니다. 중국 본토 내외의 모든 고객에게 권장됩니다.🏢 중국 백업 / 비즈니스
b.apiyi.com백업 노드 및 비즈니스 엔터프라이즈 전용 회선입니다. 기본 노드를 사용할 수 없을 때 사용합니다.⚡ Cloudflare CDN 글로벌 가속
api-cf.apiyi.comCloudflare 글로벌 CDN 가속입니다. 텍스트 전용 API 호출을 위한 노드입니다. 100초의 타임아웃 제한이 있습니다.자주 발생하는 오류 해결
전체 설정 참조
OpenAI 호환 모델
Claude 모델 (Anthropic SDK)
Gemini 모델
Gemini용 Google GenAI SDK를 사용할 때는
base_url을 루트 도메인 및 api_version: "v1beta"로 설정하십시오 — SDK가 자동으로 전체 경로를 구성합니다.