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"

接下來

本頁內容