メインコンテンツへスキップ
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": "sora-2",
    "prompt": "夕暮れの海岸に打ち寄せる波",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_urls": ["https://cdn.apimart.ai/doc/9998238782946594-f62f70ce-348c-4b13-bb5f-15f17bee676b-image_task_01K88BEGZHVJWJ3ZV6HY99SWQR_0.png"]
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "夕暮れの海岸に打ち寄せる波",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_urls": ["https://cdn.apimart.ai/doc/9998238782946594-f62f70ce-348c-4b13-bb5f-15f17bee676b-image_task_01K88BEGZHVJWJ3ZV6HY99SWQR_0.png"]
  }'

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

​
認証

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

​
ボディ

​
model
string
default:"sora-2"
required
動画生成モデル名サポートされているモデル：
  • sora-2 - 標準バージョン
  • sora-2-pro - プロフェッショナルバージョン、より長い時間をサポート
例："sora-2" または "sora-2-pro"
​
prompt
string
required
動画生成用のテキスト記述💡 @キャラクター参照機能：プロンプトで @username 形式を使用して、作成済みのキャラクターを参照し、生成される動画に含めることができます。例："猫と犬が一緒に車を運転している @duksvfkf.cruisingki @zdqwahgj.baronbarki"
​
duration
integer
動画の長さ（秒）
  • sora-2：10秒または15秒をサポート
  • sora-2-pro：15秒（HD）または25秒をサポート
例：10
​
aspect_ratio
string
動画の解像度対応フォーマット:
  • 16:9 (横向き)
  • 9:16 (縦向き)
​
image_urls
array
画像から動画生成のための参照画像URL配列💡 クイック入力（Try itエリア）：
  1. ”+ Add an item” をクリックして画像URLを追加
  2. 画像の完全なURLアドレスを入力
​
watermark
boolean
default:"false"
生成された動画にウォーターマークを追加するかどうか
  • false：ウォーターマークを追加しない
  • true：動画にSora公式ウォーターマークを追加
デフォルト: false
​
thumbnail
boolean
動画のサムネイルを生成するかどうか
  • true：プレビューと表示用の動画サムネイルを生成
サムネイルが不要な場合は、このパラメータを省略できます
​
private
boolean
default:"false"
プライバシーモードを有効にするかどうか
  • true：動画は公開されず、remix操作（再編集）もできません
  • false：動画を公開およびremixできます
デフォルト: false
​
style
string
動画のスタイルサポートされる値:
  • thanksgiving - 感謝祭スタイル
  • comic - コミックスタイル
  • news - ニューススタイル
  • selfie - セルフィースタイル
  • nostalgic - ノスタルジック/レトロスタイル
  • anime - アニメスタイル
例："anime"
​
storyboard
boolean
ストーリーボードを使用して動画生成の詳細をより細かく制御するかどうか
  • true：ストーリーボード機能を有効にする
  • false：ストーリーボードを使用しない
例：true
​
character_url
string
キャラクター抽出用の参照動画URL参照動画からキャラクターを抽出し、生成された動画で再利用します例："https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4"⚠️ 注意： このパラメータを使用すると、生成される動画の長さが1秒短くなります
​
character_timestamps
string
キャラクター出現タイムスタンプ参照動画内でキャラクターが出現する時間範囲を指定します。2秒のセグメントのみサポートフォーマット："開始秒,終了秒"例："1,3" は参照動画の1秒から3秒までのキャラクターを意味します⚠️ 注意： このパラメータを使用すると、生成される動画の長さが1秒短くなります

​
レスポンス

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