Gọi API Claude / GPT từ Trung Quốc — tự kiểm tra kết nối, thanh toán và cách viết lệnh thử lại

Những câu hỏi phổ biến nhất của các nhà phát triển ở Trung Quốc: có thể gọi Claude / GPT trực tiếp không? Khi nào cần dùng proxy? Thanh toán ra sao? Bài viết này trả lời từng câu; về độ trễ, bài viết đưa ra cách tự đo thay vì một con số mà chúng tôi không thể chịu trách nhiệm thay cho mạng của bạn.

Kết luận trước

Cổng kết nối của Kunavo chạy tại một khu vực duy nhất ở miền Đông Hoa Kỳ (Ashburn, Virginia). Việc có thể kết nối từ Trung Quốc đại lục hay không và thời gian khứ hồi mất bao lâu phụ thuộc vào tuyến kết nối thực tế từ mạng của bạn đến miền Đông Hoa Kỳ; chúng tôi không cam kết về khả năng kết nối hay độ trễ. Dưới đây là cách kiểm tra trên máy chủ của bạn.

Lần gọi đầu tiên

from openai import OpenAI

client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",
)

# 只需要换 base_url 和 api_key
resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好，中国大陆能稳定调用吗？"}],
)
print(resp.choices[0].message.content)

Bạn chỉ cần thay base_url và key. Yêu cầu được xử lý ở miền Đông Hoa Kỳ; thời gian khứ hồi phụ thuộc vào tuyến kết nối từ mạng của bạn đến miền Đông Hoa Kỳ.

Tự đo độ trễ

Trên máy chủ bạn định dùng để chạy lưu lượng sản xuất, hãy thực hiện một lần kiểm tra để xem kết nối và byte đầu tiên mất bao lâu:

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"

Các lỗi tức thời từ upstream (429, 502, 503, 504, 529 và gián đoạn kết nối) sẽ tự động được thử lại một lần trước khi bắt đầu trả nội dung, trong cùng một yêu cầu; khi mô hình được cấu hình nhiều kênh, hệ thống cũng sẽ chuyển sang kênh tiếp theo. Yêu cầu vẫn thất bại không bị tính phí; tỷ lệ thành công thực tế xem tại trang trạng thái.

Cách viết bền bỉ trước các dao động ngẫu nhiên

Mạng xuyên biên giới đôi khi có thể chập chờn; bạn nên thêm thời gian chờ và cơ chế thử lại với thời gian chờ tăng dần vào máy khách. Kunavo không tính phí cho yêu cầu thất bại đó.

# 中国大陆网络偶尔抖动，建议给客户端加 timeout + 退避重试。
# 不要用大重试值打爆配额。
import os
import random
import time

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

Phương thức thanh toán — dùng được tại Trung Quốc đại lục

• Alipay: Có trên trang thanh toán Stripe; khi mở tại Trung Quốc đại lục, giá được hiển thị bằng nhân dân tệ
• WeChat Pay: tương tự
• Các loại thẻ ngân hàng như Visa, Mastercard, American Express, JCB và UnionPay
• Thẻ Mỹ tính bằng đô la (nếu bạn có)

Nạp tối thiểu từ $10, trả theo mức sử dụng, số dư không bao giờ hết hạn. Đơn giá từng mô hình xem tại trang giá.

Khi nào thực sự cần proxy

Chúng tôi không thể xác định thay bạn liệu mạng của bạn có thể kết nối ổn định đến miền Đông Hoa Kỳ hay không: trước tiên, hãy chạy lệnh ở trên để kiểm tra một lần trên máy chủ sẽ xử lý lưu lượng sản xuất. Nếu kết quả kiểm tra cho thấy kết nối không ổn định, bạn có thể cân nhắc:

• Dùng máy chủ đám mây của Alibaba Cloud/Tencent Cloud hoặc tương tự (không dùng băng thông gia đình) để chạy lưu lượng sản xuất
• Nếu vẫn không ổn định, hãy dùng một lớp chuyển tiếp trên máy chủ đám mây ở nước ngoài (ví dụ: Hồng Kông). Gateway chỉ có một khu vực ở bờ Đông Hoa Kỳ; phía chúng tôi không có tuyến khác để chuyển giúp bạn

Các câu hỏi thường gặp

• Có giới hạn tốc độ không? Hiện gateway không giới hạn tần suất gọi. Bạn có thể đặt giới hạn chi tiêu hằng tháng và danh sách IP cho từng khóa; truy cập tại /app/keys.
• Có thể chạy sản xuất không? Có, nhưng chúng tôi không công bố tỷ lệ SLA. Lỗi tức thời từ upstream sẽ được tự động thử lại trong cùng một yêu cầu, yêu cầu thất bại không bị tính phí; tỷ lệ thành công đo thực tế được công khai trên trang trạng thái.
• Có thể xuất hóa đơn không? Không. Chúng tôi không phát hành hóa đơn, kể cả hóa đơn VAT tại Trung Quốc; bằng chứng duy nhất có thể sử dụng là khoản trừ tiền bạn thấy trên sao kê ngân hàng / WeChat / Alipay và lịch sử nạp tiền cũng như tiêu dùng từng giao dịch trong /app/billing. Nếu đi qua quy trình mua sắm của công ty, hãy viết tới sales@kunavo.com; chúng tôi sẽ nói rõ trực tiếp mức độ có thể hỗ trợ.
• Có mô hình video và âm thanh không? Có. Veo 3 (video), Suno (nhạc) đều có thể gọi, dùng chung một hóa đơn. /models.

Sẵn sàng bắt đầu? Sau khi đăng ký, bạn có thể nạp từ $10, trả theo mức sử dụng và số dư không bao giờ hết hạn. Xem tài liệu đầy đủ: /docs/quickstart.