メインコンテンツへスキップ
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
必須
すべてのAPIエンドポイントにはBearer Token認証が必要ですAPIキーの取得:APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに追加:
Authorization: Bearer YOUR_API_KEY

​
ボディ

​
model
string
デフォルト:"sora-2"
必須
動画生成モデル名サポートされているモデル：
  • sora-2 - 標準バージョン
  • sora-2-vip - VIPバージョン、sora-2のアップグレード版
  • sora-2-pro - プロフェッショナルバージョン、より長い時間をサポート
例："sora-2" または "sora-2-vip" または "sora-2-pro"
​
prompt
string
必須
動画生成用のテキスト記述💡 @キャラクター参照機能：プロンプトで @username 形式を使用して、作成済みのキャラクターを参照し、生成される動画に含めることができます。例："猫と犬が一緒に車を運転している @duksvfkf.cruisingki @zdqwahgj.baronbarki"
​
duration
integer
動画の長さ（秒）
  • sora-2：10秒または15秒をサポート
  • sora-2-pro：10秒（高画質）、15秒（高画質）または25秒をサポート
例：10
​
aspect_ratio
string
動画の解像度対応フォーマット:
  • 16:9 (横向き)
  • 9:16 (縦向き)
​
image_urls
array<url>
画像から動画生成のための参照画像URL配列公開アクセス可能な画像URL（http:// または https://）をサポート例：["https://example.com/image.jpg"]制限：
  • 最大ファイルサイズ：10MB
  • 対応フォーマット：.jpeg、.jpg、.png、.webp
​
watermark
boolean
デフォルト:"false"
生成された動画にウォーターマークを追加するかどうか
  • false：ウォーターマークを追加しない
  • true：動画にSora公式ウォーターマークを追加
デフォルト: false
​
thumbnail
boolean
動画のサムネイルを生成するかどうか
  • true：プレビューと表示用の動画サムネイルを生成
⚠️ 注意： サムネイルは1時間のみ保存されます。必要な場合は管理者にお問い合わせください。サムネイルが不要な場合は、このパラメータを省略できます
​
private
boolean
デフォルト:"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
レスポンスデータ配列