メインコンテンツへスキップ
POST
wan2.5-image-to-video インターフェース

承認

Authorization
string
header
必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得:

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加:

ボディ

application/json
model
enum<string>
デフォルト:wan2.5-image-to-video
必須

モデル名

利用可能なオプション:
wan2.5-image-to-video
:

"wan2.5-image-to-video"

prompt
string
必須

生成する動画の内容を説明するプロンプト、2000トークンまで

Maximum string length: 2000
:

"A cat playing the piano"

image_urls
string<uri>[]
必須

最初のフレーム画像から動画機能用の参照画像URLリスト

注意:

  • 1回のリクエストでサポートされる入力画像数: 1
  • 画像サイズ: 10MB 以下
  • サポートされる画像形式: .jpeg.jpg.png(透過チャンネル非対応)、.bmp.webp
  • 画像解像度: 画像の幅と高さの範囲は [360, 2000] ピクセル
  • 画像URLはサーバーから直接閲覧可能であるか、アクセス時に直接ダウンロードが開始される必要があります(通常、これらのURLは .png.jpg などの画像拡張子で終わります)
Maximum array length: 1
:
duration
integer

生成される動画の長さ(秒)を指定します

注意:

  • 510 の値のみサポート、それぞれ 5秒10秒 を表します
  • 1回のリクエストは duration の値に基づいて事前課金され、実際の課金は生成された動画の長さ(秒)に基づきます
:

5

quality
string
デフォルト:720p

動画の品質、デフォルトは 720p

説明:

  • 480p: 低品質、低価格
  • 720p: 標準品質、標準価格、これがデフォルトです
  • 1080p: 高品質、高価格
:

"720p"

prompt_extend
boolean
デフォルト:true

インテリジェントプロンプト書き換えを有効にするかどうか。有効にすると、大規模言語モデルがプロンプトを最適化します。詳細が不足しているプロンプトやシンプルすぎるプロンプトに特に効果的です。デフォルト値は true

:

true

callback_url
string<uri>

タスク完了後の HTTPS コールバックアドレス

コールバックタイミング:

  • タスクが完了、失敗、またはキャンセルされた時にトリガーされます
  • 課金確認完了後に送信されます

セキュリティ制限:

  • HTTPS プロトコルのみサポート
  • 内部 IP アドレスへのコールバックは禁止(127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x など)
  • URL の長さは 2048 文字以内

コールバックメカニズム:

  • タイムアウト:10
  • 失敗時最大 3 回リトライ(1 秒/2 秒/4 秒後にリトライ)
  • コールバックレスポンスボディの形式はタスククエリ API のレスポンス形式と一致
  • コールバックアドレスが 2xx ステータスコードを返した場合は成功とみなされ、その他のステータスコードはリトライをトリガーします
:

"https://your-domain.com/webhooks/video-task-completed"

レスポンス

動画タスクが正常に作成されました

created
integer

タスク作成タイムスタンプ

:

1757169743

id
string

タスク ID

:

"task-unified-1757169743-7cvnl5zw"

model
string

使用された実際のモデル名

:

"wan2.5-image-to-video"

object
enum<string>

具体的なタスクタイプ

利用可能なオプション:
video.generation.task
progress
integer

タスク進捗率(0-100)

必須範囲: 0 <= x <= 100
:

0

status
enum<string>

タスクステータス

利用可能なオプション:
pending,
processing,
completed,
failed
:

"pending"

task_info
object

動画タスクの詳細情報

type
enum<string>

タスク出力タイプ

利用可能なオプション:
text,
image,
audio,
video
:

"video"

usage
object

使用量と課金情報