Postman 适合调试 AIHub 标准推理和任务型接口。建议在接入 SDK 或开发工具前，先用 Postman 验证 Base URL、访问令牌和模型授权，确保基础配置正确。

前提条件

• 已获取当前环境的 AIHUB_BASE_URL、AIHUB_TOKEN 和 AIHUB_MODEL。

  变量	示例
  AIHUB_BASE_URL	https://ai.yunxinapi.com/hub
  AIHUB_TOKEN	sk-...
  AIHUB_MODEL	your-logical-model

• 可使用 Postman 桌面客户端或 Postman Web。

• 建议创建独立的 Collection 和 Environment，避免将测试密钥混入其他项目。

配置环境变量

在 Postman Environment 中创建以下变量：

textAIHUB_BASE_URL = https://ai.yunxinapi.com/hub
AIHUB_TOKEN = sk-...
AIHUB_MODEL = your-logical-model

在请求 Header 中配置：

httpAuthorization: Bearer {{AIHUB_TOKEN}}
Content-Type: application/json

调用 Chat Completions

请求 URL：

httpPOST {{AIHUB_BASE_URL}}/v1/chat/completions

请求 Body（JSON）：

json{
  "model": "{{AIHUB_MODEL}}",
  "messages": [
    {"role": "user", "content": "只回复 OK"}
  ],
  "stream": false
}

查询可用模型

请求 URL：

httpGET {{AIHUB_BASE_URL}}/v1/models

响应中的 data[].id 即为可用的模型名称，可填入 AIHUB_MODEL 变量。

调用 Vidu 任务

任务型多模态接口使用 Vidu 入口，例如：

httpPOST {{AIHUB_BASE_URL}}/vidu/v2/text2video

具体任务参数见 Vidu API。公网环境下，若 AIHUB_BASE_URL 已包含 /hub，不要再额外拼接 /hub。

常见问题

现象	排查方向
401/unauthorized	检查 Header 是否为 Authorization: Bearer {{AIHUB_TOKEN}}，且 Token 有效。
404	检查 URL 是否重复拼接 /hub，或缺少 /v1//vidu/v2 路径。
模型不可用	先调用 /v1/models，使用返回的模型名称。
流式响应不显示	Postman 对 SSE（Server-Sent Events）展示有限；建议改用 curl -N 或 SDK 进行验证。