[{"data":1,"prerenderedAt":301},["ShallowReactive",2],{"navigation_docs_zh_cn":3,"-zh-cn-guide-getting-started":31,"-zh-cn-guide-getting-started-surround":298},[4,14],{"title":5,"path":6,"stem":7,"children":8,"page":13},"快速入门","/zh-cn/guide","zh-cn/guide",[9],{"title":10,"path":11,"stem":12},"API 调用快速教程","/zh-cn/guide/getting-started","zh-cn/guide/getting-started",false,{"title":15,"path":16,"stem":17,"children":18,"page":13},"条款与政策","/zh-cn/policies","zh-cn/policies",[19,23,27],{"title":20,"path":21,"stem":22},"隐私政策","/zh-cn/policies/privacy-policy","zh-cn/policies/privacy-policy",{"title":24,"path":25,"stem":26},"支持的国家和地区","/zh-cn/policies/supported-regions","zh-cn/policies/supported-regions",{"title":28,"path":29,"stem":30},"用户协议","/zh-cn/policies/user-agreement","zh-cn/policies/user-agreement",{"id":32,"title":10,"body":33,"description":291,"extension":292,"links":293,"meta":294,"navigation":295,"path":11,"seo":296,"stem":12,"__hash__":297},"docs_zh_cn/zh-cn/guide/getting-started.md",{"type":34,"value":35,"toc":283},"minimark",[36,40,45,48,51,71,75,78,92,95,99,107,115,118,121,127,233,237,251,264,268],[37,38,39],"p",{},"在控制台准备 API Key 和模型名称，使用自己的 API 客户端发送首个请求，再查看用量记录。本页提供请求与响应示例，不会发起 API 调用。",[41,42,44],"h2",{"id":43},"_1-准备调用条件","1. 准备调用条件",[37,46,47],{},"先准备可用的 API Key，确认模型名称及 Key 的分组、模型限制，再取得平台提供的 API 地址。",[49,50],"docs-getting-started-main-handoff",{},[52,53,55],"div",{"dataTestid":54},"docs-getting-started-setup-steps",[56,57,58,62,65,68],"ol",{},[59,60,61],"li",{},"进入 API Key 页面，创建或选择一个已启用的 Key。",[59,63,64],{},"在模型广场查看模型名称，并确认它在该 Key 的分组和模型限制范围内。",[59,66,67],{},"使用平台提供的 Base URL，在自己的 API 客户端中发送下方非流式请求。",[59,69,70],{},"请求结束后，在用量记录中按时间、状态、模型和 Key 后缀核对结果。",[41,72,74],{"id":73},"_2-从-api-客户端发出首次请求","2. 从 API 客户端发出首次请求",[37,76,77],{},"将示例中的 BASE_URL 替换为平台提供的 API 地址（包含 /v1），将 API_KEY 和 MODEL_ID 分别替换为你的 Key 和模型名称，同时去掉占位符两侧的尖括号。",[52,79,81],{"dataTestid":80},"docs-getting-started-request-example",[82,83,89],"pre",{"className":84,"code":86,"language":87,"meta":88},[85],"language-bash","curl --request POST '\u003CBASE_URL>/chat/completions' \\\n  --header 'Authorization: Bearer \u003CAPI_KEY>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n    \"model\": \"\u003CMODEL_ID>\",\n    \"messages\": [\n      { \"role\": \"user\", \"content\": \"Reply with a short connection confirmation.\" }\n    ],\n    \"stream\": false\n  }'\n","bash","",[90,91,86],"code",{"__ignoreMap":88},[37,93,94],{},"请在自己的客户端中替换示例值。不要把真实 Key 提交到代码仓库、发送到聊天或留在命令历史中。",[41,96,98],{"id":97},"_3-查看响应","3. 查看响应",[37,100,101,102,106],{},"成功调用必须同时满足 HTTP 200、响应可解析、object = chat.completion，并且 choices",[103,104,105],"span",{},"0",".message.content 存在。",[82,108,113],{"className":109,"code":111,"language":112,"meta":88},[110],"language-json","{\n  \"id\": \"\u003CCOMPLETION_ID>\",\n  \"object\": \"chat.completion\",\n  \"created\": 0,\n  \"model\": \"\u003CMODEL_ID>\",\n  \"choices\": [\n    {\n      \"index\": 0,\n      \"message\": { \"role\": \"assistant\", \"content\": \"\u003CMODEL_OUTPUT>\" },\n      \"finish_reason\": \"stop\"\n    }\n  ],\n  \"usage\": {\n    \"prompt_tokens\": 0,\n    \"completion_tokens\": 0,\n    \"total_tokens\": 0\n  }\n}\n","json",[90,114,111],{"__ignoreMap":88},[37,116,117],{},"以下 JSON 仅说明响应结构，实际结果以本次请求返回的 HTTP 状态和内容为准。",[37,119,120],{},"失败响应使用统一 OpenAI-compatible error envelope：",[82,122,125],{"className":123,"code":124,"language":112,"meta":88},[110],"{\n  \"error\": {\n    \"message\": \"\u003CUSER_VISIBLE_MESSAGE>\",\n    \"type\": \"\u003CERROR_TYPE>\",\n    \"param\": \"\u003CRELATED_PARAMETER_OR_NULL>\",\n    \"code\": \"\u003CERROR_CODE>\"\n  }\n}\n",[90,126,124],{"__ignoreMap":88},[52,128,133],{"ariaLabel":129,"className":130,"role":132},"HTTP 失败判断与下一步",[131],"docs-error-table","region",[134,135,136,152],"table",{},[137,138,139],"thead",{},[140,141,142,146,149],"tr",{},[143,144,145],"th",{},"HTTP 状态",[143,147,148],{},"当前判断",[143,150,151],{},"下一步",[153,154,155,167,178,189,200,211,222],"tbody",{},[140,156,157,161,164],{},[158,159,160],"td",{},"400",[158,162,163],{},"JSON、模型或请求字段不成立",[158,165,166],{},"核对请求体、模型名称与 error.param/code。",[140,168,169,172,175],{},[158,170,171],{},"401",[158,173,174],{},"Bearer 缺失、格式错误或 Key 不可用",[158,176,177],{},"检查 Authorization 请求头与 Key 状态，不要向支持人员发送 Key 明文。",[140,179,180,183,186],{},[158,181,182],{},"403",[158,184,185],{},"当前 Key 对模型、分组或来源无权",[158,187,188],{},"检查 API Key 的分组、模型限制和来源限制。",[140,190,191,194,197],{},[158,192,193],{},"429",[158,195,196],{},"额度、预算或限流拒绝",[158,198,199],{},"读取 error.code 和存在时的 Retry-After，停止无间隔重试。",[140,201,202,205,208],{},[158,203,204],{},"422",[158,206,207],{},"服务端判定请求无法处理",[158,209,210],{},"根据 error.message 和相关字段修正请求。",[140,212,213,216,219],{},[158,214,215],{},"503",[158,217,218],{},"服务当前不可用",[158,220,221],{},"保留发生时间和错误码，稍后重试或联系支持。",[140,223,224,227,230],{},[158,225,226],{},"无 HTTP 响应",[158,228,229],{},"请求结果未知",[158,231,232],{},"先到 Console 请求记录核对，禁止立即自动重放可能计费的请求。",[41,234,236],{"id":235},"_4-核对用量记录","4. 核对用量记录",[56,238,239,242,245,248],{},[59,240,241],{},"打开用量记录，选择覆盖本次调用时间的查询范围。",[59,243,244],{},"按时间、状态、模型和 Key 后缀查找对应记录，无需再次输入 Key 明文。",[59,246,247],{},"对照本次响应，核对记录中的状态、模型、Key 后缀和发生时间。",[59,249,250],{},"记录可能稍有延迟。请保留响应并手动刷新，不要因为列表暂时为空而立即重复发送请求。",[252,253,257,261],"u-alert",{"color":254,"icon":255,"variant":256},"warning","i-lucide-circle-pause","subtle",[258,259,260],"template",{"v-slot:title":88},"请求结果未知时，先查记录",[258,262,263],{"v-slot:description":88},"网络中断不代表请求没有执行。请先核对用量记录；记录服务暂不可用时，保留响应和发生时间，待恢复后再确认，避免重复计费。",[41,265,267],{"id":266},"保护-api-key","保护 API Key",[269,270,271,274,277,280],"ul",{},[59,272,273],{},"仅在自己的 API 客户端中使用 Key，本页不会读取或保存它。",[59,275,276],{},"不要将 Key 放入网址、公开页面或代码仓库。",[59,278,279],{},"分享截图、日志或排障信息前，移除 Key、Authorization、Cookie 等凭据信息。",[59,281,282],{},"若怀疑 Key 已泄露，及时在控制台停用或删除，并更新客户端使用的 Key。",{"title":88,"searchDepth":284,"depth":284,"links":285},2,[286,287,288,289,290],{"id":43,"depth":284,"text":44},{"id":73,"depth":284,"text":74},{"id":97,"depth":284,"text":98},{"id":235,"depth":284,"text":236},{"id":266,"depth":284,"text":267},"准备 API Key，发送首个请求，理解响应与错误，并核对用量记录。","md",null,{},{"title":10},{"title":10,"description":291},"Aj7s_1wvL9237P6S6LiS6H7mrVvRlf8KZfXA2veodKM",[293,299],{"title":20,"path":21,"stem":22,"description":300,"children":-1},"Code4AI 隐私政策。",1793218453021]