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 | 固定 false | true / false 均可 |
| file(PDF 等)输入 | 仅 Pro 支持 | 三个规格均支持 |
| 单次请求上限 | 图片与视频合计 10 个 | 视频最多 10 个 |
用
type: "file"传视频会返回502+502003。视频请务必用视频 Part 传入。
4. 使用前须知
新建 Token 约需
1分钟同步到网关,创建后立即调用可能返回401001。国内站与国际站的 Token 不通用,每个应用最多
50个。Pro不支持纯文本请求,跑通最简调用请用Flash或Lite。