PopNowAPI ドキュメント
本文

Seedance 2.0 Mini API リファレンス

軽量版Seedance。720pの音声つき試し出しに

PopNow の API キー 1 つで、Seedance 2.0 Mini を自分のコードから呼び出せます。送るモデル ID、受け付ける入力フィールド、1 回あたりのクレジット、ターミナルに貼ってそのまま動くリクエストをこのページにまとめました。

パラメーターの説明はモデルの入力 schema から取っているため、英語のみです。

概要

開発元
ByteDance
出力
動画
最安
1.65 クレジット 出力 1 秒あたり ($0.0165)
目安の所要時間
約 96 秒

1 クレジット = 0.01 米ドル。タスクの受付時に上限額を確保し、完了時に実際の使用量で精算します(整数クレジットに切り上げ、差額は返却)。失敗したタスクには課金されません。実行前に正確な金額を知りたいときは POST /api/v1/jobs/quote を呼んでください。

動画を作成

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

料金

オプションクレジット (出力 1 秒あたり)米ドル
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

料金

オプションクレジット (出力 1 秒あたり)米ドル
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

料金

オプションクレジット (出力 1 秒あたり)米ドル
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

料金

オプションクレジット (出力 1 秒あたり)米ドル
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"

次に読む

このページの内容