Skip to main content
POST

授权

​
Authorization
string
header
默认值:${YOUR_API_KEY}
必填

使用 Bearer 方式发送的 Neural4D API 密钥。

请求体

application/json
​
model
enum<string>
必填

视频生成模型标识。参数默认值和可选值取决于所选模型。

可用选项:
bytedance/seedance-2.0
示例:

"bytedance/seedance-2.0"

​
prompt
string
必填

描述待生成视频内容的必填文本提示词。

Required string length: 1 - 1000
​
output_with_audio
boolean
默认值:true

是否随视频生成原生音频。

​
resolution
enum<string>
默认值:720p

所选视频模型允许的分辨率。

可用选项:
480p,
720p,
1080p,
4K
示例:

"720p"

​
aspect_ratio
enum<string>
默认值:16:9

所选视频模型允许的宽高比。

可用选项:
1:1,
16:9,
9:16,
4:3,
3:4
示例:

"16:9"

​
duration
enum<integer>
默认值:5

所选视频模型允许的时长，单位为秒。

可用选项:
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
必填范围: 4 <= x <= 15
​
n
integer
默认值:1

需要创建的视频生成任务数量。

必填范围: 1 <= x <= 4
​
frame_images
object[]

通过 POST /openapi/v1/files 上传的首帧和尾帧图片，支持 JPG、JPEG、PNG 和 WEBP 格式。每个 frame_type 最多出现一次，每项都必须提供 file_id。

Required array length: 1 - 2 elements
​
input_references
object[]

已上传的图片、视频和音频参考素材。图片支持 JPG、JPEG、PNG 和 WEBP，视频支持 MP4 和 MOV，音频支持 MP3 和 WAV。接口最多接受六张图片、四个视频和两个音频。单个音频时长为 2 至 15 秒且不超过 15 MB，所有音频总时长不超过 15 秒。音频必须与至少一个图片或视频同时使用。下游请求体不得超过 64 MB；大文件不要使用 Base64 编码。每项声明媒体类型，并且必须提供 file_id。

Required array length: 1 - 12 elements

一个带媒体类型的图片、视频或音频参考素材，使用文件上传接口返回的文件 ID。

响应

已接受生成任务

​
id
string
必填

生成请求返回的批次任务 ID。

示例:

"normal-video-c50fe63e-699d-4d61-93f5-2099ab159d6d"

​
data
object[]
必填

本次请求创建的生成结果子项。

Minimum array length: 1
​
status
enum<string>
必填

本次提交的视频任务的当前状态。

可用选项:
queued,
processing,
succeeded,
failed
​
created_at
integer<int64>
必填

批次任务创建时间的 Unix 时间戳，单位为秒。

​
mode
enum<string>
必填

本次提交任务使用的视频生成模式。

可用选项:
text_to_video,
first_frame_image_to_video,
first_last_frame_image_to_video,
reference_to_video
​
model
enum<string>
必填

本次提交任务使用的视频生成模型。

可用选项:
bytedance/seedance-2.0,
bytedance/seedance-2.0-fast,
google/veo-3.1,
xai/grok-imagine
​
usage
object

可用时返回本次提交任务扣除的总点数。