Skip to main content

빠른 답변

기억해 두십시오: 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)

Claude 사용자의 흔한 실수: 공식 Anthropic SDK를 사용할 때는 Base URL이 https://api.apiyi.com이어야 하며, /v1를 추가하면 안 됩니다. 다만 OpenAI SDK의 호환 모드로 Claude를 호출하는 경우에는 /v1이 필요합니다.

도메인 노드 선택

APIYI는 네트워크 라우팅과 배포 아키텍처만 다르고 기능은 동일한 4개의 도메인 노드를 제공합니다:

🌏 해외용 권장 글로벌 직결

vip.apiyi.com백엔드로 직접 연결되어 지연 시간이 가장 짧습니다. 중국 본토가 아닌 모든 고객에게 권장됩니다.

🇨🇳 중국 기본값 본토용 권장

api.apiyi.com중국 본토 네트워크에 최적화되어 있습니다. 중국 본토 고객의 기본값입니다.

🏢 중국 백업 / 비즈니스

b.apiyi.com백업 노드와 Business 엔터프라이즈 라인입니다. 기본 노드를 사용할 수 없을 때 사용합니다.

⚡ Cloudflare CDN 글로벌 가속

api-cf.apiyi.comCloudflare 글로벌 CDN 가속입니다. 텍스트 전용 API 호출에 사용합니다. 100초 타임아웃 제한이 있습니다.
Cloudflare CDN 노드 제한: api-cf.apiyi.com은 Cloudflare Workers에 배포되어 있으며, 최대 요청 타임아웃은 100초입니다. 따라서:
  • 적합한 경우: 일반 텍스트 채팅, 짧은 텍스트 생성 및 기타 빠른 응답 호출
  • 적합하지 않은 경우: 100초를 초과하는 복잡한 장문 작업
  • 적합하지 않은 경우: Nano Banana Pro 및 기타 이미지 생성 작업
  • 적합하지 않은 경우: 동영상 생성 API 호출
작업이 100초를 초과할 수 있다면, 대신 vip.apiyi.com(해외용) 또는 api.apiyi.com(중국 본토용)을 사용하십시오.
서비스 가용성을 높이기 위해 코드에서 자동 전환용 대체 노드를 설정할 것을 권장합니다.

일반적인 오류 해결

전체 설정 레퍼런스

OpenAI 호환 모델

Claude 모델 (Anthropic SDK)

Gemini 모델

Google GenAI SDK를 Gemini에 사용할 때는 base_url를 루트 도메인으로 설정하고 api_version: "v1beta"를 설정하십시오 — SDK가 전체 경로를 자동으로 구성합니다.