ToAPIsToAPIs
Wan2.6

Wan2.6 動画生成

Generate high-quality videos using Alibaba Cloud Wan2.6 model — supports text-to-video, image-to-video and reference-video

POST
/v1/videos/generations

中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。

  • Alibaba Cloud Wanxiang video generation model
  • Supports three modes: Text-to-Video, Image-to-Video, and Reference Video (r2v)
  • Server automatically routes to the appropriate upstream model based on your request parameters
  • Supports 720p/1080p resolution, 5/10/15 second duration
  • Audio is always included in the generated output

Important Change: For better performance and cost control, we no longer support passing base64 image data directly in image_urls. Please use the Upload 画像API first to upload images and get URLs, then call this endpoint.

Routing Logic

The server automatically selects the upstream model based on what parameters you provide:

パラメータ ProvidedUpstream Mode
metadata.reference_urls (video URLs)Reference Video (r2v)
image_urls (image)Image-to-Video (i2v)
prompt onlyText-to-Video (t2v)

認証

Authorizationstringヘッダー必須

All endpoints require Bearer Token authentication

Get your API Key from the API Key Management Page

Add to request header:

Authorization: Bearer YOUR_API_KEY

リクエストパラメータ

modelstringボディ必須

Video generation model name, fixed as wan2.6

promptstringボディ必須

Video content description

必須 for text-to-video mode; optional for image-to-video and reference video modes (describe expected motion or style)

Example: "A cute cat stretching in the sunshine"

image_urlsstring[]ボディ

Reference image URL array for image-to-video mode (only supports 1 image)

⚠️ URL format only (base64 no longer supported)

  • Publicly accessible image URL (http:// or https://)
  • You can use the Upload 画像API to upload local images and get URLs

Example: ["https://example.com/image.jpg"]

Note: Cannot be combined with metadata.reference_urls

aspect_ratiostringボディデフォルト: 16:9

Video aspect ratio (applies to text-to-video and reference video modes)

Available values:

  • 16:9 - Landscape (default)
  • 9:16 - Portrait
  • 1:1 - Square
  • 4:3 - Landscape
  • 3:4 - Portrait

Default: 16:9

Note: Not supported in image-to-video mode

resolutionstringボディデフォルト: 1080p

Video resolution

Available values:

  • 720p - Standard definition
  • 1080p - High definition (default)

Default: 1080p

480p is not supported. Billed per second; different resolutions have different prices — refer to the model marketplace for details.

durationintegerボディデフォルト: 5

Video duration (seconds)

Supported values: 5, 10, 15

Default: 5

negative_promptstringボディ

Negative prompt — describe content you do not want in the video

Example: "blurry, low quality, deformed"

seedintegerボディ

Random seed for reproducibility

Example: 12345

prompt_extendbooleanボディデフォルト: true

Auto-extend prompt

When enabled, the system automatically optimizes and enriches your prompt. Enabled by default — set to false to disable.

audiobooleanボディ

Include audio in the generated video

Non-flash Wan2.6 models always include audio by default. Set to true to explicitly enable.

shot_typestringボディ

Shot type (applies to text-to-video and reference video modes)

Available values:

  • single - Single continuous shot
  • multi - Multi-shot (cinematic cuts)
watermarkbooleanボディ

Add an Alibaba Cloud watermark to the generated video

metadataobjectボディ

Extended parameters

Show metadata fields
reference_urlsstring[]ボディ

Reference Video (r2v) mode — array of reference video URLs

When provided, the server routes to the reference video upstream model (wan2.6-r2v). The model uses these videos to guide generation of consistent characters or scenes.

  • Each entry must be a publicly accessible video URL (http:// or https://)
  • Up to several reference videos are supported

Example: ["https://cdn.example.com/ref1.mp4"]

Note: Cannot be combined with image_urls

Resolution and Aspect Ratio Combinations

Aspect Ratio説明720p Size1080p Size
16:9Landscape (default)1280×7201920×1080
9:16Portrait720×12801080×1920
1:1Square960×9601440×1440
4:3Landscape1088×8321632×1248
3:4Portrait832×10881248×1632

レスポンス

idstring

Unique task identifier for status queries

objectstring

Object type, always generation.task

modelstring

モデル name used

statusstring

Task status

  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
progressinteger

Task progress percentage (0-100)

created_atinteger

Task creation timestamp (Unix timestamp)

metadataobject

Task metadata

Usage Scenarios

Scenario 1: Text-to-Video

{
  "model": "wan2.6",
  "prompt": "A cute cat running on grass, sunny day",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}

Scenario 2: Image-to-Video

{
  "model": "wan2.6",
  "prompt": "The cat starts running playfully",
  "image_urls": ["https://example.com/cat.jpg"],
  "resolution": "1080p",
  "duration": 10
}

Scenario 3: Reference Video (r2v)

{
  "model": "wan2.6",
  "prompt": "The character waves and smiles at the camera",
  "metadata": {
    "reference_urls": ["https://cdn.example.com/ref-character.mp4"]
  },
  "shot_type": "single",
  "resolution": "1080p",
  "duration": 5
}

Scenario 4: Text-to-Video (Full パラメータ)

{
  "model": "wan2.6",
  "prompt": "A golden retriever runs through a field of sunflowers",
  "negative_prompt": "blurry, low quality, deformed",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 10,
  "seed": 12345,
  "prompt_extend": true,
  "shot_type": "multi",
  "watermark": false
}

Querying Task Results

Video generation is an asynchronous task. After submission, a task_id is returned. Use the Get Video Task ステータス interface to query generation progress and results.

リクエスト例

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6",
    "prompt": "A cute cat running on grass",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": 5
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6",
    "prompt": "The cat starts running playfully",
    "image_urls": ["https://example.com/cat.jpg"],
    "resolution": "1080p",
    "duration": 10
  }'
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6",
    "prompt": "The character waves and smiles",
    "metadata": {
      "reference_urls": ["https://cdn.example.com/ref-character.mp4"]
    },
    "resolution": "1080p",
    "duration": 5
  }'
import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "wan2.6",
        "prompt": "A cute cat running on grass",
        "aspect_ratio": "16:9",
        "resolution": "1080p",
        "duration": 5
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")
const response = await fetch('https://toapis.com/v1/videos/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'wan2.6',
    prompt: 'A cute cat running on grass',
    aspect_ratio: '16:9',
    resolution: '1080p',
    duration: 5
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);

レスポンス例

{
  "id": "video_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "wan2.6",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {
    "aspect_ratio": "16:9"
  }
}