動画生成

動画生成タスクを送信し、処理状況を確認して生成結果を取得します。

概要

AGTCloud は複数の動画生成モデルと呼び出しプロトコルを提供します。通常、最初に動画生成タスクを作成し、次にタスク ID を使用してステータスと結果を取得します。

対応するタスク

種類	説明	主な入力
テキストから動画	テキストによる説明から動画を生成します	Prompt
画像から動画	静止画像に動きを加えます	Prompt、画像
参照素材から生成	モデルが対応する画像または動画素材を参照して生成します	Prompt、参照素材
モデル固有の拡張	開始・終了フレーム、カメラワークなどの固有機能を使用します	各モデルとプロトコルの仕様に従います

API への接続

Base URL

https://api.agtcloud.cn/v1

テキストから動画を生成する

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "prompt": "雨上がりの渓谷を列車が走り、カメラがゆっくり前進する"
  }'

画像から動画を生成する

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "prompt": "被写体の外見を保ったまま、人物がゆっくりカメラへ近づく",
    "image": "https://example.com/input.jpg"
  }'

作成に成功したら、レスポンスの Task ID を保存し、同じプロトコルでタスクを照会します。

タスクを照会する

curl 'https://api.agtcloud.cn/v1/video/generations/TASK_ID' \
  -H 'Authorization: Bearer your-api-key'

作成と照会のフィールドについては、動画タスクを作成と動画タスクを照会を参照してください。

呼び出しプロトコルを選択する

プロトコル	作成エンドポイント	後続処理
Platform Video Generations	`POST /v1/video/generations`	Task ID を使用して結果を照会します
OpenAI Videos	`POST /v1/videos`	Video ID を使用して照会し、コンテンツをダウンロードします
ベンダー固有プロトコル	対応する Reference に従います	そのプロトコルで定義されたタスク ID とステータスを使用します

同じタスクでは、作成、照会、ダウンロードに同一プロトコルのエンドポイントを使用してください。

概要