高品質な動画アニメーションを生成して、画像を生き生きとさせます。

画像から動画へ

画像から動画へのエンドポイントは、テキストプロンプトに基づいて高品質な動画アニメーションを生成することで、静止画像を生き生きとさせます。

モデル名: image-to-video

ライフサイクル: experimental

処理時間: ~60秒～180秒

出力形式: MP4

配信方法: URL (ステータスポーリング経由)

クレジット: 動画あたり6～12 (長さによる)

リクエスト

ユニバーサルな /v1/run エンドポイントに画像とプロンプトを送信して動画を生成します。

POSThttps://fititon.app/api/v1/run

リクエスト例

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "image-to-video",
           "inputs": {
             "imageUrl": "https://example.com/product.jpg",
             "prompt": "Camera pans slowly around the model as she walks forward",
             "duration": 6,
             "aspectRatio": "9:16"
           }
         }'

レスポンス

動画の生成には数分かかるため、/v1/run エンドポイントは非同期ジョブ id とともに 200 OK ステータスを即座に返します。最終的なMP4 URLを取得するには、GET /v1/status/{id} を使用してステータスAPIをポーリングする必要があります。または、Webフックを設定して通知を自動的に受信することもできます。当社のWebフックディスパッチャーは厳格な15秒のタイムアウトを適用することにご注意ください。サーバーは15秒以内に 2xx ステータスコードでWebフックを承認する必要があります。そうしないと、失敗と見なされ、後で再試行されます。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

リクエストパラメータ

必須パラメータ

imageUrlRequiredstring

アニメーション化する入力画像。公開されているURLまたはBase64エンコードされた画像文字列を指定できます。

プロのヒント: 髪、布地、または葉がはっきりと見える画像は、最も自然な動きを生み出します。静的なフラットレイや製品のみの写真はうまくアニメーション化されません。人物やシーンを含む画像を使用してください。AIが動きのためのスペースを確保できるように、大きくトリミングされた画像は避けてください。

フォーマット要件 Base64文字列を送信する場合、標準のデータURIプレフィックス（例: data:image/jpeg;base64,...）を含める必要があります。

オプションパラメータ

promptstring

アニメーションをガイドするテキストによる説明。省略された場合、AIは画像のコンテキストから自然な動きを推測します。

durationinteger

生成される動画の長さ（秒単位）。サポートされる値: 4、6、8。 デフォルト: 6

aspectRatio'16:9' | '9:16'

出力動画のアスペクト比。 デフォルト: 9:16

generateAudioboolean

動画に付随する文脈に応じたAI音声を生成するかどうか。 デフォルト: true

ランタイムエラー

この機能のランタイムエラーは、エラー処理に記載されている共通のセットを使用します。処理中にエラーが発生した場合、status は "error" に更新され、error フィールドには具体的な失敗理由が含まれます。

クレジットコスト

開発者APIリクエストの場合、コストはリクエストされた動画の duration に完全に依存します。

計算式: コスト = DurationCredits

長さ	動画あたりのクレジット
4秒	6
6秒 (デフォルト)	9
8秒	12