メインコンテンツへスキップ
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": "viduq3",
    "prompt": "Santa Claus and the bear hug by the lakeside",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "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",
    "prompt": "Santa Claus and the bear hug by the lakeside",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "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-mix - 総合画質王、スマート転場がより強力、1秒ショート動画対応
  • viduq3 - デフォルト推奨、カメラ切り替えがよりスマート
選び方：日常使いは viduq3、画質重視や1-2秒のモーションエフェクトには viduq3-mix。
​
prompt
string
必須
テキストプロンプト、最大 5000 文字動作とカメラワークを記述し、外見は記述しないでください（外見は参照画像から決定されます）。例："Santa Claus and the bear hug by the lakeside"
​
image_urls
array<url>
必須
参照画像URLの配列、1-7枚公開アクセス可能な画像URL（http:// または https://）をサポート例：["https://example.com/santa.png", "https://example.com/bear.png"]
  • 枚数：1-7枚
  • サポート形式：PNG、JPEG、JPG、WebP
  • 最小サイズ：128×128
  • アスペクト比：1:4 〜 4:1 の範囲
  • 1枚あたりのサイズ：≤ 50MB
  • 公開アクセス可能なURLである必要があります
​
duration
integer
デフォルト:"5"
動画の長さ（秒）
  • viduq3-mix：1 から 16
  • viduq3：3 から 16
デフォルト：5
viduq3 は最低3秒、viduq3-mix は最低1秒をサポートしています。選択したモデルに応じて有効な長さを指定してください。
​
resolution
string
デフォルト:"720p"
動画の解像度
  • viduq3-mix：720p（デフォルト）/ 1080p
  • viduq3：540p / 720p（デフォルト）/ 1080p
viduq3-mix は 540p をサポートしていません。720p または 1080p を使用してください。
​
aspect_ratio
string
デフォルト:"16:9"
動画のアスペクト比オプション：
  • 16:9 - 横向き（デフォルト）
  • 9:16 - 縦向き
  • 4:3 - 従来型
  • 3:4 - 縦型従来型
  • 1:1 - 正方形
​
seed
integer
生成のランダム性を制御するランダムシード指定しない場合はランダムに生成されます。
同じパラメータで同じseed値を使用すると類似の結果が生成されますが、完全に同一であることは保証されません。

​
モデル比較

特徴viduq3viduq3-mix
推奨シーン日常使い、マルチアングルカメラ切り替え高画質、1-2秒モーションエフェクト
長さ範囲3-16秒1-16秒
解像度540p / 720p / 1080p720p / 1080p
参照画像数1-7枚1-7枚

​
レスポンス

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

​
使用シーン

​
シーン 1：viduq3 基本参照画像から動画

{
  "model": "viduq3",
  "prompt": "Santa Claus and the bear hug by the lakeside",
  "image_urls": [
    "https://example.com/santa.png",
    "https://example.com/bear.png"
  ]
}

​
シーン 2：viduq3-mix 高画質参照画像から動画

{
  "model": "viduq3-mix",
  "prompt": "A cyberpunk neon street with the cat from reference image walking by",
  "image_urls": [
    "https://example.com/cat-1.png",
    "https://example.com/cat-2.png",
    "https://example.com/cat-3.png"
  ],
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "seed": 42
}
タスク結果の照会動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータスの取得 エンドポイントで生成の進捗と結果を照会できます。