PopNowAPI 文档
正文

Seedance 2.0 API 调用参考

电影感视频,最高 4K,原生音频

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

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

一览

出品方
ByteDance
产出
视频
起价
6.47 积分 每秒成片 ($0.0647)
一般耗时
约 300 秒

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

生成视频

bytedance/seedance-2.0/text-to-video

价格

选项积分 (每秒成片)美元
generate_audio = false, resolution = 480p10.5$0.105
generate_audio = true, resolution = 480p10.5$0.105
enable_web_search = true, generate_audio = false, resolution = 480p17.1$0.171
enable_web_search = true, generate_audio = true, resolution = 480p17.1$0.171
generate_audio = false, resolution = 720p22.8$0.228
generate_audio = true, resolution = 720p22.8$0.228
enable_web_search = true, generate_audio = false, resolution = 720p36.9$0.369
enable_web_search = true, generate_audio = true, resolution = 720p36.9$0.369
generate_audio = false, resolution = 1080p56.1$0.561
generate_audio = true, resolution = 1080p56.1$0.561
enable_web_search = true, generate_audio = false, resolution = 1080p91.8$0.918
enable_web_search = true, generate_audio = true, resolution = 1080p91.8$0.918
generate_audio = false, resolution = 4k116.7$1.167
generate_audio = true, resolution = 4k116.7$1.167
enable_web_search = true, generate_audio = false, resolution = 4k187.2$1.872
enable_web_search = true, generate_audio = true, resolution = 4k187.2$1.872

参数

字段类型默认值取值范围作用
prompt必填string——What to generate: subject, action, camera movement and mood.
aspect_ratio可选stringadaptive21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptiveAspect ratio of the generated video.
resolution可选string720p480p, 720p, 1080p, 4kOutput resolution. Super-resolution tiers are not offered.
duration_seconds可选integer5-1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Clip length in seconds. This is the billed quantity. Pass -1 for smart duration: the model picks the length itself instead of a fixed number.
generate_audio可选booleantrue—Generate a native soundtrack synchronised to the picture.
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。

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/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",
    "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/image-to-video

价格

选项积分 (每秒成片)美元
generate_audio = false, resolution = 480p10.5$0.105
generate_audio = true, resolution = 480p10.5$0.105
generate_audio = false, resolution = 720p22.8$0.228
generate_audio = true, resolution = 720p22.8$0.228
generate_audio = false, resolution = 1080p56.1$0.561
generate_audio = true, resolution = 1080p56.1$0.561
generate_audio = false, resolution = 4k116.7$1.167
generate_audio = true, resolution = 4k116.7$1.167

参数

字段类型默认值取值范围作用
image_url必填string——URL of the image used as the first frame.
prompt可选string——What to generate: subject, action, camera movement and mood.
last_image_url可选string——URL of the image used as the closing frame. Only accepted together with image_url.
aspect_ratio可选stringadaptive21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptiveAspect ratio of the generated video.
resolution可选string720p480p, 720p, 1080p, 4kOutput resolution. Super-resolution tiers are not offered.
duration_seconds可选integer5-1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Clip length in seconds. This is the billed quantity. Pass -1 for smart duration: the model picks the length itself instead of a fixed number.
generate_audio可选booleantrue—Generate a native soundtrack synchronised to the picture.
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/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",
    "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/reference-to-video

价格

选项积分 (每秒成片)美元
generate_audio = false, resolution = 480p, with_video = true6.47$0.0647
generate_audio = true, resolution = 480p, with_video = true6.47$0.0647
generate_audio = false, resolution = 480p, with_video = false10.5$0.105
generate_audio = true, resolution = 480p, with_video = false10.5$0.105
generate_audio = false, resolution = 720p, with_video = true13.92$0.1392
generate_audio = true, resolution = 720p, with_video = true13.92$0.1392
generate_audio = false, resolution = 720p, with_video = false22.8$0.228
generate_audio = true, resolution = 720p, with_video = false22.8$0.228
generate_audio = false, resolution = 1080p, with_video = true34.26$0.3426
generate_audio = true, resolution = 1080p, with_video = true34.26$0.3426
generate_audio = false, resolution = 1080p, with_video = false56.1$0.561
generate_audio = true, resolution = 1080p, with_video = false56.1$0.561
generate_audio = false, resolution = 4k, with_video = false116.7$1.167
generate_audio = false, resolution = 4k, with_video = true116.7$1.167
generate_audio = true, resolution = 4k, with_video = false116.7$1.167
generate_audio = true, resolution = 4k, with_video = true116.7$1.167

参数

字段类型默认值取值范围作用
prompt必填string——What to generate: subject, action, camera movement and mood.
reference_image_urls可选array<string>—最多 9 项Reference image URLs (up to 9). Characters, style and scene composition are carried over from them.
reference_video_urls可选array<string>—最多 3 项Reference video URLs (total length 15 s or less, up to 3). Motion and pacing are carried over from them. Reference footage is billed on the same linear basis as clip length, so longer references cost more.
reference_audio_urls可选array<string>—最多 3 项Reference audio URLs (total length 15 s or less, up to 3). The generated soundtrack follows them.
aspect_ratio可选stringadaptive21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptiveAspect ratio of the generated video.
resolution可选string720p480p, 720p, 1080p, 4kOutput resolution. Super-resolution tiers are not offered.
duration_seconds可选integer5-1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15Clip length in seconds. This is the billed quantity. Pass -1 for smart duration: the model picks the length itself instead of a fixed number.
generate_audio可选booleantrue—Generate a native soundtrack synchronised to the picture.
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/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"
    ],
    "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/video-extend

价格

选项积分 (每秒成片)美元
generate_audio = false, resolution = 480p10.5$0.105
generate_audio = true, resolution = 480p10.5$0.105
generate_audio = false, resolution = 720p22.8$0.228
generate_audio = true, resolution = 720p22.8$0.228
generate_audio = false, resolution = 1080p56.1$0.561
generate_audio = true, resolution = 1080p56.1$0.561
generate_audio = false, resolution = 4k116.7$1.167
generate_audio = true, resolution = 4k116.7$1.167

参数

字段类型默认值取值范围作用
video_url必填string (uri)——The clip to continue: MP4, MOV or WebM, up to 60 seconds. Its last frame opens the new segment, and the result is your clip with the new segment joined on.
prompt可选string——What happens next: the action that follows, the camera move and the sound. Optional.
last_image_url可选string——Optional closing image: the new segment lands on this picture. Leave it out and the model decides how the shot ends.
resolution可选string720p480p, 720p, 1080p, 4kResolution 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. This is the billed quantity; the source clip is added on top and is not billed. Pass -1 for smart duration: the model picks the length itself.
generate_audio可选booleantrue—Generate a native soundtrack for the new segment. The source keeps its own sound either way.
seed可选integer—0 到 2147483647Random seed. Omit to let the model pick one.
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。

示例里的 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/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",
    "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"

接下来

本页内容