跳到内容

Vega VL 接入文档已更新 ​

更新时间

多模态理解模型 Vega VL 的 API 文档已全面补全。端点与模型 ID 均未变化,现有接入代码无需修改即可继续使用。

模型 ID定位
wand-vega-vl-1.0-lite成本优先 —— 短视频理解、海量图片分类
wand-vega-vl-1.0-flash均衡档 —— 数据打标、中等长度视频总结
wand-vega-vl-1.0-pro效果优先 —— 长视频理解、复杂理解任务

1. 新增内容 ​

章节说明
选择版本lite / flash / pro 三个规格的定位与适合场景
接入准备开通服务 → 创建 API Token(控制台或 CreateAigcApiToken)→ 调用,共 3 步
Key 级配置名称、模型白名单、IP 白名单、额度限制
快速开始OpenAI SDK 与 cURL(流式)的最简调用示例
返回字段 · usage响应字段表与 Token 计费明细
错误码 · 用量查询 · Token 管理HTTP 状态码与业务错误码、控制台 / 接口用量查询、Token 创建·删除·查询·更新接口

2. 请求规格补全 ​

  • 鉴权头:Authorization: Bearer {TOKEN} 与 x-api-key: {TOKEN} 二选一,并新增便于问题追踪的 X-Request-Id。
  • 请求参数:新增 reasoning_effort(none ~ xhigh)、max_completion_tokens、tools、tool_choice,以及 response_format 的 json_schema。
  • 媒体输入:音频可用 input_audio.data(Base64)+ format,文件可用 file.file_data(Base64)+ file.file_name 传入。

3. 口径修正 ​

项目原写法修正后
stream固定 falsetrue / false 均可
file(PDF 等)输入仅 Pro 支持三个规格均支持
单次请求上限图片与视频合计 10 个视频最多 10 个

用 type: "file" 传视频会返回 502 + 502003。视频请务必用视频 Part 传入。

4. 使用前须知 ​

  • 新建 Token 约需 1 分钟同步到网关,创建后立即调用可能返回 401001。

  • 国内站与国际站的 Token 不通用,每个应用最多 50 个。

  • Pro 不支持纯文本请求,跑通最简调用请用 Flash 或 Lite。

  • Vega VL API 文档

  • 接入准备

  • 错误码

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages