第一次接入 AI API：创建 API Key、发送请求与错误排查

准备好四项信息

在密钥管理创建或选择 API Key，按应用命名并选择有权限的分组；根据实际需要设置额度或有效期。再确认准确模型 ID、API 基础地址和协议。Key 并不会让所有目录中的模型自动可用，额度与权限应分别检查。

使用 Chat Completions 模板

下面是 POSIX shell 的 cURL 模板；Windows 用户可在合适的 shell 中使用，或参考开发者指南里的 Python、JavaScript 示例。先在本机设置 YOUJIE_BASE_URL 和 YOUJIE_API_KEY，再替换请求体里的模型标识。

curl "$YOUJIE_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $YOUJIE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_ENABLED_MODEL","messages":[{"role":"user","content":"用一句话说明什么是 Token。"}]}'

基础地址通常已经以 /v1 结束；不要在后面再加一次 /v1。模板不会自行寻找你的账户配置，也不保证 Messages 或 Gemini 原生协议可使用相同请求体。

怎样判断第一次请求成功

检查 HTTP 状态、响应中的实际内容与用量记录。先发送很短的非敏感文本，再逐步测试流式、工具调用等已明确支持的能力。本文核对模板及实现，没有替你发起计费调用，因此示例不附伪造的模型回复或成功账单。

按状态排查

401/403 先检查密钥、账户状态、分组权限和模型访问；400/404 检查请求 JSON、模型拼写、协议路径与重复的 /v1；429 查看额度、并发和频率限制。不要无限重试，也不要把所有 429 都理解成余额不足。结合错误消息确认具体原因。

管理与撤销密钥

为不同应用分开命名，避免在多人聊天、截图和仓库中传播完整 Key。泄露时撤销受影响密钥并更新应用配置。用量上涨后可按 Key 检查调用来源，参阅用量费用排查。充值、订阅和 Key 限额属于不同层次，修改其一不保证另一项也改变。

用已知答案复核第一次调用

已审核的型号详情页提供了一个小验收任务：要求模型返回 JSON，字段 total 等于 17 与 25 之和。这个任务将 HTTP 成功、协议结构正确、最终内容能解析和答案正确分开检查，便于识别“接口通了但结果不能用”的情况。

将非流式 Chat Completions 响应保存在本机 response.json 后，可在本地 Node.js 脚本中运行：

import { readFileSync } from 'node:fs';
const response = JSON.parse(readFileSync('response.json', 'utf8'));
const content = response.choices?.[0]?.message?.content;
if (typeof content !== 'string') throw new Error('Missing final text');
const result = JSON.parse(content);
if (result.total !== 42) throw new Error('Acceptance target failed');
console.log('Answer accepted; inspect actual usage and billing separately.');

检查读取最终 content，不读取思考文本，也不会自动修复额外的 Markdown 围栏。42 是已知数学目标，不是本站声称拿到的真实模型响应。这个例子不验证流式、工具调用、后端型号身份或整体智能；实际执行请求仍需权限、额度并会产生费用。

可从 Astra 的准确型号与请求模板或 Kimi K3 的接入边界继续。保留实际 usage 和费用，不能用验收通过代替账单核对。