メインコンテンツへスキップ
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": "wan2.6",
    "prompt": "草原を走るかわいい猫",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6",
    "prompt": "草原を走るかわいい猫",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

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

​
認証

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

​
リクエストパラメータ

​
model
string
必須
動画生成モデル名、wan2.6 に固定
​
prompt
string
必須
動画の内容説明テキストから動画モードでは必須。シーン、アクション、スタイルを詳細に記述してください例："日差しの中で伸びをするかわいい猫"
​
image_urls
array<url>
参照画像URL配列（1枚のみサポート）画像から動画モードでは必須。公開アクセス可能な画像URLをサポート例：["https://example.com/image.jpg"]
システムは image_urls の有無に基づいてテキストから動画または画像から動画モードを自動選択します
​
negative_prompt
string
ネガティブプロンプト、望まない内容を記述例："ぼやけ, 低品質, 歪み"
​
aspect_ratio
string
デフォルト:"16:9"
動画のアスペクト比オプション：
  • 16:9 - 横向き（デフォルト）
  • 9:16 - 縦向き
  • 1:1 - 正方形
  • 4:3 - 横向き
  • 3:4 - 縦向き
デフォルト：16:9
画像から動画モードではこのパラメータはサポートされていません
​
resolution
string
デフォルト:"720p"
動画解像度オプション：
  • 720p - 標準（デフォルト）
  • 1080p - 高解像度
デフォルト：720p
480p解像度はサポートされていません
秒単位で課金されます。解像度によって料金が異なります。具体的な料金はモデルマーケットプレイスをご参照ください
​
duration
integer
デフォルト:"5"
動画時間（秒）サポート値：5、10、15 秒のみデフォルト：5
​
seed
integer
再現可能な結果のためのランダムシード例：12345
​
prompt_extend
boolean
プロンプトを自動拡張するかどうか有効にすると、システムがプロンプトを自動的に最適化・充実させます
​
audio
boolean
オーディオを自動追加するかどうか有効にすると、システムが動画に合ったオーディオを生成します
​
audio_url
string
指定オーディオURLaudio パラメータより優先されます
オーディオの長さは動画の長さを超えることはできません。オーディオが動画より短い場合、動画の前半には音声がありますが、後半は無音になります。
​
shot_type
string
ショットタイプオプション：
  • single - シングルショット
  • multi - マルチショット
​
watermark
boolean
ウォーターマークを追加するかどうか
​
template
string
画像から動画への特殊効果モード用のエフェクトテンプレート名
エフェクトモード使用時：
  • 画像は1枚のみ必要（image_urlsで渡す）
  • プロンプトは不要（モデルはpromptフィールドを無視します）
汎用エフェクト：
  • squish - スクイッシュ
  • rotation - 回転
  • poke - つんつん
  • inflate - 風船膨張
  • dissolve - 分子拡散
  • melt - 熱波融解
  • icecream - アイスクリーム惑星
  • flying - マジック浮遊
シングルパーソンエフェクト：
  • carousel - タイムカルーセル
  • singleheart - ラブユー
  • dance1 - スウィングモーメント
  • dance2 - ダンスムーブ
その他のエフェクトについてはアリババ万相テンプレートドキュメントを参照してください

​
解像度とアスペクト比の組み合わせ

アスペクト比説明720p サイズ1080p サイズ
16:9横向き（デフォルト）1280×7201920×1080
9:16縦向き720×12801080×1920
1:1正方形960×9601440×1440
4:3横向き1088×8321632×1248
3:4縦向き832×10881248×1632

​
レスポンス

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

​
使用シナリオ

​
シナリオ 1：テキストから動画（シンプルリクエスト）

{
  "model": "wan2.6",
  "prompt": "日差しの中で伸びをするかわいい猫"
}

​
シナリオ 2：テキストから動画（全パラメータ）

{
  "model": "wan2.6",
  "prompt": "草原を走るかわいい猫",
  "negative_prompt": "ぼやけ, 低品質, 歪み",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "seed": 12345,
  "prompt_extend": true,
  "audio": true,
  "shot_type": "single",
  "watermark": false
}

​
シナリオ 3：画像から動画

{
  "model": "wan2.6",
  "prompt": "子猫が地面を走る",
  "image_urls": ["https://upload.apimart.ai/f/apimart-models-images/9998233432754770-c059992d-9b01-47d5-810d-ea0502ac9279-image_task_01KD7SSXDBCEWZ869D6PF249ZW_0.png"],
  "resolution": "1080p",
  "duration": 10
}

​
シナリオ 4：画像から動画（Base64画像）

{
  "model": "wan2.6",
  "prompt": "猫を立ち上がらせて歩かせる",
  "image_urls": ["data:image/png;base64,iVBORw0KGgo..."],
  "duration": 5
}

​
モード説明

​
テキストから動画 (Text-to-Video)

  • prompt パラメータが必須
  • image_urls パラメータは不要

​
画像から動画 (Image-to-Video)

  • image_urls パラメータが必須（1枚のみサポート）
  • prompt パラメータはオプション、期待するアクションを記述
システムはリクエストに image_urls が含まれているかどうかに基づいてモードを自動選択します
タスク結果のクエリ動画生成は非同期タスクで、送信時に task_id を返します。タスクステータス取得 エンドポイントを使用して生成の進行状況と結果をクエリしてください。