快速开始
三步完成首次调用:拿到企业 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(请求不会转发到上游,不产生费用),请联系运营方充值。