メインコンテンツへスキップ
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": "grok-imagine-1.0-video-apimart",
    "prompt": "ビーチを走る犬、晴天、スローモーション",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-1.0-video-apimart",
    "prompt": "ビーチを走る犬、晴天、スローモーション",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

​
認証

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

​
Body

​
model
string
デフォルト:"grok-imagine-1.0-video-apimart"
必須
動画生成モデル名対応モデル：
  • grok-imagine-1.0-video-apimart - Grok 動画生成
例："grok-imagine-1.0-video-apimart"
​
prompt
string
必須
動画内容の説明、多言語対応
​
size
string
デフォルト:"16:9"
動画サイズオプション：
  • 16:9 - 横長（デフォルト）
  • 9:16 - 縦長
  • 1:1 - 正方形
  • 3:2 - 横長
  • 2:3 - 縦長
​
duration
integer
デフォルト:6
動画の長さ（秒）範囲：6〜30（最短6秒、最長30秒）⚠️ 注意： 純粋な数値を入力してください（例：6）。引用符を付けるとエラーが発生します
​
quality
string
デフォルト:"480p"
動画品質オプション：
  • 480p - 標準画質（デフォルト）
  • 720p - 高画質
​
image_urls
string[]
画像から動画生成用の参照画像URL配列。指定すると画像から動画モードになり、配列の最初の画像を参照として使用します。
参照画像をアップロードすると、アスペクト比は自動的に参照画像のアスペクト比に合わせられます。

​
Response

​
code
integer
レスポンスステータスコード
​
data
object
レスポンスデータオブジェクト
タスク結果の確認動画生成は非同期タスクです。送信後、id（すなわち task_id）が返されます。タスクステータス取得エンドポイントを使用して、生成の進捗と結果を確認してください。

​
使用シーン

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

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "ビーチを走る犬、晴天、スローモーション",
  "size": "16:9",
  "duration": 6
}

​
シーン 2：画像から動画生成

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "シーンに自然なダイナミック効果を追加する",
  "image_urls": ["https://example.com/start.png"],
  "size": "16:9",
  "duration": 10,
  "quality": "720p"
}