API
CLUB

Super Vega 视频

异步视频任务,使用 DMC 原生请求格式。按输出秒数、参考视频秒数和超额图片张数结算。

可用模型

选择模型,下方示例和参数会切换为该模型。

Super Vega 1.0-pro-mini

异步视频任务 · Vega · POST /super-vega/tasks

请求示例
curl -X POST 'https://code.exgravity.ai/super-vega/tasks' \
  -H "Authorization: Bearer $UIKA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "Super Vega 1.0-pro-mini",
  "Prompt": "一只橘猫坐在窗边,柔和的午后阳光,电影质感",
  "OutputConfig": {
    "Resolution": "720P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "AudioGeneration": "Disabled",
    "LogoAdd": "Disabled"
  }
}'

请求参数

字段说明
Prompt画面描述;注意字段名大小写。
OutputConfig.Resolution480P / 720P / 1080P / 2K / 4K
OutputConfig.Duration4–15 秒;-1 表示自动时长,按 15 秒预扣,完成后按实际秒数结算。
OutputConfig.AspectRatio21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
OutputConfig.AudioGeneration / LogoAddEnabled 或 Disabled,控制生成声音与水印。
FileInfos最多 9 张图片、3 段视频、3 段音频,合计不超过 12 项。音频必须配合图片或视频。前 5 张图片不收图片附加费。
ExtInfoJSON 字符串;AdditionalParameters 也是 JSON 字符串,可设置 omni_reference_task_type(auto / reference / edit / extend)与 return_last_frame。

参考素材

Category 可为 Image、Video、Audio;Usage 可为 Reference,图片还可用 FirstFrame、LastFrame。首尾帧模式不能混用 Reference。

带参考素材的请求
curl -X POST 'https://code.exgravity.ai/super-vega/tasks' \
  -H "Authorization: Bearer $UIKA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "Super Vega 1.0-pro-mini",
  "Prompt": "一只橘猫坐在窗边,柔和的午后阳光,电影质感",
  "OutputConfig": {
    "Resolution": "720P",
    "Duration": 5,
    "AspectRatio": "16:9",
    "AudioGeneration": "Disabled",
    "LogoAdd": "Disabled"
  },
  "FileInfos": [
    {
      "Type": "Url",
      "Category": "Image",
      "Usage": "Reference",
      "Url": "https://your-domain.example/reference.png"
    }
  ],
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"omni_reference_task_type\\\":\\\"reference\\\",\\\"return_last_frame\\\":true}\"}"
}'

提交结果与任务

提交成功后读取 TaskId,这是平台任务 ID。使用下面的统一任务查询接口获取状态与作品。

提交响应
{
  "TaskId": "task_xxx"
}

保存 TaskId,然后按「异步任务与作品」轮询状态并下载作品。

注意事项

真人素材请先在创作平台的 Vega 素材库完成认证与登记,再使用对应 asset:// 地址。站内素材管理使用登录会话接口,不属于此 API Key 接口。

视频编辑 edit 需参考视频、adaptive 画幅和 Duration=-1;视频延长 extend 需参考视频与 adaptive 画幅。