メインコンテンツへスキップ
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": "Omni-Flash-Ext",
    "prompt": "a girl is dancing happily in a sunny garden",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Omni-Flash-Ext",
    "prompt": "a girl is dancing happily in a sunny garden",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

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

​
認証

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

​
リクエストパラメータ

​
model
string
必須
動画生成モデル名。固定値は Omni-Flash-Ext です。
​
prompt
string
必須
動画内容の説明。シーン、人物、動作、環境、カメラワーク、映像スタイル、音声のヒントを詳しく記述することをおすすめします。例："a girl is dancing happily in a sunny garden"
​
duration
integer
デフォルト:"6"
動画時間。単位は秒です。対応値：4、6、8、10。
5 や 7 などの値を指定すると invalid_duration エラーが返されます。
参照動画をアップロードする場合、duration を指定する必要はありません。duration と video_urls は同時に指定できません。
​
resolution
string
デフォルト:"720p"
動画解像度。大文字と小文字は区別されません。対応値：
  • 720p
  • 1080p
  • 4k
その他の解像度を指定すると invalid_resolution エラーが返されます。
​
aspect_ratio
string
デフォルト:"16:9"
動画のアスペクト比。横向きまたは縦向きの出力を制御します。よく使う値：
  • 16:9 - 横向き
  • 9:16 - 縦向き
デフォルト：16:9
​
size
string
互換フィールドです。aspect_ratio と同じ意味です。両方を指定する場合は同じ値にしてください。
​
generation_type
string
生成タイプ。画像の使用方法を指定します。指定可能な値：
  • frame - 始点フレームモード。image_urls には画像を 1 枚のみアップロードでき、動画の始点フレームとして使用されます。
  • reference - 参照モード。image_urls には画像を 1 枚または 3 枚アップロードでき、参照画像として使用されます。
generation_type が frame の場合、image_urls は 1 枚のみ対応します。他の枚数を渡すと unsupported_image_count エラーが返されます。
​
image_urls
array<url>
参照画像 URL 配列。generation_type に応じて、省略、1 枚、または 3 枚を指定できます：
  • 省略または空配列：テキストから動画
  • 1 枚：単一画像から動画
  • 3 枚：参照画像融合（generation_type が reference の場合のみ対応）
generation_type との関係：
  • generation_type が frame：画像を 1 枚のみアップロードできます。
  • generation_type が reference：画像を 1 枚または 3 枚アップロードできます。
公開アクセス可能な画像 URL のみ対応しています。
2 枚画像による始点フレーム + 終点フレームのモードはサポートしていません。2 枚を渡すと unsupported_image_count エラーが返されます。4 枚以上は十分に検証されていないため推奨しません。
​
video_urls
array<url>
参照動画 URL 配列。省略、または 1 本の参照動画を指定できます。公開アクセス可能な HTTP/HTTPS 動画 URL のみ対応しています。image_urls と同時に指定できます。画像は人物や構図の参照として、動画は動きの参照として使用されます。
Omni-Flash-Ext は 0 または 1 本の参照動画のみ対応しています。2 本以上を渡すと unsupported_video_count エラーが返されます。
video_urls を指定する場合、duration を指定する必要はありません。video_urls と duration は同時に指定できません。

​
レスポンス

​
code
integer
レスポンスステータスコード。成功時は 200 です。
​
data
array
タスク配列を返します。

​
タスク結果の照会

動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータス取得 API を使用して進捗と結果を照会します。
cURL
curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01KS1H7ZYSJWH1N779S2FSHTKA \
  --header 'Authorization: Bearer <token>'
送信後 5-10 秒待ってから最初の照会を行い、その後は 5-10 秒ごとにポーリングすることをおすすめします。1 つのタスクは通常約 3-5 分で完了します。

​
成功結果の例

{
  "code": 200,
  "data": {
    "id": "task_01KS1H7ZYSJWH1N779S2FSHTKA",
    "status": "completed",
    "progress": 100,
    "created": 1779246294,
    "completed": 1779246534,
    "actual_time": 240,
    "estimated_time": 600,
    "cost": 0.4,
    "credits_cost": 4,
    "result": {
      "videos": [
        {
          "url": ["https://cdn.example.com/videos/abc.mp4"],
          "expires_at": 1779332760
        }
      ]
    }
  }
}

​
失敗結果の例

{
  "code": 200,
  "data": {
    "id": "task_01KS1H7ZYSJWH1N779S2FSHTKA",
    "status": "failed",
    "progress": 100,
    "created": 1779246294,
    "completed": 1779246534,
    "actual_time": 240,
    "estimated_time": 600,
    "cost": 0,
    "credits_cost": 0,
    "error": {
      "message": "invalid duration 7, must be one of 4/6/8/10",
      "code": "task_failed"
    }
  }
}

​
ユースケース

​
シナリオ 1：テキストから動画

{
  "model": "Omni-Flash-Ext",
  "prompt": "a beautiful sunset over the ocean with seagulls flying",
  "duration": 6,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

​
シナリオ 2：単一画像から動画

{
  "model": "Omni-Flash-Ext",
  "prompt": "make the character smile and slowly turn around, cinematic camera motion",
  "duration": 6,
  "resolution": "1080p",
  "aspect_ratio": "9:16",
  "image_urls": ["https://example.com/character.jpg"]
}

​
シナリオ 3：3 枚の参照画像融合

{
  "model": "Omni-Flash-Ext",
  "prompt": "a creative scene combining these elements with smooth camera motion",
  "duration": 10,
  "resolution": "1080p",
  "aspect_ratio": "9:16",
  "image_urls": [
    "https://example.com/scene.jpg",
    "https://example.com/character.jpg",
    "https://example.com/product.jpg"
  ]
}

​
シナリオ 4：4K ショート動画

{
  "model": "Omni-Flash-Ext",
  "prompt": "close-up of a hummingbird hovering in front of a red flower",
  "duration": 4,
  "resolution": "4k",
  "aspect_ratio": "16:9"
}

​
シナリオ 5：参照動画生成

{
  "model": "Omni-Flash-Ext",
  "prompt": "the same scene but at night with neon lights",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "video_urls": ["https://example.com/reference.mp4"]
}

​
エラーコード

HTTPエラータイプ意味対処方法
400invalid_request_errormodel が Omni-Flash-Ext ではない、prompt が空、または JSON 形式が不正ですリクエストボディを確認してください
400invalid_durationduration が 4、6、8、10 のいずれでもありません対応している動画時間に変更してください
400invalid_resolutionresolution が 720p、1080p、4k のいずれでもありません対応している解像度に変更してください
400unsupported_image_countimage_urls の枚数が未対応です。2 枚を渡した場合によく発生します0、1、または 3 枚の画像にしてください
400unsupported_video_countvideo_urls の本数が未対応です。2 本以上を渡した場合によく発生します0 または 1 本の参照動画にしてください
401authentication_errorToken が無効ですBearer Token を確認してください
402payment_required残高不足ですチャージしてから再試行してください
429rate_limit_errorレート制限に達しました同時実行数を下げるか、後で再試行してください
タスクが失敗した場合、タスクステータス API は data.error に失敗理由を返します。よくある原因には、上流の一時的なクォータ不足、コンテンツ審査不通過、上流タイムアウトがあります。