メインコンテンツへスキップ
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

認証

Authorization
string
必須
すべてのAPIエンドポイントでBearer Tokenによる認証が必要ですAPI Keyの取得:API Key管理ページにアクセスしてAPI Keyを取得してください使用時はリクエストヘッダーに追加:
Authorization: Bearer YOUR_API_KEY

リクエストボディ

model
string
必須
動画生成モデル名利用可能なモデル:
  • veo3.1-fast-official - Veo 3.1 公式高速版
  • veo3.1-quality-official - Veo 3.1 公式高品質版
prompt
string
必須
正のテキストプロンプトシーン、アクション、スタイルなどを詳細に記述すると、より良い生成結果が得られます。英語プロンプトの使用を推奨します。例:"a golden retriever running on the beach, sunset, cinematic"
negative_prompt
string
不要なコンテンツを除外するためのネガティブプロンプト例:"blurry, low quality, watermark, text"
duration
integer
デフォルト:"8"
動画の長さ(秒)推奨値:4 / 6 / 8デフォルト:8⚠️ 注意: 純粋な数値(例:8)を入力してください。引用符を付けるとエラーが発生します
aspect_ratio
string
デフォルト:"16:9"
動画のアスペクト比選択可能な値:
  • 16:9 - 横向き
  • 9:16 - 縦向き
デフォルト:16:9
resolution
string
デフォルト:"720p"
動画解像度選択可能な値:
  • 720p - 標準解像度
  • 1080p - 高解像度
  • 4K - 超高解像度
デフォルト:720p
first_frame_image
string
先頭フレーム画像URL、画像から動画生成に使用
  • 画像URLは公開アクセス可能で、ホットリンク保護がないものが必要です
  • 一時ダウンロードリンクではなく、オブジェクトストレージURLの使用を推奨します
last_frame_image
string
末尾フレーム画像URL、画像から動画生成に使用first_frame_image と組み合わせて、先頭・末尾フレームの制御を実現します
seed
integer
生成結果を再現するためのランダムシード値の範囲:0 - 4294967295
sample_count
integer
デフォルト:"1"
生成サンプル数 1-4、現在は 1 の使用を推奨デフォルト:1
generate_audio
boolean
デフォルト:"false"
音声トラックを生成するかどうか
person_generation
string
デフォルト:"allow_adult"
人物生成ポリシー選択可能な値:
  • allow_adult - 成人の人物/顔のみ生成を許可
  • disallow - 人物や顔の生成を許可しない
デフォルト:allow_adult
resize_mode
string
デフォルト:"pad"
画像リサイズ戦略(画像から動画生成時に有効)選択可能な値:
  • pad - パディングモード
  • crop - クロップモード
デフォルト:pad
enhance_prompt
boolean
デフォルト:"true"
上流プロンプト強化を有効にするかどうかデフォルト値:true
  • このパラメータは true のみ設定可能です。false に設定するとリクエストエラーが発生します
  • このパラメータが不要な場合は、送信しないでください

テキストから動画 vs 画像から動画

システムは画像パラメータの有無で自動的にモードを判定します:画像なしはテキストから動画、画像ありは画像から動画。
パラメータテキストから動画画像から動画
prompt✅ 必須✅ 必須
first_frame_image❌ 不要✅ 少なくとも1つ必要
last_frame_image❌ 不要✅ オプション(末尾フレーム)
negative_prompt✅ オプション✅ オプション
duration✅ オプション✅ オプション
aspect_ratio✅ オプション✅ オプション
resolution✅ オプション✅ オプション
seed✅ オプション✅ オプション
generate_audio✅ オプション✅ オプション
person_generation✅ オプション✅ オプション
resize_mode❌ 該当なし✅ オプション
enhance_prompt✅ オプション✅ オプション

レスポンス

code
integer
レスポンスステータスコード、成功時は 200
data
array
レスポンスデータ配列

使用シナリオ

シナリオ 1:テキストから動画(基本)

{
  "model": "veo3.1-fast-official",
  "prompt": "a golden retriever running on the beach, sunset, cinematic"
}

シナリオ 2:テキストから動画(全パラメータ)

{
  "model": "veo3.1-quality-official",
  "prompt": "a cinematic close-up of a ragdoll cat slowly walking through a sunlit living room",
  "negative_prompt": "blurry, low quality, watermark, text",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "seed": 12345,
  "generate_audio": true,
  "person_generation": "disallow",
  "enhance_prompt": true
}

シナリオ 3:画像から動画(先頭フレーム1枚)

{
  "model": "veo3.1-fast-official",
  "prompt": "the cat slowly walks forward and looks around",
  "first_frame_image": "https://example.com/cat.png",
  "duration": 8,
  "resolution": "720p"
}

シナリオ 4:画像から動画(先頭フレーム + 末尾フレーム)

{
  "model": "veo3.1-quality-official",
  "prompt": "smooth cinematic transition from the first frame to the last frame",
  "first_frame_image": "https://example.com/frame-start.png",
  "last_frame_image": "https://example.com/frame-end.png",
  "duration": 8,
  "resolution": "1080p"
}

シナリオ 5:音声付き動画の生成

{
  "model": "veo3.1-quality-official",
  "prompt": "a busy coffee shop with people chatting and barista making latte art",
  "duration": 8,
  "generate_audio": true,
  "aspect_ratio": "16:9"
}
タスク結果の照会動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータスの取得 エンドポイントを使用して、生成の進行状況と結果を照会してください。