跳到主要内容

快速开始

三步完成首次调用:拿到企业 key → 调一次 Chat → 核对用量。

1. 获取企业 key

企业 key 由网关运营方通过 admin console(企业接入页)或管理接口签发,形如 agw_xxxxxxxx,绑定:

  • 组织:计费与账单主体;
  • scope:可访问的产品(text / image / search),越权访问返回 403;
  • 可选 RPM / TPM 限额
注意

key 明文只在创建时返回一次,请妥善保存。泄漏时联系运营方吊销并换发。

2. 首次调用

curl https://ai-gateway-6a41e6.preview.tencent-zeabur.cn/v1/chat/completions \
-H "Authorization: Bearer agw_你的key" \
-H "Content-Type: application/json" \
-d '{
"model": "azure-ai-foundry-deepseek-v4-pro",
"messages": [{"role": "user", "content": "你好"}],
"user": "user-1234"
}'

要点:

  • model 用网关的对外别名(完整列表见 GET /v1/models),网关内部自动路由到具体供应商线路;
  • user 字段建议始终携带(传你产品侧的用户 ID)——月度账单的人级明细按它聚合,见计费与对账

3. 核对用量与余额

调用成功后,运营方可在 admin console 的「用量账单」页看到逐笔事件;你会在月度结算单中看到按产品 × 模型和按 user 标签两套明细。

余额不足时接口直接返回 402(请求不会转发到上游,不产生费用),请联系运营方充值。

常见下一步