PopNowAPI 文档
正文

Seedance 2.0 Mini API 调用参考

轻量版 Seedance,快速出 720p 带声小样

用一个 PopNow API 密钥,就能在自己的代码里调用 Seedance 2.0 Mini。下面列出要填的调用名、这个型号接受的每个输入字段、每次请求花多少积分,以及一段可以直接粘进终端运行的请求。

参数说明直接取自型号的输入 schema,暂时只有英文。

一览

出品方
ByteDance
产出
视频
起价
1.65 积分 每秒成片 ($0.0165)
一般耗时
约 96 秒

1 积分 = 0.01 美元。任务受理时先冻结可能的最高费用,完成后按实际用量结算、向上取整到整积分,多冻的退回;失败的任务不扣积分。想在运行前知道确切数字,先调 POST /api/v1/jobs/quote。

生成视频

bytedance/seedance-2.0-mini/text-to-video

价格

选项积分 (每秒成片)美元
generate_audio = false, resolution = 480p3.69$0.0369
generate_audio = true, resolution = 480p3.69$0.0369
generate_audio = false, resolution = 720p7.94$0.0794
generate_audio = true, resolution = 720p7.94$0.0794

参数

字段类型默认值取值范围作用
prompt必填string——Describe the intended subject, action, camera, light, sound, and constraints.
aspect_ratio可选stringadaptive16:9, 9:16, 4:3, 3:4, 1:1, 21:9, adaptiveOutput frame ratio.
resolution可选string720p480p, 720pOutput resolution.
duration_seconds可选integer5-1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Requested output duration in seconds. Pass -1 for smart duration: the model picks the length itself instead of a fixed number.
generate_audio可选booleantrue—Request synchronised output audio.
enable_web_search可选booleanfalse—Let the model search the web for information related to the prompt before rendering.
seed可选integer—0 到 2147483647Random seed. Omit to let the model pick one.
return_last_frame可选booleanfalse—Also return the clip’s final frame as a separate image.
bitrate_mode可选stringstandardstandard, highEncoding bitrate of the delivered file: standard, or high for crisper detail and a larger file.
watermark可选booleanfalse—Add the model’s visible "AI generated" watermark to the video.

请求示例

这段请求原样就能运行,没写的字段都用默认值。运行前先把密钥放进环境变量 POPNOW_API_KEY。

POST /api/v1/jobs/createTask
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedance-2.0-mini/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "generate_audio": true,
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果,或者在请求里加上 callBackUrl 等通知。

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

图生视频

bytedance/seedance-2.0-mini/image-to-video

价格

选项积分 (每秒成片)美元
generate_audio = false, resolution = 480p3.69$0.0369
generate_audio = true, resolution = 480p3.69$0.0369
enable_web_search = true, generate_audio = false, resolution = 480p5.4$0.054
enable_web_search = true, generate_audio = true, resolution = 480p5.4$0.054
generate_audio = false, resolution = 720p7.94$0.0794
generate_audio = true, resolution = 720p7.94$0.0794
enable_web_search = true, generate_audio = false, resolution = 720p10.8$0.108
enable_web_search = true, generate_audio = true, resolution = 720p10.8$0.108

参数

字段类型默认值取值范围作用
image_url必填string——A source image that you are authorised to process.
prompt可选string——Describe the intended subject, action, camera, light, sound, and constraints.
last_image_url可选string——Optional closing image for the chosen video workflow.
aspect_ratio可选stringadaptive16:9, 9:16, 4:3, 3:4, 1:1, 21:9, adaptiveOutput frame ratio.
resolution可选string720p480p, 720pOutput resolution.
duration_seconds可选integer5-1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Requested output duration in seconds. Pass -1 for smart duration: the model picks the length itself instead of a fixed number.
generate_audio可选booleantrue—Request synchronised output audio.
enable_web_search可选booleanfalse—Let the model search the web for information related to the prompt before rendering. Requests with it on are billed at the web-search rate.
seed可选integer—0 到 2147483647Random seed. Omit to let the model pick one.
return_last_frame可选booleanfalse—Also return the clip’s final frame as a separate image.
bitrate_mode可选stringstandardstandard, highEncoding bitrate of the delivered file: standard, or high for crisper detail and a larger file.
watermark可选booleanfalse—Add the model’s visible "AI generated" watermark to the video.

请求示例

这段请求原样就能运行,没写的字段都用默认值。运行前先把密钥放进环境变量 POPNOW_API_KEY。

示例里的 image_url 用的是 PopNow 的示例素材,换成你自己的公开 HTTPS 链接、上传文件或已保存的素材即可。

POST /api/v1/jobs/createTask
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedance-2.0-mini/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "enable_web_search": false,
    "generate_audio": true,
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果,或者在请求里加上 callBackUrl 等通知。

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

参考生视频

bytedance/seedance-2.0-mini/reference-to-video

价格

