阿里云百炼调用总览

本文说明如何通过 AI Gateway 调用阿里云百炼模型。AI Gateway 对外暴露统一的网关地址、API Key、权限控制、路由和用量统计能力；用户不需要直接使用阿里云百炼的原始 Endpoint。

调用前请先在 API KEY 管理 中创建 API Key，并确认该 API Key 已授权调用目标模型。

一、基础地址

阿里云百炼模型在 AI Gateway 中主要使用两类地址。

类型Base URL / Endpoint适用场景
OpenAI 兼容 Base URL
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1
Chat Completions、Responses、文本 Embedding
OpenAI Chat Completions
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/chat/completions
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/chat/completions
Qwen、DeepSeek、GLM、Kimi、MiniMax 等文本/视觉理解模型
Responses API
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/responses
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/responses
支持 Responses 协议的模型
Anthropic Messages
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/messages
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/messages
接入点类型为 Anthropic 的模型
文本 Embedding
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/embeddings
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/embeddings
Qwen Text Embedding V4 等文本向量模型
Qwen3 VL Embedding
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v1/services/embeddings/multimodal-embedding/multimodal-embedding
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v1/services/embeddings/multimodal-embedding/multimodal-embedding
qwen3-vl-embedding
qwen3-vl-embedding
多模态向量模型
HappyHorse 视频生成
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v1/services/aigc/video-generation/video-synthesis
https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v1/services/aigc/video-generation/video-synthesis
happyhorse-1.0-t2v
happyhorse-1.0-t2v
、
happyhorse-1.0-i2v
happyhorse-1.0-i2v
、
happyhorse-1.0-r2v
happyhorse-1.0-r2v

注意：

  • 阿里云百炼文本模型、腾讯 TokenHub 文本模型等非火山文本模型使用 
    /gateway/v1/...
    /gateway/v1/...
    。
  • 不要把阿里云文本模型写成 
    /gateway/api/v1/chat/completions
    /gateway/api/v1/chat/completions
    。
  • HappyHorse 视频生成、Qwen3 VL Embedding 属于服务化接口，路径中包含 
    /gateway/api/v1/services/...
    /gateway/api/v1/services/...
    。
  • 火山引擎模型使用 
    /gateway/api/v3/...
    /gateway/api/v3/...
    ，不要与阿里云百炼路径混用。

二、鉴权方式

OpenAI 兼容接口使用 

Authorization: Bearer <API_KEY>
Authorization: Bearer <API_KEY>
。

Authorization: Bearer <API_KEY> Content-Type: application/json

Anthropic Messages 兼容接口建议使用 

x-api-key
x-api-key
。

x-api-key: <API_KEY> anthropic-version: 2023-06-01 Content-Type: application/json

其中 

<API_KEY>
<API_KEY>
是在 AI Gateway 的 API KEY 管理 页面创建的 Key，不是阿里云账号的 DashScope API Key。

三、模型与接口类型

模型类别支持模型示例推荐接口
Qwen 文本 / 推理模型
qwen3.7-max
qwen3.7-max
、
qwen3.6-max-preview
qwen3.6-max-preview
、
qwen3-max
qwen3-max
、
qwen3.6-plus
qwen3.6-plus
、
qwen3.5-plus
qwen3.5-plus
、
qwen3.6-flash
qwen3.6-flash
、
qwen3.5-flash
qwen3.5-flash
OpenAI Chat Completions；支持时也可使用 Responses
第三方文本模型
MiniMax/MiniMax-M2.7
MiniMax/MiniMax-M2.7
、
MiniMax-M2.5
MiniMax-M2.5
、
deepseek-r1
deepseek-r1
、
deepseek-v3.2
deepseek-v3.2
、
deepseek-v4-flash
deepseek-v4-flash
、
deepseek-v4-pro
deepseek-v4-pro
、
glm-4.7
glm-4.7
、
glm-5
glm-5
、
glm-5.1
glm-5.1
、
kimi-k2.5
kimi-k2.5
、
kimi-k2.6
kimi-k2.6
OpenAI Chat Completions
视觉理解模型支持图片输入的 Qwen 多模态模型OpenAI Chat Completions，
messages.content
messages.content
传入文本和图片
文本 EmbeddingQwen Text Embedding V4 等OpenAI Embeddings
多模态 Embedding
qwen3-vl-embedding
qwen3-vl-embedding
Qwen3 VL Embedding 服务化接口
视频生成
happyhorse-1.0-t2v
happyhorse-1.0-t2v
、
happyhorse-1.0-i2v
happyhorse-1.0-i2v
、
happyhorse-1.0-r2v
happyhorse-1.0-r2v
HappyHorse 视频生成服务化接口

模型名称以 模型广场 中详情页展示和示例代码为准。部分模型在接入点中可能带有命名空间，例如 

qwen/qwen3.7-max
qwen/qwen3.7-max
；复制示例时请保持完全一致。

四、通用调用步骤

  1. 进入 模型广场。
  2. 搜索目标模型，例如 
    qwen3.7-max
    qwen3.7-max
    或 
    happyhorse-1.0-t2v
    happyhorse-1.0-t2v
    。
  3. 进入模型详情页，确认接入点状态、服务提供商、计费方式和调用示例。
  4. 在 API KEY 管理 中创建或选择 API Key，并开启目标模型权限。
  5. 根据模型类型选择对应 Endpoint 和请求体。
  6. 发起请求后，在 用量统计 中查看调用量、Token、费用和错误情况。

五、环境变量示例

export AI_GATEWAY_OPENAI_BASE_URL="https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1" export AI_GATEWAY_SERVICE_BASE_URL="https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v1" export API_KEY="<your-api-key>"

后续示例默认使用以上环境变量。

六、最小可用示例

Chat Completions

curl -X POST "$AI_GATEWAY_OPENAI_BASE_URL/chat/completions" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen/qwen3.7-max", "messages": [ {"role": "user", "content": "请用一句话介绍 AI Gateway。"} ] }'

Embedding

curl -X POST "$AI_GATEWAY_OPENAI_BASE_URL/embeddings" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen/text-embedding-v4", "input": "AI Gateway 支持统一模型调用、路由和用量统计。", "encoding_format": "float" }'

HappyHorse 视频生成

curl -X POST "$AI_GATEWAY_SERVICE_BASE_URL/services/aigc/video-generation/video-synthesis" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -H "X-DashScope-Async: enable" \ -d '{ "model": "happyhorse-1.0-t2v", "input": { "prompt": "一段 5 秒产品演示视频，展示数据流进入 AI Gateway 并被统一路由。" }, "parameters": { "size": "1280*720" } }'

七、常见注意事项

  • Endpoint 地址可能因部署区域不同而不同，正式接入时以模型广场示例代码为准。
  • OpenAI 兼容接口、Anthropic Messages、DashScope 服务化接口的请求体结构不同，不能只替换模型名复用同一个请求体。
  • 多模态输入中的图片、视频、文件 URL 需要能被模型供应商访问；本地路径、内网地址、依赖浏览器登录态的地址通常不可用。
  • 结构化输出、工具调用、联网搜索、思考过程等高级能力并非所有模型都支持，请以模型详情页和本文各章节说明为准。
  • 如果请求失败，可在响应体中查看 
    code
    code
    、
    message
    message
    、
    request_id
    request_id
    等信息，并结合错误码文档和用量统计排查。
API调用参考
OpenAI兼容调用
Yunqi © 2024 Yunqi, Inc. All Rights Reserved.
联系我们
预约咨询
微信咨询
电话咨询
邮件咨询