概述

网易云信大模型 API 平台（以下简称 AIHub）是统一的 AI Provider 接入网关。

AIHub API 以统一网关入口承接标准推理和任务型能力。调用方使用 AIHub 访问令牌鉴权，并使用 AIHub 模型名称请求模型。

对于业务研发来说，AIHub API 平台的目标是让应用只对接一次，即可在可控范围内使用多个模型与厂商能力。

快速开始

前置准备

• 在 云信控制台 开通大模型 API 能力，具体请参考 快速入门 进行开通。

• 获取 <AIHUB_SK>（API Key）。

• 从 模型列表 中选择模型 ID。

快速验证

cppexport AIHUB_SK="<AIHUB_SK>"

curl -X POST https://ai.yunxinapi.com/hub/v1/chat/completions \
  -H "Authorization: Bearer $AIHUB_SK" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      { "role": "user", "content": "只回复 OK" }
    ]
  }'

当调用成功时：

• HTTP 返回 200；
• 响应体为 OpenAI Chat Completions 结构；
• choices[0].message.content 中出现 OK 或模型回复。

Base URL

AIHUB_BASE_URL 是 AIHub 基础地址，该地址为完整地址前缀，不包含具体接口路径。

公网环境示例：

bashexport AIHUB_BASE_URL="https://ai.yunxinapi.com/hub"

常见接入路径：

接入方式	URL 示例
OpenAI-compatible	$AIHUB_BASE_URL/v1
Chat Completions	$AIHUB_BASE_URL/v1/chat/completions
Anthropic-compatible	$AIHUB_BASE_URL
Anthropic Messages	$AIHUB_BASE_URL/v1/messages
Responses	$AIHUB_BASE_URL/v1/responses
Vidu Tasks	$AIHUB_BASE_URL/vidu/v2

若 AIHUB_BASE_URL 已为 https://ai.yunxinapi.com/hub，后续只追加 /v1 或 /vidu/v2等路径即可，不要重复追加 /hub。

身份鉴权

AIHub 请求使用 Bearer Token 鉴权。AIHUB_TOKEN 是 AIHub API 密钥（即访问令牌），由控制台创建和管理：

bashAuthorization: Bearer $AIHUB_TOKEN

Header	推荐场景	说明
Authorization: Bearer	OpenAI SDK、Claude CodeANTHROPIC_AUTH_TOKEN、curl 示例	推荐方式；语义直接，兼容大多数标准客户端
x-api-key:	部分 Anthropic 客户端或内部网关适配	大模型 API 平台入站兼容；Claude Code 中可能触发自定义 API key 审批提示

访问令牌关联应用、访问组、模型授权、限流策略和用量归属。

模型名称

请求体中的 model 参数使用 AIHub 模型名称，该名称不一定等于上游真实模型名。可通过以下方式获取可用模型：

• 控制台：查看当前应用或访问令牌已授权的模型列表。
• API 查询：调用 GET https://ai.yunxinapi.com/hub/v1/models，响应中的 data[].id 即为可用的 model 参数值。

接口参考

模块	API	说明
Chat Completions	POST https://ai.yunxinapi.com/hub/v1/chat/completions	文本生成（OpenAI-compatible 协议）
Anthropic Messages	POST https://ai.yunxinapi.com/hub/v1/messages	文本生成（Anthropic Messages 协议）
Responses	POST https://ai.yunxinapi.com/hub/v1/responses	流式或非流式输出
	POST https://ai.yunxinapi.com/hub/v1/responses/compact	非流式输出
Images	POST https://ai.yunxinapi.com/hub/v1/images/generations	图片生成
	POST https://ai.yunxinapi.com/hub/v1/images/edits	图片编辑
Embeddings	POST https://ai.yunxinapi.com/hub/v1/embeddings	向量生成
Models	GET https://ai.yunxinapi.com/hub/v1/models	查询模型列表
	GET https://ai.yunxinapi.com/hub/v1/models/{model}	查询指定模型

Vidu

具体请参考 Vidu API。

兼容性

AIHub 尽量保持协议兼容，但实际可用字段取决于目标模型、渠道能力和上游协议。接入前先调用 https://ai.yunxinapi.com/hub/v1/models 验证当前访问令牌可见的模型列表，再发起最小请求进行测试。