Kembali ke blog
Praktik langsung·25 Mei 2026·Baca 5 menit

Memanggil API Claude / GPT dari Tiongkok — koneksi langsung, pembayaran, dan pola retry

Memanggil Kunavo dari Tiongkok: gateway berada di satu wilayah AS Timur, latensi ditentukan oleh jalur keluar internasional Anda, dengan perintah pengujian mandiri. Alipay / WeChat Pay / kartu dual-currency semuanya dapat digunakan. Kode retry yang tangguh + kapan penerusan benar-benar diperlukan.

Beberapa pertanyaan yang paling sering diajukan pengembang di Tiongkok: apakah dapat langsung memanggil Claude / GPT? Kapan perlu menggunakan proxy? Bagaimana cara membayar? Artikel ini menjawabnya satu per satu; untuk latensi, kami memberi Anda cara mengukurnya sendiri, bukan angka yang tidak dapat kami pertanggungjawabkan terhadap jaringan Anda.

Kesimpulan terlebih dahulu

Gateway Kunavo berjalan di satu wilayah AS Timur (Ashburn, Virginia), dengan jaringan edge anycast sebagai pintu masuk. Dari penyedia cloud utama di Tiongkok daratan (Alibaba Cloud, Tencent Cloud, Huawei Cloud), Anda dapat terhubung langsung tanpa proxy; waktu pulang-pergi ditentukan oleh jalur aktual dari Tiongkok daratan ke AS Timur, dan kami tidak menjamin latensi tertentu — koneksi langsung ke Anthropic atau Google melewati jalur lintas samudra yang sama.

Panggil langsung tanpa proxy

first_call.py
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)

Itu saja. Permintaan masuk melalui pintu masuk anycast dan diproses di AS Timur, sehingga waktu pulang-pergi yang Anda ukur terutama ditentukan oleh jalur keluar internasional jaringan Anda — koneksi langsung ke Anthropic atau OpenAI juga melewati jalur lintas samudra yang sama.

Ukur latensi sendiri

Jalankan sekali di server yang akan menjalankan trafik produksi untuk mengetahui waktu koneksi dan byte pertama:

latency.sh
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"

Error sesaat dari upstream (429, 502, 503, 504, 529, dan pemutusan koneksi) akan otomatis dicoba ulang sekali sebelum konten mulai dikembalikan, dalam permintaan yang sama; jika model dikonfigurasi dengan beberapa saluran, sistem juga akan beralih ke saluran berikutnya. Permintaan yang tetap gagal tidak ditagihkan; tingkat keberhasilan aktual dapat dilihat di halaman status.

Pola penanganan yang tangguh untuk gangguan sesekali

Jaringan internasional Tiongkok daratan terkadang mengalami gangguan selama 5–30 detik; sebaiknya klien menambahkan timeout + percobaan ulang dengan backoff. Kunavo tidak menagihkan permintaan yang gagal, jadi percobaan ulang tidak berbiaya.

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

Metode pembayaran — tersedia di Tiongkok daratan

  • Alipay (Alipay): saluran Stripe, mendukung kartu bank yang umum di Tiongkok daratan
  • WeChat Pay: sama seperti di atas
  • Kartu dual-currency Visa/Mastercard domestik Tiongkok (sebagian besar kartu dual-currency dari China Merchants Bank, CITIC, dan lainnya dapat digunakan)
  • Kartu AS dalam dolar AS (jika Anda memilikinya)

Isi ulang minimum mulai dari $10, bayar sesuai pemakaian, saldo tidak pernah kedaluwarsa. Harga tiap model tersedia di halaman harga.

Kapan proxy benar-benar diperlukan

Dalam sebagian besar kasus, tidak diperlukan. Pengecualiannya adalah ketika jalur keluar internasional jaringan tempat server berada tidak stabil (broadband rumah atau jaringan metropolitan tertentu). Saran:

  • Jalankan trafik produksi di server cloud seperti Alibaba Cloud/Tencent Cloud (bukan broadband rumah)
  • Jika koneksi tetap tidak stabil, buat lapisan penerusan pada server cloud di luar negeri (misalnya di Hong Kong). Gateway hanya memiliki satu wilayah, yaitu AS Timur; di pihak kami tidak ada jalur lain yang dapat kami alihkan untuk Anda.

Pertanyaan umum

  • Apakah ada pembatasan laju? Gateway saat ini tidak membatasi frekuensi panggilan. Anda dapat menetapkan batas pengeluaran bulanan dan daftar putih IP untuk setiap kunci; lokasinya di /app/keys.
  • Apakah dapat digunakan untuk produksi? Ya, tetapi kami tidak menerbitkan persentase SLA. Error sesaat dari upstream akan otomatis dicoba ulang dalam permintaan yang sama, dan permintaan yang gagal tidak ditagihkan; tingkat keberhasilan berdasarkan pengujian dipublikasikan di halaman status.
  • Apakah dapat menerbitkan faktur? Tidak. Kami tidak menerbitkan faktur, termasuk faktur PPN di Tiongkok; satu-satunya bukti yang dapat digunakan adalah transaksi yang terlihat pada tagihan kartu bank / WeChat / Alipay Anda, serta catatan isi ulang dan penggunaan per transaksi di /app/billing. Untuk proses pengadaan perusahaan, kirim email ke sales@kunavo.com dan kami akan langsung memberi tahu sejauh mana kami dapat membantu.
  • Apakah tersedia model video dan audio? Ya. Veo 3 (video) dan Suno (musik) tersedia, dengan satu tagihan. /models.

Siap memulai? Setelah mendaftar, isi ulang mulai dari $10, bayar sesuai pemakaian, dan saldo tidak pernah kedaluwarsa. Lihat dokumentasi lengkap: /docs/quickstart.

Ulasan mendalam terkait