用途:Seedance 是字节跳动的视频生成 API,用于文生视频、图生视频,以及基于角色/风格参考图、参考视频、参考音频的生成。
主要能力:提供两个模型,dreamina-seedance-2-0-260128(标准,最高 1080p)与 dreamina-seedance-2-0-fast-260128(快速,最高 720p),时长 4–15 秒或 -1(智能)。参数包括 resolution(480p/720p/1080p,默认 720p)、ratio(16:9、4:3、1:1、3:4、9:16、21:9、adaptive,默认 adaptive)、duration(默认 5)、generate_audio(默认 true)、seed(-1 为随机)、watermark(默认 false)、return_last_frame(默认 false)。图像角色支持 first_frame、last_frame、reference_image(最多 9 张)、reference_video(最多 3 个,仅 URL)、reference_audio(最多 3 段)。
使用方式:流程为异步——提交任务、获取任务 ID、轮询直到 succeeded、使用视频 URL。提交示例:curl -s -X POST "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks" --header "Authorization: Bearer $SEEDANCE_TOKEN" --header "Content-Type: application/json" -d @/tmp/seedance_request.json | jq -r '.id'。轮询:curl -s "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks/<task-id>" --header "Authorization: Bearer $SEEDANCE_TOKEN"。终态为 succeeded、failed、expired、cancelled。生成前建议准备关键帧预览并请用户确认,确认后再提交任务。
适用场景:需要以文本或图像驱动短视频生成的自动化流程。
限制:视频 URL 24 小时后过期,需及时下载;任务记录 7 天后删除;单账号限制 3 个并发任务与 180 RPM;图像输入支持公开 URL 或 Base64,视频输入仅支持 URL;仅支持 service_tier: "default"。故障排查可运行 okou doctor check-connector --env-name SEEDANCE_TOKEN 或 okou doctor check-connector --url https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks --method POST。