Skip to main content
POST

授权

string
默认值:"Bearer ${YOUR_API_KEY}"
必填
使用 Bearer 方式发送的 Neural4D API 密钥。

请求体 application/json

不传素材时使用文生视频;仅传 frame_images 时使用首帧或首尾帧生视频;传入 input_references 时使用参考素材生视频。所选模型须支持对应模式。
enum<string>
必填
Seedance 2.0 模型。可选值:bytedance/seedance-2.0
string
必填
描述待生成视频的必填文本提示词。字符串长度:1 - 1000
boolean
默认值:true
是否为视频生成原生音频。
enum<string>
默认值:"720p"
可选值:480p720p1080p4K
enum<string>
默认值:"16:9"
可选值:1:116:99:164:33:4
enum<integer>
默认值:5
视频时长,单位为秒。可选值:456789101112131415
integer
默认值:1
创建的视频生成任务数量。取值范围:1 <= x <= 4
object[]
通过 file_idurl 传入的首帧和尾帧图片。支持 JPG、JPEG、PNG 和 WEBP,单张图片默认不超过 10 MiB。图片须通过内容审核。每个 frame_type 最多出现一次;传入 last_frame 时必须同时传入 first_frame提供此参数时数组长度为 1 - 2 个元素。每个元素必须且只能提供 file_idurl 中的一个。
object[]
通过 file_idurl 传入的图片、视频和音频参考素材。每个元素必须且只能提供一种来源,不同元素可以混用。音频必须搭配至少一张图片或一个视频,首尾帧图片也计入。提供此参数时数组长度为 1 - 12 个元素,同时受各媒体类型的数量限制。
  • 图片:每个请求最多 6 张(与 frame_images 合计);支持 JPG/JPEG、PNG、WEBP,单文件默认不超过 10 MiB,须通过内容审核。
  • 视频:每个请求最多 4 个;支持 MP4、MOV,单文件默认不超过 100 MiB。
  • 音频:每个请求最多 2 个;支持 MP3、WAV,单文件默认不超过 15 MiB。
同类参考素材保持传入顺序;帧图片按首帧、尾帧排序。

响应

请通过 error.code 区分错误原因,不要依赖错误消息文本。
已接受生成任务
string
必填
生成请求返回的批次任务 ID。示例:"normal-video-c50fe63e-699d-4d61-93f5-2099ab159d6d"
object[]
必填
本次请求创建的生成结果子项。数组长度:至少 1 个元素。
enum<string>
必填
本次提交的视频任务的当前状态。可选值:queuedprocessingsucceededfailed
integer<int64>
必填
批次任务创建时间的 Unix 时间戳,单位为秒。
enum<string>
必填
本次提交任务使用的视频生成模式。可选值:text_to_videofirst_frame_image_to_videofirst_last_frame_image_to_videoreference_to_video
enum<string>
必填
本次提交任务使用的视频生成模型。可选值:bytedance/seedance-2.0bytedance/seedance-2.0-fastgoogle/veo-3.1xai/grok-imagine
object
可用时返回本次提交任务扣除的总点数。