動画生成タスクを作成

ファイルを入力する場合は ファイル API でアップロードし、返された file_id を参照します。ゲートウェイは変換を担当し、入力への対応可否は上流が判断します。

input_references: [{"type":"image","role":"reference","source":{"type":"file","file_id":"..."}}] で素材を参照します。type は実ファイルの image/audio/video に一致させます。source を COS 署名 URL に変換し、role を保持して DSL に渡します。既存の必須項目は引き続き必要です。Images と Speech の input_references は InOneAPI 拡張です。

POST /v1/videos でタスクを作成し、返された ID をポーリングします。完全例は公開フィールドを一覧化したもので、すべてのモデルで同時に使える組み合わせではありません。未対応の任意フィールドは削除してください。

最小リクエスト

YOUR_MODEL_ID をモデル詳細の正確な ID に置き換え、接頭辞は追加しないでください。任意パラメーターと音色はモデルの対応範囲に従い、アプリヘッダーはコメントのままで利用できます。

# -H "X-APP-NAME: Your App Name"
# -H "X-APP-URL: https://your-app.example.com"
curl "https://api.inoneapi.com/v1/videos" \
  -H "Authorization: Bearer $INONEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_MODEL_ID",
  "prompt": "A white cat running beside the sea"
}'

認証とヘッダー

サーバー側の API キーを Authorization: Bearer に設定し、Content-Type: application/json を送信します。X-Gateway-Trace-ID はリクエスト識別子で、タスク ID ではありません。キーをブラウザーへ公開しないでください。

完全なリクエスト例

curl --request POST 'https://api.inoneapi.com/v1/videos' \
  --header "Authorization: Bearer $INONEAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "model": "YOUR_MODEL_ID",
  "prompt": "A white cat running beside the sea",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "input_references": [
    {
      "type": "image",
      "role": "first_frame",
      "source": {
        "type": "url",
        "url": "https://example.com/start.png"
      }
    }
  ],
  "options": {
    "seed": 42,
    "negative_prompt": "blur",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhook"
}'

パラメーター一覧

ParameterTypeパラメーター一覧
modelstring必須の InOneAPI 公開モデル ID。プロバイダー内部 ID ではありません。
promptstring必須の生成指示。被写体、動作、背景、カメラ、光、スタイルを記述。長さ制限はモデル依存。
durationinteger任意の整数、単位は秒。ミリ秒ではありません。許容値と省略時の既定値はモデル依存。
resolutionstring任意の解像度。例：720p、1080p。時間や縦横比との組み合わせ制限があります。
aspect_ratiostring任意の縦横比。16:9、9:16、1:1 など。画素数ではありません。
input_referencesarray任意の順序付きメディア参照配列。個数と混在制限はモデル依存。
input_references[].typestring各要素で必須：image、video、audio。
input_references[].rolestring各要素で必須：first_frame、last_frame、reference、speech。対応する役割はモデル依存。
input_references[].sourceobject各要素で必須：ソース種別と対応する値。
input_references[].source.typestringurl、file（別名 file_id）、data。一つの表現のみを指定。
input_references[].source.urlstringurl の場合必須。プロバイダーから到達可能な HTTPS URL。有効期限は素材読込まで必要。
input_references[].source.file_idstringfile/file_id の場合必須。現在のキーで InOneAPI ファイル API にアップロードした ID。COS 署名 URL に変換します。上流のファイル ID は受け付けません。
input_references[].source.datastringdata の場合必須。対応する Base64 または data URL。ゲートウェイは変換しません。
optionsobject任意の拡張設定。seed、negative_prompt、音声設定などは共通仕様ではなく、明示的なマッピングが必要。
callback_urlstring任意の HTTPS コールバック。プロバイダーの対応とマッピングが必要。ゲートウェイは通知送信・署名・再送を行いません。

メディアと機能の制限

テキストのみの場合 input_references を省略できます。画像からの生成は first_frame、開始・終了画像は first_frame と last_frame を使用。動画・音声参照はモデルの対応が必要です。URL、file_id、data は排他的です。media_source は値の抽出のみで、アップロード、取得、サイズ変更、形式検査は行いません。options に書くだけで任意の他社機能が使えるわけではありません。

レスポンスとエラー

新しいタスク ID はユーザー、公共モデル、元のマッピングと上流資格情報に結び付く ioa_v1. 署名付きハンドルです。以下は例示値です。実際の ID を完全に保存し、照会時も作成時の model を指定してください。

{"id":"ioa_v1.REPLACE_WITH_RETURNED_TASK_ID","status":"queued","created_at":"2026-09-05T08:30:00Z"}

id、status、created_at は設定で正規化します。欠落する時刻は生成されません。作成直後に running となる場合もあります。成功状態を固定値で偽装しないでください。HTTP エラーとタスクの failed は別です。作成タイムアウト時の結果は不明なため、無条件の再送は重複課金を起こし得ます。汎用の冪等性保証はありません。

GET /v1/videos/{id}

動画生成タスクを作成 · ドキュメント · InOneAPI