メインコンテンツへスキップ
POST
https://api.apimart.ai
/
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": "viduq3-pro",
    "prompt": "猫がピアノを弾いている、カメラがゆっくりズームイン",
    "duration": 8,
    "resolution": "1080p",
    "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": "viduq3-pro",
    "prompt": "猫がピアノを弾いている、カメラがゆっくりズームイン",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

​
認証

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

​
リクエストパラメータ

​
model
string
必須
動画生成モデル名サポートされているモデル：
  • viduq3-pro - Vidu Q3 Pro（推奨）
​
prompt
string
必須
テキストプロンプト、最大 2000 文字テキストから動画では必須。画像から動画および先頭・末尾フレームモードでは任意。例："猫がピアノを弾いている、カメラがゆっくりズームイン"
​
duration
integer
デフォルト:"5"
動画の長さ（秒）範囲：1 から 16デフォルト：5
​
resolution
string
デフォルト:"720p"
動画の解像度オプション：
  • 540p - 標準画質
  • 720p - HD（デフォルト）
  • 1080p - フルHD
デフォルト：720p
​
aspect_ratio
string
動画のアスペクト比（テキストから動画モードのみ）オプション：
  • 16:9 - 横向き
  • 9:16 - 縦向き
  • 4:3 - 従来型
  • 3:4 - 縦型従来型
  • 1:1 - 正方形
このパラメータはテキストから動画モード（image_urls を指定しない場合）でのみ使用できます。
​
image_urls
array<url>
画像から動画生成用の画像URL配列システムは画像の数に基づいて生成モードを自動判定します：
  • 0枚（未指定）：テキストから動画モード
  • 1枚：画像から動画モード（画像を開始フレームとして使用）
  • 2枚：先頭・末尾フレームモード（1枚目=先頭フレーム、2枚目=末尾フレーム）
例：["https://example.com/photo.jpg"]
  • 最大2枚まで
  • 先頭・末尾フレームモードでは正確に2枚の画像が必要です
  • image_urls を指定した場合（1枚でも2枚でも）、aspect_ratio パラメータは同時に使用できません。動画のアスペクト比は画像から自動的に決定されます
​
audio
boolean
デフォルト:"true"
音声を生成するかどうか（セリフ、効果音）デフォルト：true無音動画が必要な場合は false に設定してください。
​
seed
integer
再現可能な結果のためのランダムシード同じシードと同じパラメータを使用すると、同じ動画結果が生成されます。

​
自動ルーティング

システムは image_urls の画像数に基づいて生成モードを自動判定します：
画像数モード説明
0枚（未指定）テキストから動画テキスト記述のみから生成
1枚画像から動画画像を開始フレームとして使用
2枚先頭・末尾フレーム1枚目=先頭フレーム、2枚目=末尾フレーム

​
パラメータサポートマトリクス

パラメータテキストから動画画像から動画先頭・末尾フレーム
model✅ 必須✅ 必須✅ 必須
prompt✅ 必須任意任意
image_urls-✅ 1枚✅ 2枚
duration✅ 1-16秒✅ 1-16秒✅ 1-16秒
resolution✅✅✅
aspect_ratio✅--
audio✅✅✅
seed✅✅✅

​
レスポンス

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

​
使用シーン

​
シーン 1：テキストから動画

{
  "model": "viduq3-pro",
  "prompt": "猫がピアノを弾いている、カメラがゆっくりズームイン",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

​
シーン 2：画像から動画（1枚の画像）

{
  "model": "viduq3-pro",
  "prompt": "人物がゆっくり振り向いて微笑む",
  "image_urls": ["https://example.com/photo.jpg"],
  "duration": 5,
  "resolution": "720p"
}

​
シーン 3：先頭・末尾フレーム動画

{
  "model": "viduq3-pro",
  "prompt": "人物が立った状態からゆっくり座る",
  "image_urls": [
    "https://example.com/first.jpg",
    "https://example.com/last.jpg"
  ],
  "duration": 8
}

​
シーン 4：音声なし（無音動画）

{
  "model": "viduq3-pro",
  "prompt": "夕暮れの海景タイムラプス撮影",
  "duration": 10,
  "resolution": "1080p",
  "audio": false
}
タスク結果の照会動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータスの取得 エンドポイントで生成の進捗と結果を照会できます。