PopNowAPI ドキュメント
本文

Seedance 2.0 API リファレンス

映画的なクリップを最大4K、音声つきで

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

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

概要

開発元
ByteDance
出力
動画
最安
6.47 クレジット 出力 1 秒あたり ($0.0647)
目安の所要時間
約 300 秒
モデル ID

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

動画を作成

bytedance/seedance-2.0/text-to-video

料金

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

料金

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

料金

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

料金

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

次に読む

このページの内容

概要動画を作成画像から動画参照から動画動画を延長次に読む