全部产品
Search
文档中心

SuperApp:如何调用统一API

更新时间:Apr 24, 2026

小程序集成对接方案为访问部署在平台上的模型提供一致的调用接口,请按照以下步骤开始 API 集成。

第一步:配置 API 密钥

在调用 API 之前,您需要创建并配置 API 密钥以完成身份验证。API 密钥可确保对已部署模型的安全访问,并用于追踪计费用量。

进入 Secrets 菜单

如需创建新的 API 密钥,请导航至平台界面左下角的「Secrets」菜单。

image

创建新的 API 密钥

创建新的 API 密钥以对 API 请求进行身份验证。通过配置密钥设置,管控对资源的访问权限。

image

名称:为 API 密钥输入一个描述性名称。不允许使用特殊字符(空格、#、?)。

访问范围

配置此 API 密钥可访问的资源范围:

部署:选择特定的已部署模型,或勾选「所有模型」以授予对所有部署的访问权限。

路由:选择路由提供商。如需添加更多提供商,请联系我们。

BYOK:选择特定的 BYOK 配置,或勾选「所有 BYOK」以授予对所有配置的访问权限。

用量限制

TPM(每分钟 Token 数):每分钟最大处理 Token 数(例如:60000)。

年度 Token 限额:每年允许使用的最大 Token 总量(例如:10000000)。

安全设置(可选)

IP 白名单:限制特定 IP 地址的访问权限。多个地址请以英文逗号分隔(例如:192.168.1.1, 10.0.0.0/8)。

有效期:为 API 密钥设置过期时间。

重要提示:请将您的 API 密钥妥善保存。出于安全考虑,切勿在公开环境或共享文档中暴露密钥信息。

第二步:查看代码示例

创建 API 密钥后,您可以访问现成的代码示例,了解如何与已部署的模型进行集成。这些示例包含完整的身份验证方式及 API 调用模式。

获取代码示例

代码示例可在每个已部署模型的详情页中查看。这些示例将展示如何使用您的 API 密钥发起请求。

image

部署详情中的代码示例区域,已集成 API 密钥

  1. 进入部署详情

前往「部署」页面,点击具体的部署项目以查看其详情。

  1. 找到代码示例区域

在部署详情页中找到「代码示例」区域。

  1. 复制并自定义

复制提供的代码示例,并将占位符 API 密钥替换为您的实际密钥。

示例代码结构

代码示例通常包含以下组成部分

from openai import OpenAI
client = OpenAI(
    api_key="<API_KEY>",
    base_url="https://rpgateway.console.alibabacloud.com/v1"
)
response = client.chat.completions.create(
    model="@sss/Qwen/Qwen3-0.6B-Base",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "how are you"}
    ],
    temperature=0.7,
    max_tokens=150
)
  • API 密钥:将 <API_KEY> 替换为您在 Secrets 中获取的实际 API 密钥

  • Base URL:所有 API 调用的统一接入端点

  • 模型:您的部署所对应的模型标识符

最佳实践

  • 妥善保管 API 密钥,切勿在客户端代码中暴露

  • 为 API 请求实现完善的错误处理机制

  • 持续监控 API 用量,优化成本与性能

  • 合理设置限流策略,避免超出 API 配额