PopNowAPI ドキュメント
本文

Seedance 1.5 Pro API リファレンス

音声つきクリップ。カメラ固定も選べる

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

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

概要

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

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

動画を作成

bytedance/seedance-1.5-pro/text-to-video

料金

オプションクレジット (出力 1 秒あたり)米ドル
generate_audio = false, resolution = 480p1.68$0.0168
generate_audio = true, resolution = 480p3.35$0.0335
generate_audio = false, resolution = 720p3.41$0.0341
generate_audio = true, resolution = 720p6.81$0.0681
generate_audio = false, resolution = 1080p7.36$0.0736
generate_audio = true, resolution = 1080p14.73$0.1473

パラメーター

フィールド型既定値指定できる値説明
prompt必須string——What to generate: subject, action, camera movement and mood.
aspect_ratio任意string16:921:9, 16:9, 4:3, 1:1, 3:4, 9:16Aspect ratio of the generated video.
resolution任意string720p480p, 720p, 1080pOutput resolution. Super-resolution tiers are not offered.
duration_seconds任意integer54〜12Clip length in seconds. This is the billed quantity.
generate_audio任意booleantrue—Generate a native soundtrack synchronised to the picture.
camera_fixed任意booleanfalse—Lock the camera to produce a stable, fixed-position shot.
seed任意integer—0〜2147483647Random seed for controlled comparisons. Omit it to let each run pick its own.

リクエスト例

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

料金

オプションクレジット (出力 1 秒あたり)米ドル
generate_audio = false, resolution = 480p1.68$0.0168
generate_audio = true, resolution = 480p3.35$0.0335
generate_audio = false, resolution = 720p3.41$0.0341
generate_audio = true, resolution = 720p6.81$0.0681
generate_audio = false, resolution = 1080p7.36$0.0736
generate_audio = true, resolution = 1080p14.73$0.1473

パラメーター

フィールド型既定値指定できる値説明
prompt必須string——What to generate: subject, action, camera movement and mood.
image_url必須string——URL of the image used as the first frame.
last_image_url任意string——Optional closing frame the shot has to land on (480p and 720p).
aspect_ratio任意string16:921:9, 16:9, 4:3, 1:1, 3:4, 9:16Aspect ratio of the generated video.
resolution任意string720p480p, 720p, 1080pOutput resolution. Super-resolution tiers are not offered.
duration_seconds任意integer54〜12Clip length in seconds. This is the billed quantity.
generate_audio任意booleantrue—Generate a native soundtrack synchronised to the picture.
camera_fixed任意booleanfalse—Lock the camera to produce a stable, fixed-position shot.
seed任意integer—0〜2147483647Random seed for controlled comparisons. Omit it to let each run pick its own.

リクエスト例

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

料金

オプションクレジット (出力 1 秒あたり)米ドル
generate_audio = false, resolution = 480p1.68$0.0168
generate_audio = true, resolution = 480p3.35$0.0335
generate_audio = false, resolution = 720p3.41$0.0341
generate_audio = true, resolution = 720p6.81$0.0681
generate_audio = false, resolution = 1080p7.36$0.0736
generate_audio = true, resolution = 1080p14.73$0.1473

パラメーター

フィールド型既定値指定できる値説明
prompt必須string——Describe what happens next: the action that follows, the camera move and the sound. Required.
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.
last_image_url任意string——Optional target end frame: the new segment lands on this picture.
resolution任意string720p480p, 720p, 1080pResolution of the new segment; match your source clip.
duration_seconds任意integer54〜12Length 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.
camera_fixed任意booleanfalse—Lock the camera to produce a stable, fixed-position shot.
seed任意integer—0〜2147483647Random seed for controlled comparisons. Omit it to let each run pick its own.

リクエスト例

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

次に読む

このページの内容