メインコンテンツへスキップ
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": "sora-2-pro",
    "url": "https://cdn.apimart.ai/modelDefaultUrl/Sora-2-pro.mp4",
    "timestamps": "1,3"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-pro",
    "url": "https://cdn.apimart.ai/modelDefaultUrl/Sora-2-pro.mp4",
    "timestamps": "1,3"
  }'

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

​
認証

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

​
Body

​
model
string
デフォルト:"sora-2-pro"
必須
動画生成モデル名対応モデル：
  • sora-2-pro - プロ版
例："sora-2-pro"
​
timestamps
string
必須
キャラクターが出現するタイムスタンプ範囲単位は秒、形式："開始秒,終了秒"⚠️ 制限：
  • 時間範囲の差は最小1秒
  • 時間範囲の差は最大3秒
例："1,3" は動画の1秒目から3秒目に出現するキャラクターを意味します
​
url
string
作成するキャラクターを含む動画URL⚠️ 要件：
  • 動画には音声が必要
  • 動画にはキャラクターが必要
💡 説明：
  • url と from_task のどちらか一方を設定する必要があります
例："https://upload.apimart.ai/f/video/..."
​
from_task
string
生成済みの動画タスクID既に生成されたタスクIDからキャラクターを作成できます💡 説明：
  • url と from_task のどちらか一方を設定する必要があります
  • このパラメータを使用すると、以前に生成した動画タスクからキャラクターを直接抽出できます
例："task_01KBYT59JDHB4A3KDDR9N9JVWP"

​
Response

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