{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/emspw9nqc","result":{"data":{"markdownRemark":{"html":"

本文以「通过 API 网关专享版统一代理大模型服务」为例，介绍从创建实例到完成第一次模型调用的完整流程。

\n

前提条件

\n\n

步骤一：创建网关实例

\n
    \n
  1. 登录 API 网关专享版控制台，在左上角选择地域（如华北-北京）。
    2. \n
  2. 进入 实例管理 页面，单击 创建网关实例。
    3. \n
  3. \n

    按分步表单完成配置：

    \n\n
    4. \n
  4. 等待实例状态从「创建中」变为「运行中」，创建过程可能需要几分钟时间。
    5. \n
\n

详细参数说明参见创建实例。

\n

步骤二：创建后端

\n
    \n
  1. 在左侧导航选择目标实例，进入 后端管理，单击 创建后端。
    2. \n
  2. \n

    后端类型选择 AI 模型后端，配置：

    \n\n
    3. \n
  3. 提交创建。
    4. \n
\n

详细参数说明参见创建 AI 模型后端。

\n

步骤三：创建 Model 服务

\n
    \n
  1. 进入 服务管理 > Model 服务，单击创建。
    2. \n
  2. 填写服务名称，选择模型场景（如「文本生成」）与服务协议（如「OpenAI 兼容」）。
    3. \n
  3. 勾选需要开启的预置路由（如 POST /v1/chat/completions）。
    4. \n
  4. 按需绑定自定义域名后提交。
    5. \n
\n

详细参数说明参见创建 Model 服务。

\n

步骤四：创建 Model API 并发布

\n
    \n
  1. 进入 API 管理 > Model API，单击创建。
    2. \n
  2. 选择步骤三创建的 Model 服务。
    3. \n
  3. 选择路径，并配置匹配条件。
    4. \n
  4. \n

    配置后端策略：

    \n\n
    5. \n
  5. 按需开启 Fallback 兜底配置。
    6. \n
  6. 提交后 发布 API。
    7. \n
\n

详细参数说明参见创建 Model API。

\n

步骤五：创建消费者并授权（可选）

\n

如需对调用方进行身份认证与管控：

\n
    \n
  1. 进入 消费者管理，创建消费者，获取 API-KEY 或 AK/SK 凭证。
    2. \n
  2. 进入消费者详情的 授权管理，新增授权：选择实例 → 服务（服务级别授权）或具体 API（API 级别授权）。
    3. \n
\n

详细操作参见创建消费者与授权管理。

\n

步骤六：发起调用

\n

使用服务绑定的域名（或实例访问地址）发起请求，以 OpenAI 兼容协议为例：

\n\n
\n
\n
\n Bash\n \n
\n
\n 
1curl -X POST 'https://{网关访问地址}/v1/chat/completions' \\\n2  -H 'Content-Type: application/json' \\\n3  -H 'Authorization: Bearer {消费者API-KEY}' \\\n4  -d '{\n5    \"model\": \"your-model-name\",\n6    \"messages\": [{\"role\": \"user\", \"content\": \"你好\"}]\n7  }'
\n
\n
\n
\n \n

如使用 OpenAI 官方 SDK，可将 base_url 指向网关：

\n\n
\n
\n
\n Python\n \n
\n
\n 
1from openai import OpenAI\n2\n3client = OpenAI(\n4    base_url=\"https://{网关访问地址}/v1\",\n5    api_key=\"{消费者API-KEY}\"  # 网关侧消费者凭证，非模型供应商的真实 API-Key\n6)\n7resp = client.chat.completions.create(\n8    model=\"your-model-name\",\n9    messages=[{\"role\": \"user\", \"content\": \"你好\"}]\n10)\n11print(resp.choices[0].message.content)
\n
\n
\n
\n \n

请求正常返回模型响应，说明网关代理链路已打通。客户端全程只持有网关分发的消费者凭证，模型供应商的真实 API-Key 始终托管在网关侧。

\n

后续操作

\n","fields":{"slug":"emspw9nqc","title":"快速入门","date":"2026-08-28","extractedHeadings":[]},"headings":[{"value":"前提条件","depth":2},{"value":"步骤一：创建网关实例","depth":2},{"value":"步骤二：创建后端","depth":2},{"value":"步骤三：创建 Model 服务","depth":2},{"value":"步骤四：创建 Model API 并发布","depth":2},{"value":"步骤五：创建消费者并授权（可选）","depth":2},{"value":"步骤六：发起调用","depth":2},{"value":"后续操作","depth":2}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"emspw9nqc","prev":{"id":"Nmspw9ncj","name":"产品描述","path":"Nmspw9ncj","filePath":"API网关专享版/产品描述/使用限制.md","seo":null,"parentIds":["Omspw9n4x","emspw9n9t"],"parents":[{"id":"Omspw9n4x","documentId":"cbb7cda2-d4b2-4774-9c2f-c637554847d6","name":"API网关专享版","repoName":"APIGW","filePath":"API网关专享版","disabled":false,"path":"Omspw9n4x","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"emspw9n9t","documentId":"c0c14516-125c-422e-b7a5-c7776e460d08","name":"产品描述","repoName":"APIGW","filePath":"API网关专享版/产品描述","disabled":false,"path":"emspw9n9t","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"Fmspw9or4","name":"实例管理","path":"Fmspw9or4","filePath":"API网关专享版/操作指南/实例管理/创建实例.md","seo":null,"parentIds":["Omspw9n4x","nmspw9npq","4mspw9olj"],"parents":[{"id":"Omspw9n4x","documentId":"cbb7cda2-d4b2-4774-9c2f-c637554847d6","name":"API网关专享版","repoName":"APIGW","filePath":"API网关专享版","disabled":false,"path":"Omspw9n4x","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"nmspw9npq","documentId":"5488af8a-8e35-4ad7-a345-adda73980fdd","name":"操作指南","repoName":"APIGW","filePath":"API网关专享版/操作指南","disabled":false,"path":"nmspw9npq","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"4mspw9olj","documentId":"3776526f-043a-474a-8805-b3b8cc9ae2ac","name":"实例管理","repoName":"APIGW","filePath":"API网关专享版/操作指南/实例管理","disabled":false,"path":"4mspw9olj","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"Omspw9n4x","documentId":"cbb7cda2-d4b2-4774-9c2f-c637554847d6","name":"API网关专享版","repoName":"APIGW","filePath":"API网关专享版","disabled":false,"path":"Omspw9n4x","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"nmspw9npq","documentId":"5488af8a-8e35-4ad7-a345-adda73980fdd","name":"操作指南","repoName":"APIGW","filePath":"API网关专享版/操作指南","disabled":false,"path":"nmspw9npq","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}