Chiamare Claude / GPT API dalla Cina — connessione diretta, pagamenti e modalità di retry

Le domande più frequenti degli sviluppatori nella Cina continentale: si possono chiamare direttamente Claude / GPT? Quando serve un proxy? Come si paga? Questo articolo risponde una per una; per la latenza ti offre un metodo di misurazione autonomo, invece di un numero di cui non possiamo garantire l'applicabilità alla tua rete.

Conclusioni in breve

Il gateway di Kunavo opera in un'unica regione sulla costa orientale degli Stati Uniti (Ashburn, Virginia), con una rete edge anycast all'ingresso. Dai principali provider cloud della Cina continentale (Alibaba Cloud, Tencent Cloud, Huawei Cloud) è possibile connettersi direttamente senza proxy; il tempo di andata e ritorno dipende dal percorso effettivo tra la Cina continentale e la costa orientale degli Stati Uniti. Non garantiamo una latenza specifica: la connessione diretta ad Anthropic o Google attraversa lo stesso percorso transoceanico.

Chiamate dirette senza proxy

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)

È tutto qui. La richiesta entra dall'ingresso anycast e viene elaborata sulla costa orientale degli Stati Uniti, quindi il tempo di andata e ritorno misurato dipende soprattutto dall'uscita internazionale della rete in uso: anche la connessione diretta ad Anthropic o OpenAI attraversa lo stesso collegamento transoceanico.

Misura tu la latenza

Esegui una volta il comando sul server su cui intendi gestire il traffico di produzione per vedere quanto impiegano la connessione e il primo byte:

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"

Gli errori transitori dell'upstream (429, 502, 503, 504, 529 e interruzioni della connessione) vengono ritentati automaticamente una volta prima che inizi la restituzione del contenuto, all'interno della stessa richiesta; quando per il modello sono configurati più canali, viene utilizzato anche il successivo. Le richieste che continuano a fallire non vengono addebitate; il tasso di successo effettivo è disponibile nella pagina di stato.

Scrivere codice robusto contro le oscillazioni occasionali

La rete internazionale della Cina continentale può occasionalmente avere oscillazioni di 5–30 secondi; consigliamo al client di aggiungere timeout e tentativi con backoff. Kunavo non addebita le richieste non riuscite, quindi i tentativi aggiuntivi hanno costo zero.

# 中国大陆网络偶尔抖动，建议给客户端加 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

Metodi di pagamento — disponibili nella Cina continentale

• Alipay: canale Stripe, supporta le carte bancarie comunemente utilizzate nella Cina continentale
• WeChat Pay: come sopra
• Carte Visa/Mastercard cinesi con doppia valuta (la maggior parte delle carte dual-currency di CMB, CITIC e altre banche è supportata)
• Carte statunitensi in dollari (se ne possiedi una)

Ricarica minima di $10, pagamento a consumo, il saldo non scade mai. I prezzi unitari di ciascun modello sono disponibili nella pagina dei prezzi.

Quando serve davvero un proxy

Nella maggior parte dei casi non serve. L'eccezione è quando l'uscita internazionale della rete in cui si trova il server è instabile (banda larga domestica, alcune reti metropolitane). Consigliamo di:

• utilizzare un server cloud di Alibaba Cloud, Tencent Cloud o simili (non una connessione domestica) per il traffico di produzione
• se l'instabilità persiste, predisporre un inoltro su un host cloud all'estero (per esempio a Hong Kong). Il gateway ha una sola regione, sulla costa orientale degli Stati Uniti; non disponiamo di un percorso alternativo su cui trasferirti

Domande frequenti

• Ci sono limiti di velocità? Attualmente il gateway non limita la frequenza delle chiamate. Puoi impostare per ogni chiave un limite di spesa mensile e una whitelist di IP; il punto di accesso è /app/keys.
• È adatto alla produzione? Sì, ma non pubblichiamo una percentuale SLA. Gli errori transitori dell'upstream vengono ritentati automaticamente all'interno della stessa richiesta e le richieste non riuscite non vengono addebitate; il tasso di successo misurato è pubblicato nella pagina di stato.
• Potete emettere fatture? No. Non emettiamo fatture e non possiamo emettere fatture IVA nella Cina continentale; le sole prove utilizzabili sono l'addebito visibile sull'estratto conto della carta bancaria / di WeChat / di Alipay e i registri delle ricariche e dei consumi individuali in /app/billing. Per gli acquisti aziendali, scrivi a sales@kunavo.com e ti diremo direttamente fino a che punto possiamo collaborare.
• Avete modelli video e audio? Sì. Veo 3 (video) e Suno (musica) sono disponibili, con un unico conto. /models.

Pronto per iniziare? Dopo la registrazione, ricarica a partire da $10 e paga a consumo; il saldo non scade mai. Consulta la documentazione completa: /docs/quickstart.