はじめに
3D to Video は、ラフな 3D アニメーションを完成した見た目の映像に変えます。テキストから動画を作るモデルにカメラアングルを任せる代わりに、3D ツールで動きを決めてグレーでレンダリングし、あらかじめ仕上げた参考フレームを使って見た目を描き替えます。タイミングと構図を保ち、色、光、材質はそのフレームから引き継ぎます。
主な機能とハイライト
動きはレイアウトで決まります
歩く宇宙飛行士のおもちゃをカメラがゆっくり周回する 3 秒のクレイ動画は、3.0 秒、24 fps で返りました。一歩ごとの動きとカメラの弧はレイアウトどおりでした。出力の長さは常にレイアウトと等しく、最大 2 分まで対応します。
仕上げた 1 フレームで見た目を指定できます
レイアウトの最初のフレームを夕日の差す火星の平原に仕上げると、動画全体に赤い砂地、低い台地、暖かな輪郭光、長い影が描かれました。最後のフレームも整えて last_image_url に追加した 4 秒版では、最終フレームまで見た目が安定しました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
video_url | はい | レイアウトとして使う 3D シーンのグレーまたはクレイのレンダーです。最大 120 秒の MP4、WebM に対応し、24 fps が最適です。 1 文字以上 |
image_url | はい | 見た目の参考画像です。レイアウトの最初のフレームを画像モデルで仕上げ、色、光、材質、舞台を指定します。 1 文字以上 |
last_image_url | いいえ | 任意です。レイアウトの最後のフレームを同じスタイルに仕上げた画像です。 1 文字以上 |
prompt | はい | 参考画像と矛盾しないよう、完成映像を 1~2 文で説明します。クレイ、3D、レイアウトには言及しません。 1 文字以上 · 2000 文字以内 |
resolution | いいえ | 720p または 1080p(既定)です。レイアウトの縦横比を保ちます。 |
seed | いいえ | 結果を再現するための任意の整数シードです。料金は変わりません。 |
料金
レイアウト動画の長さを秒単位で切り上げ、最低 3 秒、最大 120 秒で課金します。1 秒あたりの料金は解像度で決まり、1080p は 720p より高くなります。最後の参考フレーム、prompt、seed で料金は変わりません。失敗した処理には課金されません。
| 仕様 | 料金 |
|---|---|
| $0.048 / 秒 |
| $0.12 / 秒 |
ユースケース
プリビズから企画提案の映像へ進めます
仮のモデルと実際に使いたいカメラワークで場面を組み、企画資料、絵コンテのレビュー、SNS のティザー向けに見た目を仕上げた動画へ変換します。アイデアが承認される前に、マテリアル、照明の仕組み、環境全体を作り込む必要がありません。
1 つの動きをさまざまな舞台で使えます
同じレイアウトのまま、参考画像と説明文だけを変えます。歩くキャラクターや回転する商品を、森、ネオンの夜景、手描き風のアニメ世界に置けます。どの版もタイミングが同じなので、つなぎ合わせて編集できます。
プロンプトガイドと実践のヒント
参考画像を丁寧に準備します
送信するレイアウトそのものから最初のフレームを取り出し、任意の画像モデルで見た目を整えます。ポーズ、構図、地平線の位置は保ちます。参考画像がレイアウトに近いほど輪郭がきれいになり、結果も安定します。未加工のグレーのフレームを送ると、出力もグレーのままになります。
プロンプトは短く、見えるものを説明します
完成後の場面を分かりやすい言葉で 1~2 文にします。例は "A small astronaut in a white spacesuit walks across a dusty red Martian plain at golden hour while the camera slowly circles." です。画面に見えるものを説明し、クレイ、グレーのモデル、3D、レイアウト自体には言及しません。
長いショットは分割を計画します
約 3 秒を超える場合は、レイアウトの最後のフレームも仕上げて last_image_url に渡します。2 分を超えるショットは分割が必要です。各部分を同じ参考画像と seed で個別に生成し、見た目を合わせます。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/3d-to-video-v1/video-edit",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "1080p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。