PopNowAPI ドキュメント
本文

Seedance 2.5 API リファレンス

ByteDance最新作。音声つきで最長30秒

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

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

概要

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

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

動画を作成

bytedance/seedance-2.5/text-to-video

料金

オプションクレジット (出力 1 秒あたり)米ドル
generate_audio = false, resolution = 480p18.51$0.1851
generate_audio = true, resolution = 480p18.51$0.1851
generate_audio = false, resolution = 720p41.6$0.416
generate_audio = true, resolution = 720p41.6$0.416
generate_audio = false, resolution = 1080p102.35$1.0235
generate_audio = true, resolution = 1080p102.35$1.0235

パラメーター

フィールド型既定値指定できる値説明
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, 1080pOutput resolution. Super-resolution tiers are not offered.
duration_seconds任意integer54, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, … (+13)Clip length in seconds. This is the billed quantity.
generate_audio任意booleantrue—Generate a native soundtrack synchronised to the picture.
output_format任意stringmp4mp4, movContainer of the returned video.
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.
watermark任意booleanfalse—Ask the model to watermark the video as AI-generated.

リクエスト例

このリクエストはそのまま実行できます。省略したフィールドには既定値が入ります。先にキーを環境変数 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.5/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.5/image-to-video

料金

オプションクレジット (出力 1 秒あたり)米ドル
generate_audio = false, resolution = 480p18.51$0.1851
generate_audio = true, resolution = 480p18.51$0.1851
generate_audio = false, resolution = 720p41.6$0.416
generate_audio = true, resolution = 720p41.6$0.416
generate_audio = false, resolution = 1080p102.35$1.0235
generate_audio = true, resolution = 1080p102.35$1.0235

パラメーター

フィールド型既定値指定できる値説明
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任意stringadaptiveadaptiveAspect ratio of the generated video. Seedance 2.5 frames an image-to-video clip on the first frame, so adaptive is the only accepted value.
resolution任意string720p480p, 720p, 1080pOutput resolution. Super-resolution tiers are not offered.
duration_seconds任意integer54, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, … (+13)Clip length in seconds. This is the billed quantity.
generate_audio任意booleantrue—Generate a native soundtrack synchronised to the picture.
output_format任意stringmp4mp4, movContainer of the returned video.
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.
watermark任意booleanfalse—Ask the model to watermark the video as AI-generated.

リクエスト例

このリクエストはそのまま実行できます。省略したフィールドには既定値が入ります。先にキーを環境変数 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.5/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.5/reference-to-video

料金

オプションクレジット (出力 1 秒あたり)米ドル
generate_audio = false, resolution = 480p, with_video = true11.07$0.1107
generate_audio = true, resolution = 480p, with_video = true11.07$0.1107
generate_audio = false, resolution = 480p, with_video = false18.51$0.1851
generate_audio = true, resolution = 480p, with_video = false18.51$0.1851
generate_audio = false, resolution = 720p, with_video = true24.89$0.2489
generate_audio = true, resolution = 720p, with_video = true24.89$0.2489
generate_audio = false, resolution = 720p, with_video = false41.6$0.416
generate_audio = true, resolution = 720p, with_video = false41.6$0.416
generate_audio = false, resolution = 1080p, with_video = true61.23$0.6123
generate_audio = true, resolution = 1080p, with_video = true61.23$0.6123
generate_audio = false, resolution = 1080p, with_video = false102.35$1.0235
generate_audio = true, resolution = 1080p, with_video = false102.35$1.0235

パラメーター

フィールド型既定値指定できる値説明
prompt必須string——What to generate: subject, action, camera movement and mood.
reference_image_urls任意array<string>—30 件までReference image URLs that carry over characters, style or scene composition. Up to 30 images. Cannot be combined with a first-frame image.
reference_video_urls任意array<string>—10 件までReference video URLs that carry over motion and pacing. Up to 10 clips, 2-30 seconds each and 30 seconds in total. Reference footage is added to the billed duration.
reference_audio_urls任意array<string>—10 件までReference audio URLs the generated soundtrack follows, for beat matching or lip sync. Up to 10 clips, 2-30 seconds each and 30 seconds in total.
aspect_ratio任意stringadaptive21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptiveAspect ratio of the generated video.
resolution任意string720p480p, 720p, 1080pOutput resolution. Super-resolution tiers are not offered.
duration_seconds任意integer54, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, … (+13)Clip length in seconds. This is the billed quantity.
generate_audio任意booleantrue—Generate a native soundtrack synchronised to the picture.
output_format任意stringmp4mp4, movContainer of the returned video.
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.
watermark任意booleanfalse—Ask the model to watermark the video as AI-generated.

リクエスト例

このリクエストはそのまま実行できます。省略したフィールドには既定値が入ります。先にキーを環境変数 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.5/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.5/video-extend

料金

オプションクレジット (出力 1 秒あたり)米ドル
generate_audio = false, resolution = 480p, with_video = true11.07$0.1107
generate_audio = true, resolution = 480p, with_video = true11.07$0.1107
generate_audio = false, resolution = 480p, with_video = false18.51$0.1851
generate_audio = true, resolution = 480p, with_video = false18.51$0.1851
generate_audio = false, resolution = 720p, with_video = true24.89$0.2489
generate_audio = true, resolution = 720p, with_video = true24.89$0.2489
generate_audio = false, resolution = 720p, with_video = false41.6$0.416
generate_audio = true, resolution = 720p, with_video = false41.6$0.416
generate_audio = false, resolution = 1080p, with_video = true61.23$0.6123
generate_audio = true, resolution = 1080p, with_video = true61.23$0.6123
generate_audio = false, resolution = 1080p, with_video = false102.35$1.0235
generate_audio = true, resolution = 1080p, with_video = false102.35$1.0235

パラメーター

フィールド型既定値指定できる値説明
prompt必須string——Required. Describe what happens next: the action that follows, the camera move and the sound.
video_url必須string (uri)——The clip to continue: MP4, MOV or WebM, 2 to 60 seconds. Its last 30 seconds at most become reference footage for the new segment and are billed as reference seconds; anything earlier is only joined back on.
resolution任意string720p480p, 720p, 1080pSize of the new segment. Match your source; it only sets the quality of the new segment.
duration_seconds任意integer54, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, … (+13)Length of the new segment in seconds. The reference seconds taken from your clip are billed on top.
generate_audio任意booleantrue—Generate sound for the new segment. The sound of your source is kept either way.
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.
watermark任意booleanfalse—Ask the model to watermark the new segment as AI-generated.

リクエスト例

このリクエストはそのまま実行できます。省略したフィールドには既定値が入ります。先にキーを環境変数 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.5/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"

次に読む

このページの内容