Developer Docs

素材与参数

参考图 / 视频 / 音频的统一写法,以及各系列模型在参数位置上的差异。

素材与参数

4.1 素材字段的统一写法(适用于全部模型)

统一使用扁平字段,所有模型通用:

curl -X POST 'https://newapi.nskeven.uk/v1/video/generations' \
  -H 'Authorization: Bearer sk-xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "even-sd2.5-A",
    "prompt": "按 @图1 的构图与 @视频1 的运镜,生成雨夜霓虹街道镜头",
    "seconds": "8",
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "images": ["https://your-cdn.com/ref-1.jpg"],
    "videos": ["https://your-cdn.com/ref-cam.mp4"],
    "audios": ["https://your-cdn.com/ref.mp3"]
  }'

两处例外(仅位置不同,字段名不变):

模型差异
豆包 Seedance
doubao-seedance-*
素材与分辨率、画幅全部写在 metadata.content,见 4.2
快线系列
sd-2-* / wan-3.0-*
images 用顶层;参考视频 / 音频须写在 metadata.videos / metadata.audios,见 4.3

@ 引用规则:even-sd2.0-A / even-sd2.5-A 带参考素材时,prompt 中须用 @图1、@视频1、@音频1 引用对应素材(编号从 1 开始,按数组顺序)。

A 系列省略 resolution 时默认 480p,请务必显式传入。


4.2 豆包 Seedance(doubao-seedance-*)

豆包模型的分辨率、画幅、素材须写在 metadata 内,顶层 resolution / aspect_ratio / images / videos / audios 不生效。

参数名位置类型必填说明
model顶层string必填模型名
prompt顶层string必填视频内容描述
seconds顶层string可选时长,不传默认 4 秒
metadata.resolutionmetadatastring必填分辨率
metadata.ratiometadatastring可选画幅,默认 16:9
metadata.contentmetadataarray可选参考素材数组
metadata.generate_audiometadatabool可选声音开关
metadata.watermarkmetadatabool可选水印开关
metadata.seedmetadatanumber可选随机种子

metadata.content 素材项:

type内容字段role
image_urlimage_url.urlreference_image / first_frame / last_frame
video_urlvideo_url.urlreference_video
audio_urlaudio_url.urlreference_audio
  • 素材 URL 支持公网 HTTP(S) 链接,或平台素材库地址 asset://ast-xxx
  • 首帧、尾帧各最多 1 张;使用首尾帧时图片总数不超过 2 张,且不可同时带参考视频
  • 素材请全部写在 metadata.content,不要同时再传顶层 images

示例:

curl -X POST 'https://newapi.nskeven.uk/v1/video/generations' \
  -H 'Authorization: Bearer sk-xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "参考图片中的人物,按参考视频的运镜生成街头镜头",
    "seconds": "8",
    "metadata": {
      "resolution": "720p",
      "ratio": "9:16",
      "content": [
        { "type": "image_url", "image_url": { "url": "https://your-cdn.com/ref-1.jpg" }, "role": "reference_image" },
        { "type": "video_url", "video_url": { "url": "https://your-cdn.com/ref.mp4" }, "role": "reference_video" }
      ]
    }
  }'

4.3 快线系列

适用模型:sd-2-E4 / sd-2-E5 / sd-2-E6 / sd-2-E8 / sd-2.5-E1 / wan-3.0-1080

参考图用顶层 images;参考视频 / 音频写在 metadata.videos / metadata.audios。

curl -X POST 'https://newapi.nskeven.uk/v1/video/generations' \
  -H 'Authorization: Bearer sk-xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "sd-2-E6",
    "prompt": "根据参考图与参考视频节奏生成同款镜头",
    "seconds": "8",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "images": ["https://your-cdn.com/ref-1.jpg"],
    "metadata": {
      "videos": ["https://your-cdn.com/ref.mp4"],
      "audios": ["https://your-cdn.com/ref.mp3"]
    }
  }'

该系列限制:参考图 ≤9、视频 ≤3、音频 ≤3;输入视频与输出视频时长合计不超过约 25 秒;参考图片分辨率建议 ≥300×300。