중국 본토 개발자가 가장 자주 묻는 질문: Claude / GPT를 직접 호출할 수 있나요? 언제 프록시를 사용해야 하나요? 어떻게 결제하나요? 이 글에서 하나씩 답합니다. 지연 시간은 네트워크에 대해 책임질 수 없는 수치가 아니라 직접 측정하는 방법을 제공합니다.
결론부터
Kunavo의 게이트웨이는 미국 동부 단일 리전(버지니아주 Ashburn)에서 실행되며, 진입점은 anycast 엣지 네트워크입니다. 중국 본토의 주요 클라우드 공급자(Alibaba Cloud, Tencent Cloud, Huawei Cloud)에서는 프록시 없이 직접 연결할 수 있습니다. 왕복 시간은 중국 내 위치에서 미국 동부까지의 실제 경로에 따라 결정되며, 구체적인 지연 시간은 보장하지 않습니다. Anthropic 또는 Google에 직접 연결해도 동일한 대양 횡단 경로를 사용합니다.
프록시 없이 직접 호출
from openai import OpenAI
client = OpenAI(
api_key="sk-kn-...",
base_url="https://api.kunavo.com/v1",
)
# 直接调用，不需要任何代理配置
resp = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "你好，中国大陆能稳定调用吗？"}],
)
print(resp.choices[0].message.content)이것이 전부입니다. 요청은 anycast 진입점으로 들어와 미국 동부에서 처리되므로, 측정되는 왕복 시간은 주로 사용 중인 네트워크의 국제 출구에 의해 결정됩니다. Anthropic 또는 OpenAI에 직접 연결해도 동일한 대양 횡단 경로를 거쳐야 합니다.
직접 지연 시간 측정
프로덕션 트래픽을 실행할 서버에서 한 번 실행해 연결과 첫 바이트에 각각 얼마나 걸리는지 확인하세요:
curl -o /dev/null -s \
-w "dns=%{time_namelookup}s connect=%{time_connect}s tls=%{time_appconnect}s ttfb=%{time_starttransfer}s\n" \
https://api.kunavo.com/v1/models \
-H "Authorization: Bearer $KUNAVO_API_KEY"업스트림의 일시적 오류(429, 502, 503, 504, 529 및 연결 중단)는 콘텐츠 반환 전에 동일한 요청에서 자동으로 한 번 재시도됩니다. 모델에 여러 채널이 구성된 경우 다음 채널로도 전환합니다. 그래도 실패한 요청에는 요금이 부과되지 않으며, 실제 성공률은 상태 페이지에서 확인할 수 있습니다.
간헐적 불안정에 강한 작성 방식
중국 본토의 국제 네트워크에서는 간혹 5~30초의 불안정이 발생할 수 있으므로 클라이언트에 시간 초과와 백오프 재시도를 추가하는 것이 좋습니다. 실패한 요청에는 Kunavo가 요금을 부과하지 않으므로 재시도 비용은 0입니다.
# 中国大陆网络偶尔抖动，建议给客户端加 timeout + 退避重试。
# 不要用大重试值打爆配额。
import time, random
from openai import OpenAI, APIConnectionError, APITimeoutError, RateLimitError
client = OpenAI(
api_key=os.environ["KUNAVO_API_KEY"],
base_url="https://api.kunavo.com/v1",
timeout=60, # 总超时
max_retries=0, # 关掉 SDK 自带重试，自己控制
)
def call_with_backoff(**kwargs):
last = None
for attempt in range(5):
try:
return client.chat.completions.create(**kwargs)
except (APIConnectionError, APITimeoutError, RateLimitError) as e:
last = e
time.sleep(min(30, (2 ** attempt) + random.random()))
raise last결제 수단 — 중국 본토에서 사용 가능
- Alipay: Stripe 채널, 중국에서 일반적으로 사용하는 은행 카드 지원
- WeChat Pay: 동일
- 중국 본토 Visa/Mastercard 이중 통화 카드(China Merchants Bank, CITIC 등 대부분의 이중 통화 카드 사용 가능)
- 미국 달러 카드(있다면)
최소 $10부터 충전, 종량제, 잔액 만료 없음. 모델별 단가는 가격 페이지에서 확인하세요.
실제로 프록시가 필요한 경우
대부분의 경우 필요하지 않습니다. 예외는 서버가 위치한 네트워크의 국제 출구 자체가 불안정한 경우입니다(가정용 광대역, 일부 도시권 네트워크). 권장 사항:
- Alibaba Cloud/Tencent Cloud 등의 클라우드 서버에서 프로덕션 트래픽 실행(가정용 광대역 제외)
- 여전히 불안정하다면 해외(예: 홍콩)의 클라우드 호스트에서 한 단계 전달합니다. 게이트웨이는 미국 동부 단일 리전이며, 저희가 대신 전환할 수 있는 회선은 없습니다.
자주 묻는 질문
- 속도 제한이 있나요? 현재 게이트웨이는 호출 빈도를 제한하지 않습니다. 각 키에 월별 지출 한도와 IP 허용 목록을 설정할 수 있으며, 위치는 /app/keys입니다.
- 프로덕션에서 사용할 수 있나요? 가능합니다. 다만 SLA 비율은 공개하지 않습니다. 업스트림의 일시적 오류는 동일한 요청에서 자동 재시도되며 실패한 요청에는 요금이 부과되지 않습니다. 실제 측정 성공률은 상태 페이지에 공개됩니다.
- 세금계산서를 발행하나요? 발행하지 않습니다. 저희는 세금계산서를 발급하지 않으며 중국 내 부가가치세 세금계산서도 발행할 수 없습니다. 증빙으로 사용할 수 있는 것은 은행 카드 / WeChat / Alipay 명세서에 표시되는 결제 내역과 /app/billing의 충전 및 건별 사용 기록뿐입니다. 회사 구매 절차를 이용하는 경우 sales@kunavo.com으로 문의하시면 협력 가능한 범위를 직접 안내해 드립니다.
- 비디오와 오디오 모델이 있나요? 있습니다. Veo 3(비디오), Suno(음악)를 사용할 수 있으며 청구서는 하나입니다. /models.
시작할 준비가 되었나요? 가입 후 $10부터 충전하고 종량제로 이용할 수 있으며 잔액은 만료되지 않습니다. 전체 문서: /docs/quickstart.