LOLAI 开发者平台

火山引擎 · 视频生成(豆包 Seedance)

Seedance 文生视频 / 图生视频 / 首尾帧。异步任务——提交拿 task id → 轮询取结果。提交不扣费,任务成功才按时长计费。

生产环境POSThttps://api.lolai.lol/v1/videos

可用模型

豆包 Seedance 视频模型
doubao-seedance-2-0-260128文生视频可选
Seedance 2.0,画质最高。
示例:50 积分/秒
doubao-seedance-2-0-fast-260128文生视频可选
Seedance 2.0 fast,更快更省,推荐默认。
示例:30 积分/秒

更多见 模型广场(筛选视频),计费按时长(秒)× 模型单价。

两步式异步

  1. 提交:POST /v1/videos → 立即返回 { id, status:"submitted" },不扣费。
  2. 轮询:GET /v1/videos/{id},每几秒一次,直到 status 为 succeeded / failed(Seedance 5 秒片约 1~2 分钟出)。
成功首次命中时按时长 × 单价扣钱包(幂等,重复轮询不重复扣);失败 / 超时不扣。

提交参数

Body 参数application/json
modelstring必填
Seedance 模型,见上方可用模型。
示例:doubao-seedance-2-0-fast-260128
promptstring必填
画面描述,支持中文。
示例:一只橘猫在草地上奔跑
durationinteger可选
时长(秒)。取值受模型限制——Seedance 常见 5 / 10 秒,不支持的值上游会直接拒。
示例:5
resolutionstring可选
分辨率,如 720P / 1080P。
示例:720P
aspect_ratiostring可选
16:9 / 9:16 / 1:1。
示例:16:9
negative_promptstring可选
反向提示词,可选。
示例:模糊,畸变
seedinteger可选
随机种子,-1=随机。可选。
示例:-1

火山特性

  • 返回火山 TOS .mp4 临时链接(约 24 小时过期),需长期保存请收到后自行下载转存。
  • 按时长计费:成功才扣,5 秒片即 5 × 单价(2.0 = 50/秒、fast = 30/秒)。
  • 支持文生视频 / 图生视频 / 首尾帧:见下方「图生视频」。

图生视频 / 首尾帧

在提交体里加图片入参即转图生视频——直接传图片 url(火山去拉,不用上传文件),也接受 base64 data URI。

额外 Body 参数(图生视频)
imagestring | string[]可选
参考图,url 或 base64 data URI。单图=图生视频(以它为首帧让画面动起来);多图=参考素材合成。
示例:https://...png
first_framestring可选
首帧关键帧。配合 last_frame 做首尾帧补间(给头尾两张,中间自动生成)。
示例:https://...png
last_framestring可选
末帧关键帧。
示例:https://...png
图生视频 · curl
# 图生视频:image 传图片 url(或 base64 data URI),让它动起来
curl https://api.lolai.lol/v1/videos \
  -H "Authorization: Bearer sk-lolai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "猫站起来伸懒腰,镜头缓慢推近",
    "image": "https://your-cdn.com/cat.png",
    "duration": 5
  }'

# 首尾帧补间:给首帧 + 末帧,中间自动生成
#   "first_frame": "https://.../a.png",
#   "last_frame":  "https://.../b.png"

多模态参考(r2v) · Seedance 2.0

Seedance 2.0 支持图 / 视频 / 音频混合参考生成视频——参考一段视频的运镜风格、用一段音频做配乐 / 口型,都直接传 url。

额外 Body 参数(多模态参考)
reference_videostring | string[]可选
参考视频(url 或 data URI),最多 3 段——参考其运动 / 风格。
示例:https://...mp4
reference_audiostring | string[]可选
参考音频,最多 3 段。不能单独用,须搭配至少一张图或一段视频。
示例:https://...mp3
Seedance 2.0 多模态上限:图 9 + 视频 3 + 音频 3,最长 15 秒。image 多图也作参考素材(reference)。
多模态参考 · curl
# 多模态参考(Seedance 2.0):图 + 视频 + 音频一起参考
curl https://api.lolai.lol/v1/videos \
  -H "Authorization: Bearer sk-lolai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "参考这段视频的运镜,主角换成沙滩奔跑的狗",
    "image": ["https://.../dog.png"],
    "reference_video": ["https://.../style.mp4"],
    "reference_audio": ["https://.../bgm.mp3"],
    "duration": 5
  }'

查询任务

GET/v1/videos/{id}

返回当前 status(submitted / running / succeeded / failed);succeeded 时带 urls + duration_sec。终态会缓存,重复查不再打上游。

请求与响应体

用下面的示例确认请求格式与返回结构。需要在线发起请求时,点击页面顶部「调试」拉起在线运行面板。

① 提交
curl https://api.lolai.lol/v1/videos \
  -H "Authorization: Bearer sk-lolai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "一只橘猫在草地上奔跑,阳光,电影质感",
    "duration": 5,
    "resolution": "720P",
    "aspect_ratio": "16:9"
  }'
# → {"id":"<task-id>","status":"submitted"}
② 轮询
curl https://api.lolai.lol/v1/videos/<task-id> \
  -H "Authorization: Bearer sk-lolai-xxx"

# running   → {"id":"...","status":"running"}
# succeeded → {"id":"...","status":"succeeded",
#              "urls":["https://...volces.com/....mp4?..."],
#              "duration_sec":5}