最佳实践

1. 对大型视频使用 URI 传送

对于大于 4MB 的视频（通常为 720P 以上），建议在 response_format 中设置：

{
  "response_format": {
    "delivery": "uri"
  }
}

这样可以避免 API 请求或响应的 Payload Size 限制。

2. 提示词（Prompt）准确性

为了获得更稳定、更符合预期的视频生成效果，建议遵循官方 Prompt 编写指南，并尽量：

明确描述主体、动作、场景和镜头。

指定风格、光照、镜头语言等细节。

避免模糊或存在歧义的描述。

限制（Limitations）

上传与编辑限制

图片

欧洲经济区（EEA）、瑞士和英国不支持上传和编辑包含未成年人的图片。

不支持上传和编辑包含某些可识别人物的图片。

视频

欧洲经济区（EEA）、瑞士和英国目前无法编辑用户上传的视频。

可以编辑由模型生成的视频。

音频限制

目前 API 不支持上传音频作为参考（Audio Reference）。

视频参考限制

虽然 API 支持传入 最长 3 秒 的视频参考，但模型当前版本尚不能正确处理该类参考，因此实际效果无法保证。

多视频推理限制

当前版本：

不支持跨多个视频进行引用或推理。

多视频 Prompt 可能导致：

模型性能下降；

输出结果异常；

生成质量降低。

不支持的视频能力

当前版本暂不支持：

视频扩展（Video Extension）

视频插帧（Frame Interpolation）

语音编辑（Speech Editing）

不支持预配吞吐量（Provisioned Throughput）

当前视频生成 API 不支持 Provisioned Throughput。

不支持的模型参数

当前视频模型不支持以下参数：

system instructions

temperature

top_p

stop sequences

negative prompt

如果需要表达负面约束，可直接写入普通 Prompt，例如：

Do not include rain.
Do not generate text.
Do not make the character smile.

不支持的视频来源

目前不支持直接使用 YouTube 视频 作为媒体输入。

技术详情（Technical Details）

SynthID 水印

所有生成的视频均包含 SynthID 数字水印。

特点：

对普通观看者不可见。

可通过程序检测。

可用于验证视频来源及真实性。

生成耗时

视频生成时间会受到以下因素影响：

视频时长

输出分辨率

当前 API 服务负载

一般而言：

时长越长，生成越慢；

分辨率越高，生成越慢；

服务负载越高，等待时间越长。

内容安全过滤

系统会对以下内容执行安全审核：

输入 Prompt

生成的视频（取决于所在地区）

违反平台使用政策的 Prompt 将被拦截，无法生成视频。

语言支持

目前语言支持情况如下：

语言	支持情况
English (EN)	✅ 完全支持
其他语言	⚠️ 未经过官方完整评估，通常可使用，但生成效果可能存在差异。

总结

分类	内容
大视频	推荐使用 `delivery="uri"`
性能优化	`background=false`、`stream=false`
Prompt	尽量详细、准确描述
音频参考	❌ 不支持
视频参考	最长支持 3 秒，但效果有限
多视频推理	❌ 不支持
视频扩展	❌ 不支持
视频插帧	❌ 不支持
语音编辑	❌ 不支持
YouTube 视频	❌ 不支持
温度/TopP/System	❌ 不支持
内容审核	✅ 自动执行
水印	✅ SynthID
英文	✅ 官方完全支持
其他语言	⚠️ 可用但未官方验证

omni视频生成 API 最佳实践与限制

最佳实践#

1. 对大型视频使用 URI 传送#

2. 提示词（Prompt）准确性#

限制（Limitations）#

上传与编辑限制#

图片#

视频#

音频限制#

视频参考限制#

多视频推理限制#

不支持的视频能力#

不支持预配吞吐量（Provisioned Throughput）#

不支持的模型参数#

不支持的视频来源#

技术详情（Technical Details）#

SynthID 水印#

生成耗时#

内容安全过滤#

语言支持#

总结#