YoYAI

主题

Omni 视频生成 API 对接说明 ​

YoYAI 套餐明细（企业商业合作请联系邮箱：support@yoy-ai.com） ​

套餐等级积分总量优惠价格 (税前)税后价格 (加5.3%)折扣力度
基础版100¥98.0¥1039.8折
白银版540¥520.0¥5489.629折
黄金版1,120¥1050.0¥1,1069.375折
铂金版6,000¥5,450.00¥5,7399.083折
钻石版13,000¥11,400.00¥12,0048.769折
尊享版25,200¥21,550.00¥22,6928.551折
旗舰版68,000¥55,800.00¥58,7578.206折
至尊版143,000¥114,400.00¥120,4638.0折

注：只有开具 6% 增值税普通发票或专用发票时，才需按照“税后价格”进行结算。

积分消耗说明 ​

分辨率 (resolution)时长 (duration)模型类别 (model)消耗积分
720p/1080p4omni-flash2.24
720p/1080p6omni-flash2.63
720p/1080p8omni-flash3.1
720p/1080p10omni-flash3.5
其他未明确指定的 时长//3.1

基本使用 ​

想些什么视频，可以任意输入一段文字，比如我想生成一个关于猫的视频，就可以输入 一只可爱的猫在游泳，下面使用apifox进行发送请求，具体的参数如下所示：

json
{
    "prompt": "一只可爱的猫在游泳",
    "duration": 8,
    "model": "omni-flash",
    "aspect_ratio": "16:9"
}

传入参数的字段说明如下：

  • prompt：生成视频的提示词。
  • duration：生成视频的时长，主要支持4、6、8、10，默认是8。
  • resolution：生成视频的提示词。
  • aspect_ratio：生成视频的尺寸。
  • model：视频模型的类别，主要包含了omni-flash、,默认是omni-flash。
  • image_urls：当视频任务是图生视频时，该值是必填参数，它是首尾帧的图片链接数组。
  • video_urls：在生成视频时可以根据参考视频来进行生成，最多支持一个参考视频。

可以点击测试按钮直接测试 API，稍等 1-2 分钟，结果如下：

json
{
    "success": true,
    "task_id": "321df50e-5e34-416f-b0c3-dea99a70ab46",
    "trace_id": "d1770e1d-1d86-4fe0-938b-6db80ef8eb56",
    "data": [
        {
            "id": "b8b75e10-8554-4f9f-b27c-a12575d13831",
            "video_url": "https://cdn.sunohub.cn/suno/321df50e-5e34-416f-b0c3-dea99a70ab46.mp4",
            "state": "succeeded"
        }
    ]
}

可以看到这时候我们就得到了两首歌的内容，包括标题、预览图、歌词、音频、视频等内容。

字段说明如下：

  • success：生成是否成功，如果成功则为 true，否则为 false
  • data：是一个列表，包含了生成的视频的详细信息。
    • state： 视频生成状态，主要包含四种，具体的如下：
      • succeeded：生成成功
      • running：执行中
      • error：失败
    • id：视频 ID
    • video_url：视频的视频文件，打开就是一个 mp4 视频。

图生视频任务 ​

如果想自定义首尾帧图片来生成视频，可以输入以下参数：

json
{
    "prompt": "Glittering highlights dance on waves as the camera performs a subtle zoom-in and slow tilt across the bokeh.",
    "model": "omni-flash",
    "aspect_ratio": "16:9",
    "duration": 8,
    "image_urls": [
        "https://cos.yoy-ai.com/ugu6y8.png"
    ]
}

最后发送请求，可以发现会得到一个结果，如下：

json
{
    "success": true,
    "task_id": "421a1b23-45f1-4c72-b9cb-a0ed46cec12a",
    "trace_id": "78744513-8f3d-4d51-b7b1-b9962ff1e8bb",
    "data": [
        {
            "id": "a28265e3-1204-4456-a415-183f8db39e03",
            "video_url": "https://cdn.sunohub.cn/suno/421a1b23-45f1-4c72-b9cb-a0ed46cec12a.mp4",
            "state": "succeeded"
        }
    ]
}

异步回调 ​

由于 Veo3 生成视频的时间相对较长，大约需要 1-2 分钟，如果 API 长时间无响应，HTTP 请求会一直保持连接，导致额外的系统资源消耗，所以本 API 也提供了异步回调的支持。

整体流程是：客户端发起请求的时候，额外指定一个 callback_url 字段，客户端发起 API 请求之后，API 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 ID。当任务完成之后，生成音乐的结果会通过 POST JSON 的形式发送到客户端指定的 callback_url，其中也包括了 task_id 字段，这样任务结果就可以通过 ID 关联起来了。

下面我们通过示例来了解下具体怎样操作。

首先，Webhook 回调是一个可以接收 HTTP 请求的服务，开发者应该替换为自己搭建的 HTTP 服务器的 URL。此处为了方便演示，使用一个公开的 Webhook 样例网站 https://webhook.site/，打开该网站即可得到一个 Webhook URL，如图所示：

将此 URL 复制下来，就可以作为 Webhook 来使用，此处的样例为 https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2。

接下来，我们可以设置字段 callback_url 为上述 Webhook URL，同时填入 prompt，如图所示：

点击运行，可以发现会立即得到一个结果，如下：

{
  "task_id": "446344aa-b990-44bf-a136-366ba7937496"
}

稍等片刻，我们可以在 https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2 上观察到生成歌曲的结果，如图所示：

内容如下：

json
{
    "success": true,
    "task_id": "446344aa-b990-44bf-a136-366ba7937496",
    "trace_id": "7624d3c8-a0ee-4f5a-a1a7-a714c630ab21",
    "data": [
        {
            "id": "234c26e3118c40e0aa1782fc9b21e6b2",
            "video_url": "https://mountsea.oss-cn-hongkong.aliyuncs.com/veo3_videos/20250721_184004_234c26e3118c40e0aa1782fc9b21e6b2_standard.mp4",
            "created_at": "2025-07-21 10:38:38",
            "complete_at": "2025-07-21 10:39:58",
            "state": "succeeded"
        }
    ]
}

可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。

客服二维码扫码添加客服