选项积分 (每秒成片)美元
generate_audio = false, resolution = 480p, with_video = true1.65$0.0165
generate_audio = true, resolution = 480p, with_video = true1.65$0.0165
generate_audio = false, resolution = 720p, with_video = true3.54$0.0354
generate_audio = true, resolution = 720p, with_video = true3.54$0.0354
generate_audio = false, resolution = 480p, with_video = false3.69$0.0369
generate_audio = true, resolution = 480p, with_video = false3.69$0.0369
enable_web_search = true, generate_audio = false, resolution = 480p, with_video = false5.4$0.054
enable_web_search = true, generate_audio = false, resolution = 480p, with_video = true5.4$0.054
enable_web_search = true, generate_audio = true, resolution = 480p, with_video = false5.4$0.054
enable_web_search = true, generate_audio = true, resolution = 480p, with_video = true5.4$0.054
generate_audio = false, resolution = 720p, with_video = false7.94$0.0794
generate_audio = true, resolution = 720p, with_video = false7.94$0.0794
enable_web_search = true, generate_audio = false, resolution = 720p, with_video = false10.8$0.108
enable_web_search = true, generate_audio = false, resolution = 720p, with_video = true10.8$0.108
enable_web_search = true, generate_audio = true, resolution = 720p, with_video = false10.8$0.108
enable_web_search = true, generate_audio = true, resolution = 720p, with_video = true10.8$0.108

参数

字段类型默认值取值范围作用
prompt必填string——Describe the intended subject, action, camera, light, sound, and constraints.
reference_image_urls可选array<string>—最多 9 项Authorised image references.
reference_video_urls可选array<string>—最多 3 项Authorised video references.
reference_audio_urls可选array<string>—最多 3 项Authorised audio references.
aspect_ratio可选stringadaptive16:9, 9:16, 4:3, 3:4, 1:1, 21:9, adaptiveOutput frame ratio.
resolution可选string720p480p, 720pOutput resolution.
duration_seconds可选integer5-1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Requested output duration in seconds. Pass -1 for smart duration: the model picks the length itself instead of a fixed number.
generate_audio可选booleantrue—Request synchronised output audio.
enable_web_search可选booleanfalse—Let the model search the web for information related to the prompt before rendering. Requests with it on are billed at the web-search rate.
seed可选integer—0 到 2147483647Random seed. Omit to let the model pick one.
return_last_frame可选booleanfalse—Also return the clip’s final frame as a separate image.
bitrate_mode可选stringstandardstandard, highEncoding bitrate of the delivered file: standard, or high for crisper detail and a larger file.
watermark可选booleanfalse—Add the model’s visible "AI generated" watermark to the video.

请求示例

这段请求原样就能运行,没写的字段都用默认值。运行前先把密钥放进环境变量 POPNOW_API_KEY。

示例里的 reference_image_urls 用的是 PopNow 的示例素材,换成你自己的公开 HTTPS 链接、上传文件或已保存的素材即可。

POST /api/v1/jobs/createTask
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedance-2.0-mini/reference-to-video",
  "input": {
    "prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "enable_web_search": false,
    "generate_audio": true,
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果,或者在请求里加上 callBackUrl 等通知。

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

视频续写

bytedance/seedance-2.0-mini/video-extend

价格

选项积分 (每秒成片)美元
generate_audio = false, resolution = 480p3.69$0.0369
generate_audio = true, resolution = 480p3.69$0.0369
enable_web_search = true, generate_audio = false, resolution = 480p5.4$0.054
enable_web_search = true, generate_audio = true, resolution = 480p5.4$0.054
generate_audio = false, resolution = 720p7.94$0.0794
generate_audio = true, resolution = 720p7.94$0.0794
enable_web_search = true, generate_audio = false, resolution = 720p10.8$0.108
enable_web_search = true, generate_audio = true, resolution = 720p10.8$0.108

参数

字段类型默认值取值范围作用
video_url必填string (uri)——The clip to continue: MP4, MOV or WebM, up to 60 seconds. Its final frame becomes the opening frame of the new segment, and the result is your clip with the new segment joined on.
prompt可选string——Describe what happens next: the action that follows, the camera move and the sound.
last_image_url可选string——Optional target end frame: the new segment lands on this picture.
resolution可选string720p480p, 720pResolution of the new segment; match your source clip.
duration_seconds可选integer5-1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Length of the new segment in seconds. The source clip is added on top and is not billed.
generate_audio可选booleantrue—Generate sound for the new segment. The source keeps its own sound either way.
enable_web_search可选booleanfalse—Let the model search the web for information related to the prompt before rendering. Requests with it on are billed at the web-search rate.
seed可选integer—0 到 2147483647Random seed. Omit to let the model pick one.
bitrate_mode可选stringstandardstandard, highEncoding bitrate of the new segment: standard, or high for crisper detail and a larger file.
watermark可选booleanfalse—Add the model’s visible "AI generated" watermark to the new segment.

请求示例

这段请求原样就能运行,没写的字段都用默认值。运行前先把密钥放进环境变量 POPNOW_API_KEY。

示例里的 video_url 用的是 PopNow 的示例素材,换成你自己的公开 HTTPS 链接、上传文件或已保存的素材即可。

POST /api/v1/jobs/createTask
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedance-2.0-mini/video-extend",
  "input": {
    "prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "enable_web_search": false,
    "generate_audio": true,
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果,或者在请求里加上 callBackUrl 等通知。

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

接下来

本页内容