メインコンテンツへスキップ
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",
    "prompt": "滝が流れ落ちて虹を形成する",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "private": false,
    "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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

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": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "private": false,
    "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-pro Sora 2 Pro
例:"sora-2"
prompt
string
必須
動画生成用のテキスト記述例:"滝が流れ落ちて虹を形成する"
duration
integer
デフォルト:"4"
サポートされる値:48121620例:8
resolution
string
デフォルト:"720p"
動画の解像度サポートされる値:
モデル指定可能な値
sora-2720p
sora-2-pro720p1024p1080p
指定しない場合は 720p がデフォルトです。例:"720p"
aspect_ratio
string
デフォルト:"16:9"
動画のアスペクト比、横向きまたは縦向きを制御サポートされる値:
方向指定可能な値
横向き16:9landscape
縦向き9:16portrait
指定しない場合はデフォルトで横向きになります。
image_urls(画像から動画生成)を渡した場合、aspect_ratio パラメータは無効となり、送信する必要はありません。動画の方向は参照画像から自動的に判定されます。
image_urls
array<url>
画像から動画生成のための参照画像URL配列
  • 指定しない場合はテキストから動画生成、1枚指定すると画像から動画生成
  • 最大1枚
  • 公開アクセス可能な画像URL(http:// または https://)をサポート
  • 対応フォーマット:.jpeg.jpg.png.webp
  • 最大ファイルサイズ:10MB
例:["https://example.com/image.jpg"]

レスポンス

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