返回博客
实战·2026年5月25日·阅读约 5 分钟

在中国调用 Claude / GPT API — 直连、付款与重试写法

从国内调用 Kunavo:网关在美东单一区域,时延由你的国际出口决定,附自测命令。支付宝 / 微信支付 / 双币卡都可用。健壮重试代码 + 什么时候真的需要转发。

国内开发者最常问的几个问题:能不能直接调用 Claude / GPT?什么时候要走代理? 怎么付款?这篇文章逐个回答;时延给你一个自己测的方法,而不是一个我们无法对你的网络负责的数字。

结论先行

Kunavo 的网关运行在单一美东区域(弗吉尼亚州 Ashburn),入口是一层 anycast 边缘网络。从中国大陆主流云厂商(阿里云、腾讯云、华为云)无需代理即可直连;往返时间由境内到美东的实际链路决定, 我们不对具体时延做承诺 —— 直连 Anthropic 或 Google 走的是同一段跨洋路径。

不用代理,直接调用

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)

这就是全部。请求从 anycast 入口进来、在美东处理,所以你测到的往返时间主要由所在网络的 国际出口决定 —— 直连 Anthropic 或 OpenAI 也要走同一段跨洋链路。

自己测一下时延

在你要跑生产流量的那台服务器上执行一次,看连接和首字节各花多久:

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"

上游的瞬时错误(429、502、503、504、529 和连接中断)会在开始返回内容之前、 在同一个请求里自动重试一次;模型配置了多条通道时,还会换到下一条。仍然失败的请求不计费, 实际成功率见状态页。

偶发抖动的健壮性写法

中国大陆的国际网络偶尔会有 5-30 秒抖动,建议客户端加超时 + 退避重试。 失败的请求 Kunavo 不计费,所以重试零成本。

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

支付方式 —— 国内可用

  • 支付宝(Alipay):Stripe 渠道,国内常见银行卡都支持
  • 微信支付:同上
  • 国内 Visa/Mastercard 双币种卡(招行、中信等大多数双币卡可用)
  • 美元美卡(如果你有的话)

最低 $10 起充,按需付费,余额永不过期。各模型单价见价格页。

什么时候真的需要代理

多数情况不需要。例外是服务器所在网络的国际出口本身不稳定(家用宽带、个别城域网)。建议:

  • 用阿里云/腾讯云等云服务器(不是家用宽带)跑生产流量
  • 仍然不稳时,在境外(例如香港)的云主机上做一层转发。网关只有美东一个区域, 我们这边没有可以替你切换的线路

常见疑问

  • 会限速吗?网关目前不对调用频率设限。你可以给每把 key 设月度消费上限和 IP 白名单,入口在 /app/keys。
  • 能跑生产吗?能,但我们不发布 SLA 百分比。上游的瞬时错误会在同一个请求里 自动重试,失败的请求不计费;实测成功率公开在状态页。
  • 能开发票吗?不能。我们不出具发票,中国境内的增值税发票也开不了; 能当凭据用的只有你在银行卡 / 微信 / 支付宝账单上看到的那笔扣款,以及/app/billing 里的充值记录与逐笔消耗。 走公司采购流程的,写信到 sales@kunavo.com,我们直接告诉你能配合到什么程度。
  • 有没有视频和音频模型?有。Veo 3(视频)、Suno(音乐) 可调,一份账单。/models。

准备开始?注册后 $10 起充、按需付费,余额永不过期。 看完整文档:/docs/quickstart。