# Wan API ドキュメント
> AI Studio API で Wan モデルを使用して動画を生成します。
## 概要
AI Studio API を使用して Wan の生成タスクを作成し、タスク状態を確認します。処理は非同期です。まずタスクを作成して `taskId` を取得し、その後タスク API で結果を確認します。
## 認証
すべてのリクエストで `Authorization` ヘッダーに API Key が必要です。
```http
Authorization: Bearer YOUR_API_KEY
```
## 利用可能なモデル
| modelId | バージョン | プロバイダー | 実行モデル |
| --- | --- | --- | --- |
| `video:wan-3-0-video` | Wan 3.0 Video | Wan 3.0 | wan/3-0-video |
| `video:wan-3-0-video-prime` | Wan 3.0 Video Prime | Wan 3.0 | wan/3-0-video-prime |
| `video:fal-alibaba-wan-3-0-text-to-video` | Wan 3.0 Text to Video | Alibaba | alibaba/wan-3.0/text-to-video |
| `video:fal-alibaba-wan-3-0-image-to-video` | Wan 3.0 Image to Video | Alibaba | alibaba/wan-3.0/image-to-video |
| `video:fal-alibaba-wan-3-0-reference-to-video` | Wan 3.0 Reference to Video | Alibaba | alibaba/wan-3.0/reference-to-video |
| `video:fal-alibaba-wan-3-0-prime-text-to-video` | Wan 3.0 Prime Text to Video | Alibaba | alibaba/wan-3.0-prime/text-to-video |
| `video:fal-alibaba-wan-3-0-prime-image-to-video` | Wan 3.0 Prime Image to Video | Alibaba | alibaba/wan-3.0-prime/image-to-video |
| `video:fal-alibaba-wan-3-0-prime-reference-to-video` | Wan 3.0 Prime Reference to Video | Alibaba | alibaba/wan-3.0-prime/reference-to-video |
| `video:wan-2-7-text-to-video` | Wan 2.7 Text to Video | Wan 2.7 | wan/2-7-text-to-video |
| `video:wan-2-7-image-to-video` | Wan 2.7 Image to Video | Wan 2.7 | wan/2-7-image-to-video |
| `video:wan-2-7-video-edit` | Wan 2.7 Video Edit | Wan 2.7 | wan/2-7-videoedit |
| `video:wan-2-7-reference-to-video` | Wan 2.7 Reference to Video | Wan 2.7 | wan/2-7-r2v |
| `video:fal-fal-ai-wan-v2-7-text-to-video` | Wan 2.7 Text to Video | wan | fal-ai/wan/v2.7/text-to-video |
| `video:fal-fal-ai-wan-v2-7-image-to-video` | Wan 2.7 Image to Video | wan | fal-ai/wan/v2.7/image-to-video |
| `video:fal-fal-ai-wan-v2-7-reference-to-video` | Wan 2.7 Reference to Video | wan | fal-ai/wan/v2.7/reference-to-video |
| `video:wan-2-6-text-to-video` | Wan 2.6 Text to Video | Wan 2.6 | wan/2-6-text-to-video |
| `video:wan-2-6-image-to-video` | Wan 2.6 Image to Video | Wan 2.6 | wan/2-6-image-to-video |
| `video:wan-2-6-video-to-video` | Wan 2.6 Video to Video | Wan 2.6 | wan/2-6-video-to-video |
| `video:wan-2-5-text-to-video` | Wan 2.5 Text to Video | Wan 2.5 | wan/2-5-text-to-video |
| `video:wan-2-5-image-to-video` | Wan 2.5 Image to Video | Wan 2.5 | wan/2-5-image-to-video |
| `video:wan-text-to-video` | Wan Text to Video | Wan | wan/2-2-a14b-text-to-video-turbo |
| `video:wan-2-2-a14b-image-to-video-turbo` | Wan 2.2 A14B Image to Video Turbo | Wan | wan/2-2-a14b-image-to-video-turbo |
| `video:wan-2-2-a14b-speech-to-video-turbo` | Wan 2.2 A14B Speech to Video Turbo | Wan | wan/2-2-a14b-speech-to-video-turbo |
| `video:wan-animate-move` | Wan Animate Move | Wan | wan/2-2-animate-move |
| `video:wan-animate-replace` | Wan Animate Replace | Wan | wan/2-2-animate-replace |
## 1. 生成タスクを作成
### エンドポイント
```http
POST https://localhost:3000/api/ai-studio/execute
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
```
### リクエスト例
```json
{
"modelId": "video:wan-3-0-video",
"isPublic": true,
"payload": {
"model": "wan/3-0-video",
"input": {
"prompt": "Under the moonlight, a little cat is running on the roof. In the distance, the neon lights are flashing, giving a cinematic feel. The camera movement is smooth.",
"resolution": "480P",
"aspect_ratio": "adaptive",
"duration": 5,
"audio": true
}
}
}
```
### 成功レスポンス
```json
{
"success": true,
"data": {
"modelId": "video:wan-3-0-video",
"generationId": "generation-id",
"reservedCredits": 20,
"taskId": "provider-task-id",
"state": "queued"
}
}
```
## 2. タスク状態を確認
### エンドポイント
```http
GET https://localhost:3000/api/ai-studio/tasks/{taskId}
Authorization: Bearer YOUR_API_KEY
```
### 成功レスポンス
```json
{
"success": true,
"data": {
"generationId": "generation-id",
"taskId": "provider-task-id",
"modelId": "video:wan-3-0-video",
"state": "succeeded",
"mediaUrls": [
"https://example.com/result.mp4"
],
"reservedCredits": 20,
"refundedCredits": 0
}
}
```
## リクエストフィールド
### Wan 3.0 Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/3-0-video"` | wan/3-0-video | wan/3-0-video is the standard model. The name of the model used to generate videos. This field is required. - This endpoint must be `wan/3-0-video` |
| `input` | object | はい | `-` | - | Parameters for Wan 3.0 video generation. |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | いいえ | `"A kitten running across a rooftop under the moonlight, neon lights flickering in the distance, cinematic quality, with smooth camera movement."` | - | Text prompt, supporting both Chinese and English. Up to 20,000 characters; excess characters will be truncated automatically. Required for text-to-video generation; for other modes, it is recommended to provide it together with media. In reference mode, use Image1/Video1/Audio1 to reference the provided media. |
| `first_frame_url` | string | いいえ | `-` | - | URL of the first-frame image. Up to 1 image, used strictly as the first frame of the video. Used for first-frame-to-video / first-and-last-frame-to-video generation. Cannot be provided together with `reference_*_urls`.
Formats: JPEG/JPG, PNG (transparency not supported), BMP, WEBP; each side [240, 8000] px; aspect ratio ≤ 8:1; ≤ 20MB. |
| `last_frame_url` | string | いいえ | `-` | - | URL of the last-frame image. Used with first_frame_url for first-and-last-frame generation; the same image limits apply. |
| `reference_image_urls` | string[] | いいえ | `-` | - | Reference images for the all-purpose reference mode, with up to 10 images. Correspond to Image1, Image2, … in the prompt according to array order. Specifications are the same as `first_frame_url`. Cannot be provided together with the first-frame/last-frame parameters. |
| `reference_video_urls` | string[] | いいえ | `-` | - | Reference videos for the all-purpose reference mode, with up to 5 clips. Each clip must be 1–15 seconds, with a total duration ≤ 15 seconds. Correspond to Video1, Video2, … according to array order.
Formats: mp4, mov; each side [240, 4096] px; aspect ratio ≤ 8:1; each file ≤ 100MB.
There is an additional constraint on the output side: the input video duration + `duration` must not exceed 30 seconds. |
| `reference_audio_urls` | string[] | いいえ | `-` | - | Reference audio for the all-purpose reference mode, with up to 5 clips. Each clip must be 1–15 seconds, with a total duration ≤ 15 seconds. Correspond to Audio1, Audio2, … according to array order. Formats: wav, mp3; ≤ 15MB. Audio should not be used alone as the only media input; pairing it with an image or video is still recommended. |
| `reference_file_urls` | string[] | いいえ | `-` | - | File-to-video generation. Up to 1 file. Cannot be provided together with `reference_link_urls`, or with the first-frame/last-frame parameters.
Formats: docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md; ≤ 100MB; pdf/docx/ppt/key/pages, etc. ≤ 50 pages. |
| `reference_link_urls` | string[] | いいえ | `-` | - | Link-to-video generation. Up to 1 publicly accessible webpage that does not require login. Cannot be provided together with `reference_file_urls`, or with the first-frame/last-frame parameters. |
| `resolution` | enum | いいえ | `"1080P"` | 480P, 720P, 1080P | Output resolution. Default: **1080P**. |
| `aspect_ratio` | enum | いいえ | `"adaptive"` | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 | Output aspect ratio. `adaptive` (default) automatically selects the ratio based on the input media and intent. |
| `duration` | number | いいえ | `5` | - | Output video duration in seconds. Default: 5. Without video input, the range is [2, 30]. With reference videos: input video duration + output duration ≤ 30. Pass `-1` to use an intelligent duration determined by the model. This studio requires a fixed duration of 2–30 seconds so the price can be calculated before submission; automatic duration (-1) is disabled. |
| `audio` | boolean | いいえ | `true` | - | Whether the output video includes an audio track. Default: true. |
| `seed` | number | いいえ | `-` | - | Random seed used to reproduce results. If omitted, a random seed will be used. |
### Wan 3.0 Video Prime
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/3-0-video-prime"` | wan/3-0-video-prime | wan/3-0-video-prime is a high-speed model. The model name used to generate videos. This field is required. - This endpoint must be `wan/3-0-video-prime` |
| `input` | object | はい | `-` | - | Parameters for Wan 3.0 video generation. |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | いいえ | `"A kitten running across a rooftop under the moonlight, neon lights flickering in the distance, cinematic quality, with smooth camera movement."` | - | Text prompt. Chinese and English are supported. Up to 20,000 characters; excess characters are truncated automatically. Required for text-to-video; for other modes, it is recommended to provide it together with media. In reference mode, use Image1/Video1/Audio1 to reference the provided materials. |
| `first_frame_url` | string | いいえ | `-` | - | URL of the first-frame image. Up to 1 image, used strictly as the first frame of the video. Used for first-frame-to-video or first-and-last-frame-to-video generation. Cannot be provided together with `reference_*_urls`.
Formats: JPEG/JPG, PNG (transparency not supported), BMP, WEBP; each side [240, 8000] px; aspect ratio ≤ 8:1; ≤ 20MB. |
| `last_frame_url` | string | いいえ | `-` | - | URL of the last-frame image. Used with first_frame_url for first-and-last-frame generation; the same image limits apply. |
| `reference_image_urls` | string[] | いいえ | `-` | - | Reference images for all-purpose reference mode. Up to 10 images. Correspond to Image1, Image2, and so on in the prompt according to array order. Same specifications as `first_frame_url`. Cannot be provided together with the first-frame or last-frame image. |
| `reference_video_urls` | string[] | いいえ | `-` | - | Reference videos for all-purpose reference mode. Up to 5 videos. Each video must be 1–15s, with a combined duration of ≤ 15s. Correspond to Video1, Video2, and so on according to array order.
Formats: mp4, mov; each side [240, 4096] px; aspect ratio ≤ 8:1; each file ≤ 100MB.
There is an additional output-side limit: the input video duration plus `duration` cannot exceed 30 seconds. |
| `reference_audio_urls` | string[] | いいえ | `-` | - | Reference audio files for all-purpose reference mode. Up to 5 audio files. Each file must be 1–15s, with a combined duration of ≤ 15s. Correspond to Audio1, Audio2, and so on according to array order. Formats: wav, mp3; ≤ 15MB. Even when used as the only media input, it is still recommended to provide an image or video together with it. |
| `reference_file_urls` | string[] | いいえ | `-` | - | File-to-video generation. Up to 1 file. Cannot be provided together with `reference_link_urls`, or with the first-frame/last-frame image.
Formats: docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md; ≤ 100MB; pdf/docx/ppt/key/pages, etc. ≤ 50 pages. |
| `reference_link_urls` | string[] | いいえ | `-` | - | Link-to-video generation. Up to 1 publicly accessible webpage that does not require login. Cannot be provided together with `reference_file_urls`, or with the first-frame/last-frame image. |
| `resolution` | enum | いいえ | `"1080P"` | 480P, 720P, 1080P | Output resolution level. Default: **1080P**. |
| `aspect_ratio` | enum | いいえ | `"adaptive"` | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 | Output aspect ratio. `adaptive` (default) automatically selects the aspect ratio based on the input materials and intent. |
| `duration` | number | いいえ | `5` | - | Output video duration in seconds. Default: 5. When there is no video input, the value must be within [2, 30]. When reference videos are provided: input video duration plus output duration ≤ 30. Pass `-1` to use an intelligent duration determined by the model. This studio requires a fixed duration of 2–30 seconds so the price can be calculated before submission; automatic duration (-1) is disabled. |
| `audio` | boolean | いいえ | `true` | - | Whether the output video includes an audio track. Default: true. |
| `seed` | number | いいえ | `-` | - | Random seed used to reproduce results. If omitted, a random seed is used. |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan 3.0 Text to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `seed` | object | いいえ | `-` | - | - |
| `prompt` | string | はい | `"A red panda walking through a bamboo forest at sunrise"` | - | Text prompt for the generated video. |
| `enable_thinking` | boolean | いいえ | `false` | - | Enable enhanced reasoning before generation. |
| `resolution` | enum | いいえ | `"1080p"` | 480p, 720p, 1080p | Output video resolution tier. |
| `duration` | number | いいえ | `5` | - | Output video duration in seconds, from 2 to 30. |
| `aspect_ratio` | enum | いいえ | `"adaptive"` | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 | Output aspect ratio, or adaptive selection. |
| `enable_prompt_expansion` | boolean | いいえ | `true` | - | Enable intelligent prompt rewriting. Disabling it can save roughly 20-60 seconds of latency but is likely to degrade generation quality. |
| `enable_safety_checker` | boolean | いいえ | `true` | - | Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked. |
| `audio` | boolean | いいえ | `true` | - | Include generated audio. |
#### input フィールド
_このモデルのフィールド設定はありません。_
### Wan 3.0 Image to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `seed` | object | いいえ | `-` | - | - |
| `prompt` | object | いいえ | `-` | - | Text prompt describing the motion to generate. |
| `end_image_url` | object | いいえ | `-` | - | Last frame of the generated video. Requires start_image_url. |
| `audio` | boolean | いいえ | `true` | - | Include generated audio. |
| `enable_thinking` | boolean | いいえ | `false` | - | Enable enhanced reasoning before generation. |
| `resolution` | enum | いいえ | `"1080p"` | 480p, 720p, 1080p | Output video resolution tier. |
| `duration` | number | いいえ | `5` | - | Output video duration in seconds, from 2 to 30. |
| `aspect_ratio` | enum | いいえ | `"adaptive"` | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 | Output aspect ratio, or adaptive selection. |
| `enable_prompt_expansion` | boolean | いいえ | `true` | - | Enable intelligent prompt rewriting. Disabling it can save roughly 20-60 seconds of latency but is likely to degrade generation quality. |
| `enable_safety_checker` | boolean | いいえ | `true` | - | Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked. |
| `start_image_url` | string | はい | `-` | - | First frame of the generated video. |
#### input フィールド
_このモデルのフィールド設定はありません。_
### Wan 3.0 Reference to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `seed` | object | いいえ | `-` | - | - |
| `enable_prompt_expansion` | boolean | いいえ | `true` | - | Enable intelligent prompt rewriting. Disabling it can save roughly 20-60 seconds of latency but is likely to degrade generation quality. |
| `enable_safety_checker` | boolean | いいえ | `true` | - | Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked. |
| `aspect_ratio` | enum | いいえ | `"adaptive"` | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 | Output aspect ratio, or adaptive selection. |
| `reference_audio_urls` | string[] | いいえ | `-` | - | Up to 5 reference audio URLs totaling at most 15 seconds. |
| `resolution` | enum | いいえ | `"1080p"` | 480p, 720p, 1080p | Output video resolution tier. |
| `audio` | boolean | いいえ | `true` | - | Include generated audio. |
| `file_url` | object | いいえ | `-` | - | Document URL to base the video on. Requires enable_thinking=true. |
| `duration` | number | いいえ | `5` | - | Output video duration in seconds, from 2 to 30. |
| `reference_video_urls` | string[] | いいえ | `-` | - | Up to 5 reference video URLs totaling at most 15 seconds. Each clip must be at least 16 fps. |
| `reference_image_urls` | string[] | いいえ | `-` | - | Up to 10 reference image URLs. |
| `prompt` | object | いいえ | `-` | - | Text prompt directing how the reference media is used. Reference media can be addressed positionally, e.g. 'the subject in Image 1 walks past Video 1'. |
| `enable_thinking` | boolean | いいえ | `false` | - | Enable enhanced reasoning before generation. |
| `web_url` | object | いいえ | `-` | - | Public webpage URL to base the video on. Requires enable_thinking=true. Only pages that do not require login can be read. |
#### input フィールド
_このモデルのフィールド設定はありません。_
### Wan 3.0 Prime Text to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `resolution` | enum | いいえ | `"1080p"` | 480p, 720p, 1080p | Output video resolution tier. |
| `enable_prompt_expansion` | boolean | いいえ | `true` | - | Enable intelligent prompt rewriting. Disabling it can save roughly 20-60 seconds of latency but is likely to degrade generation quality. |
| `aspect_ratio` | enum | いいえ | `"adaptive"` | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 | Output aspect ratio, or adaptive selection. |
| `enable_thinking` | boolean | いいえ | `false` | - | Enable enhanced reasoning before generation. |
| `prompt` | string | はい | `"A red panda walking through a bamboo forest at sunrise"` | - | Text prompt for the generated video. |
| `duration` | number | いいえ | `5` | - | Output video duration in seconds, from 2 to 30. |
| `audio` | boolean | いいえ | `true` | - | Include generated audio. |
| `seed` | object | いいえ | `-` | - | - |
| `enable_safety_checker` | boolean | いいえ | `true` | - | Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked. |
#### input フィールド
_このモデルのフィールド設定はありません。_
### Wan 3.0 Prime Image to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `enable_thinking` | boolean | いいえ | `false` | - | Enable enhanced reasoning before generation. |
| `enable_prompt_expansion` | boolean | いいえ | `true` | - | Enable intelligent prompt rewriting. Disabling it can save roughly 20-60 seconds of latency but is likely to degrade generation quality. |
| `aspect_ratio` | enum | いいえ | `"adaptive"` | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 | Output aspect ratio, or adaptive selection. |
| `resolution` | enum | いいえ | `"1080p"` | 480p, 720p, 1080p | Output video resolution tier. |
| `start_image_url` | string | はい | `-` | - | First frame of the generated video. |
| `end_image_url` | object | いいえ | `-` | - | Last frame of the generated video. Requires start_image_url. |
| `prompt` | object | いいえ | `-` | - | Text prompt describing the motion to generate. |
| `duration` | number | いいえ | `5` | - | Output video duration in seconds, from 2 to 30. |
| `audio` | boolean | いいえ | `true` | - | Include generated audio. |
| `seed` | object | いいえ | `-` | - | - |
| `enable_safety_checker` | boolean | いいえ | `true` | - | Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked. |
#### input フィールド
_このモデルのフィールド設定はありません。_
### Wan 3.0 Prime Reference to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `enable_thinking` | boolean | いいえ | `false` | - | Enable enhanced reasoning before generation. |
| `reference_image_urls` | string[] | いいえ | `-` | - | Up to 10 reference image URLs. |
| `aspect_ratio` | enum | いいえ | `"adaptive"` | adaptive, 16:9, 4:3, 1:1, 3:4, 9:16 | Output aspect ratio, or adaptive selection. |
| `reference_video_urls` | string[] | いいえ | `-` | - | Up to 5 reference video URLs totaling at most 15 seconds. Each clip must be at least 16 fps. |
| `web_url` | object | いいえ | `-` | - | Public webpage URL to base the video on. Requires enable_thinking=true. Only pages that do not require login can be read. |
| `reference_audio_urls` | string[] | いいえ | `-` | - | Up to 5 reference audio URLs totaling at most 15 seconds. |
| `enable_prompt_expansion` | boolean | いいえ | `true` | - | Enable intelligent prompt rewriting. Disabling it can save roughly 20-60 seconds of latency but is likely to degrade generation quality. |
| `prompt` | object | いいえ | `-` | - | Text prompt directing how the reference media is used. Reference media can be addressed positionally, e.g. 'the subject in Image 1 walks past Video 1'. |
| `duration` | number | いいえ | `5` | - | Output video duration in seconds, from 2 to 30. |
| `resolution` | enum | いいえ | `"1080p"` | 480p, 720p, 1080p | Output video resolution tier. |
| `audio` | boolean | いいえ | `true` | - | Include generated audio. |
| `seed` | object | いいえ | `-` | - | - |
| `file_url` | object | いいえ | `-` | - | Document URL to base the video on. Requires enable_thinking=true. |
| `enable_safety_checker` | boolean | いいえ | `true` | - | Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked. |
#### input フィールド
_このモデルのフィールド設定はありません。_
### Wan 2.7 Text to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-7-text-to-video"` | wan/2-7-text-to-video | The model name used for generation. This field is required. - This endpoint must use the `wan/2-7-text-to-video` model |
| `input` | object | はい | `-` | - | Input parameters for the text-to-video task. |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | はい | `-` | - | Positive prompt. Minimum length: 1 character. Maximum length: 5000 characters. |
| `negative_prompt` | string | いいえ | `-` | - | Negative prompt. Maximum length: 500 characters. |
| `audio_url` | string | いいえ | `-` | - | Optional custom audio URL. |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Video resolution. - `720p`: 720p
- `1080p`: 1080p |
| `ratio` | enum | いいえ | `"16:9"` | 16:9, 9:16, 1:1, 4:3, 3:4 | Video aspect ratio. - `16:9`: Landscape
- `9:16`: Portrait
- `1:1`: Square
- `4:3`: Landscape 4:3
- `3:4`: Portrait 3:4 |
| `duration` | number | いいえ | `5` | - | Video duration in seconds. - Minimum: `2`
- Maximum: `15`
- Default: `5` |
| `prompt_extend` | boolean | いいえ | `true` | - | Whether to enable intelligent prompt rewriting. Default value: `true`. |
| `watermark` | boolean | いいえ | `false` | - | Whether to add an AI-generated watermark. Default value: `false`. |
| `seed` | number | いいえ | `-` | - | Random seed. - Minimum: `0`
- Maximum: `2147483647` |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan 2.7 Image to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-7-image-to-video"` | wan/2-7-image-to-video | The model name used for generation. This field is required. This endpoint must use the `wan/2-7-image-to-video` model. |
| `input` | object | はい | `-` | - | Input parameters for the image-to-video task. |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | はい | `-` | - | Positive prompt. Maximum length: 5000 characters. |
| `negative_prompt` | string | いいえ | `-` | - | Negative prompt. Maximum length: 500 characters. |
| `first_frame_url` | string | いいえ | `-` | - | First frame image URL. |
| `last_frame_url` | string | いいえ | `-` | - | Last frame image URL. |
| `first_clip_url` | string | いいえ | `-` | - | First clip video URL, used for video continuation. |
| `driving_audio_url` | string | いいえ | `-` | - | Driving audio URL. |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Video resolution. - `720p`: 720p
- `1080p`: 1080p |
| `duration` | number | いいえ | `5` | - | Total output video duration in seconds. - Minimum: `2`
- Maximum: `15`
- Default: `5` |
| `prompt_extend` | boolean | いいえ | `true` | - | Whether to enable intelligent prompt rewriting. Default value: `true`. |
| `watermark` | boolean | いいえ | `false` | - | Whether to add an AI-generated watermark. Default value: `false`. |
| `seed` | number | いいえ | `-` | - | Random seed. - Minimum: `0`
- Maximum: `2147483647` |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan 2.7 Video Edit
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-7-videoedit"` | wan/2-7-videoedit | The model name used for generation. This field is required. This endpoint must use the `wan/2-7-videoedit` model. |
| `input` | object | はい | `-` | - | Input parameters for the video editing task. |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | いいえ | `"Change the character's outfit and add the hat shown in the reference image."` | - | Optional text prompt describing the expected elements and visual features in the generated video. Supports Chinese and English. Maximum length: 5000 characters. |
| `negative_prompt` | string | いいえ | `"low resolution, errors, worst quality, low quality, malformed, extra fingers, bad proportions"` | - | Optional negative prompt describing content that should not appear in the video. Supports Chinese and English. Maximum length: 500 characters. |
| `video_url` | string | はい | `"https://example.com/demo/video.mp4"` | - | URL of the source video to edit. Required. Only one video is supported. - Formats: `mp4`, `mov`
- Duration: `2` to `10` seconds
- Resolution: width and height range `[240,4096]` pixels
- Aspect ratio: `1:8` to `8:1`
- File size: up to `100MB`
- Supports public `http/https` URLs or temporary `oss` URLs |
| `reference_image` | string | いいえ | `"https://example.com/demo/reference.png"` | - | Optional reference image URL for character, clothing, or style guidance. - Formats: `JPEG`, `JPG`, `PNG` (no alpha channel), `BMP`, `WEBP`
- Resolution: width and height range `[240,8000]` pixels
- Aspect ratio: `1:8` to `8:1`
- Supports public `http/https` URLs or temporary `oss` URLs |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Output video resolution tier. `1080p` costs more than `720p`. Default value: `1080p`. - `720p`: 720p
- `1080p`: 1080p |
| `aspect_ratio` | enum | いいえ | `"16:9"` | 16:9, 9:16, 1:1, 4:3, 3:4 | Output video aspect ratio. - If omitted: the output uses an aspect ratio close to the input video
- If provided: the output uses the specified aspect ratio
- Available values: `16:9`, `9:16`, `1:1`, `4:3`, `3:4` |
| `duration` | number | いいえ | `0` | - | Output video duration in seconds. - Default `0` means using the full input video duration without truncation
- If a value is provided, the output is clipped from second `0` to the specified length
- Valid values are `0` or any integer in `[2,10]` |
| `audio_setting` | enum | いいえ | `"auto"` | auto, origin | Video audio setting. - `auto`: default, the model decides whether to regenerate audio based on the `prompt`
- `origin`: force keeping the original input video audio |
| `prompt_extend` | boolean | いいえ | `true` | - | Whether to enable prompt rewriting. When enabled, the model expands the input prompt. This usually works better for short prompts but increases processing time. |
| `watermark` | boolean | いいえ | `false` | - | Whether to add a watermark. The watermark is placed in the lower-right corner of the video with the fixed text "AI generated". |
| `seed` | number | いいえ | `0` | - | Random seed. Range: `0-2147483647`. If omitted, the system generates one automatically. |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan 2.7 Reference to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-7-r2v"` | wan/2-7-r2v | The model name used for generation. This field is required. This endpoint must use the `wan/2-7-r2v` model. |
| `input` | object | はい | `-` | - | Input parameters for the reference-to-video task. |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | はい | `"Image 1 is eating, while video 1 and image 2 are singing beside it."` | - | Text prompt. Required. Describes the desired elements and visual features in the generated video. Supports Chinese and English. Maximum length: 5000 characters. |
| `negative_prompt` | string | いいえ | `"low resolution, errors, worst quality, low quality, malformed, extra fingers, bad proportions"` | - | Optional negative prompt describing what should not appear in the video. Supports Chinese and English. Maximum length: 500 characters. |
| `reference_image` | string[] | いいえ | `["https://example.com/demo/ref-image-1.png","https://example.com/demo/ref-image-2.png"]` | - | Array of reference image URLs. At least one of `reference_image` or `reference_video` must be provided. The total number of images and videos cannot exceed 5. |
| `reference_video` | string[] | いいえ | `["https://example.com/demo/ref-video-1.mp4"]` | - | Array of reference video URLs. At least one of `reference_image` or `reference_video` must be provided. The total number of images and videos cannot exceed 5. |
| `first_frame` | string | いいえ | `"https://example.com/demo/first-frame.png"` | - | First frame image URL. At most one image can be provided. If supplied, `aspect_ratio` is ignored and the output uses a ratio close to the first frame image. |
| `reference_voice` | string | いいえ | `"https://example.com/demo/reference-voice.mp3"` | - | Audio URL used to specify the voice timbre of the subject in the reference material. Rules:
- If `reference_video` contains audio and `reference_voice` is not provided, the original video audio is used by default
- If both `reference_video` and `reference_voice` are provided, `reference_voice` takes priority Audio limits:
- Formats: `wav`, `mp3`
- Duration: `1` to `10` seconds
- File size: up to `15MB` |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Output video resolution tier. Available values: `720p`, `1080p`. Default value: `1080p`. |
| `aspect_ratio` | enum | いいえ | `"16:9"` | 16:9, 9:16, 1:1, 4:3, 3:4 | Output video aspect ratio. Effective logic:
- If `first_frame` is not provided: the video is generated using the specified `aspect_ratio`
- If `first_frame` is provided: `aspect_ratio` is ignored and the output uses a ratio close to the first frame image |
| `duration` | number | いいえ | `5` | - | Output video duration in seconds. Valid range is an integer from `2` to `10`. Default value: `5`. |
| `prompt_extend` | boolean | いいえ | `true` | - | Whether to enable prompt rewriting. When enabled, the model expands the input prompt. This usually works better for short prompts but increases processing time. |
| `watermark` | boolean | いいえ | `false` | - | Whether to add a watermark. The watermark is placed in the lower-right corner of the video with the fixed text "AI generated". |
| `seed` | number | いいえ | `0` | - | Random seed. Range: `0-2147483647`. If omitted, the system generates one automatically. |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan 2.7 Text to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Output video resolution tier. |
| `aspect_ratio` | enum | いいえ | `"16:9"` | 16:9, 9:16, 1:1, 4:3, 3:4 | Aspect ratio of the generated video. |
| `duration` | enum | いいえ | `5` | 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 | Output video duration in seconds (2-15). |
| `seed` | object | いいえ | `-` | - | Random seed for reproducibility (0-2147483647). |
| `enable_safety_checker` | boolean | いいえ | `true` | - | Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked. |
| `prompt` | string | はい | `"A kitten running in a meadow, cinematic lighting, smooth camera movement."` | - | Text prompt describing the desired video. Max 5000 characters. |
| `negative_prompt` | object | いいえ | `"low resolution, errors, worst quality, low quality"` | - | Content to avoid in the video. Max 500 characters. |
| `enable_prompt_expansion` | boolean | いいえ | `true` | - | Enable intelligent prompt rewriting. |
| `audio_url` | object | いいえ | `-` | - | URL of driving audio. Supports WAV and MP3. Duration: 3-30s. Max 15 MB. If not provided, the model auto-generates matching background music. |
#### input フィールド
_このモデルのフィールド設定はありません。_
### Wan 2.7 Image to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Output video resolution tier. |
| `enable_prompt_expansion` | boolean | いいえ | `true` | - | Enable intelligent prompt rewriting. |
| `enable_safety_checker` | boolean | いいえ | `true` | - | Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked. |
| `negative_prompt` | object | いいえ | `"low resolution, errors, worst quality, low quality, incomplete, extra fingers, bad proportions, blurry, distorted"` | - | Content to avoid in the video. Max 500 characters. |
| `audio_url` | object | いいえ | `-` | - | URL of driving audio. Supports WAV and MP3. Duration: 2-30s. Max 15 MB. |
| `end_image_url` | object | いいえ | `-` | - | URL of the last frame image for first-and-last-frame-to-video. Same constraints as image_url. |
| `prompt` | object | いいえ | `"The massive humpback whale glides slowly through the deep blue water. It turns gracefully, its huge pectoral fin sweeping through the water like a wing. Sunbeams penetrate from above, illuminating the whale's textured skin. Small fish scatter. Awe-inspiring scale and grace."` | - | Text prompt describing the desired video. Max 5000 characters. |
| `duration` | enum | いいえ | `5` | 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 | Output video duration in seconds (2-15). |
| `image_url` | object | いいえ | `"https://v3b.fal.media/files/b/0a9413bb/qH6QY4JRzWxHOFKtCe70S_uPDJyzKZ.png"` | - | URL of the first frame image. Formats: JPEG, JPG, PNG, BMP, WEBP. Max 20 MB. |
| `seed` | object | いいえ | `-` | - | Random seed for reproducibility (0-2147483647). |
| `video_url` | object | いいえ | `-` | - | URL of a video clip to continue from. Format: MP4, MOV. Duration: 2-10s. Max 100 MB. Cannot be combined with image_url. |
#### input フィールド
_このモデルのフィールド設定はありません。_
### Wan 2.7 Reference to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `reference_video_urls` | object | いいえ | `-` | - | Reference video URLs for character/object appearance and motion. Pass multiple videos for multi-subject generation. Max 100 MB each. |
| `reference_image_urls` | object | いいえ | `-` | - | Reference image URLs for character/object appearance. Pass multiple images for multi-subject generation. Max 20 MB each. |
| `aspect_ratio` | enum | いいえ | `"16:9"` | 16:9, 9:16, 1:1, 4:3, 3:4 | Aspect ratio of the generated video. |
| `negative_prompt` | object | いいえ | `"low resolution, errors, worst quality, low quality"` | - | Content to avoid in the video. Max 500 characters. |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Output video resolution tier. |
| `prompt` | string | はい | `"A person walking through a beautiful garden, cinematic style."` | - | Text prompt describing the desired video. Max 5000 characters. |
| `duration` | enum | いいえ | `5` | 2, 3, 4, 5, 6, 7, 8, 9, 10 | Output video duration in seconds (2-10). |
| `multi_shots` | boolean | いいえ | `false` | - | When true, enables intelligent multi-shot segmentation. When false (default), generates a single continuous shot. |
| `seed` | object | いいえ | `-` | - | Random seed for reproducibility (0-2147483647). |
| `enable_safety_checker` | boolean | いいえ | `true` | - | Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked. |
#### input フィールド
_このモデルのフィールド設定はありません。_
### Wan 2.6 Text to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-6-text-to-video"` | wan/2-6-text-to-video | The model name to use for generation. Required field. - Must be `wan/2-6-text-to-video` for this endpoint |
| `input` | object | いいえ | `-` | - | Input parameters for the generation task |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | はい | `"In a hyperrealistic ASMR video, a hand uses a knitted knife to slowly slice a burger made entirely of knitted wool. The satisfyingly crisp cut reveals a detailed cross-section of knitted meat, lettuce, and tomato slices. Captured in a close-up with a shallow depth of field, the scene is set against a stark, matte black surface. Cinematic lighting makes the surreal yarn textures shine with clear reflections. The focus is on the deliberate, satisfying motion and the unique, tactile materials."` | - | Text prompts for video generation. Supports both Chinese and English, with a minimum of 1 characters and a maximum of 5,000 characters. (Max length: 5000 characters) |
| `duration` | enum | いいえ | `"5"` | 5, 10, 15 | The duration of the generated video in seconds |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Video resolution tier |
| `multi_shots` | boolean | いいえ | `false` | - | The multi shots parameter controls the shot composition style during AI video generation, determining whether the generated video is a single continuous shot or multiple shots with transitions. |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan 2.6 Image to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-6-image-to-video"` | wan/2-6-image-to-video | The model name to use for generation. Required field. - Must be `wan/2-6-image-to-video` for this endpoint |
| `input` | object | いいえ | `-` | - | Input parameters for the generation task |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | はい | `"Anthopmopric fox singing a Christmas song at the rubbish dump in the rain."` | - | Text prompts for video generation. Supports both Chinese and English, with a minimum of 2 characters and a maximum of 5,000 characters. (Max length: 5000 characters) |
| `image_urls` | string[] | はい | `["https://static.aiquickdraw.com/tools/example/1765957673717_awiBAidD.webp"]` | - | Upload an image file to use as input for the API (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB),All images must be at least 256x256px. |
| `duration` | enum | いいえ | `"5"` | 5, 10, 15 | The duration of the generated video in seconds |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Video resolution tier |
| `multi_shots` | boolean | いいえ | `false` | - | The multi shots parameter controls the shot composition style during AI video generation, determining whether the generated video is a single continuous shot or multiple shots with transitions. |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan 2.6 Video to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-6-video-to-video"` | wan/2-6-video-to-video | The model name to use for generation. Required field. - Must be `wan/2-6-video-to-video` for this endpoint |
| `input` | object | いいえ | `-` | - | Input parameters for the generation task |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | はい | `"The video drinks milk tea while doing some improvised dance moves to the music."` | - | Text prompts for video generation. Supports both Chinese and English, with a minimum of 2 characters and a maximum of 5,000 characters. (Max length: 5000 characters) |
| `video_urls` | string[] | はい | `["https://static.aiquickdraw.com/tools/example/1765957777782_cNJpvhRx.mp4"]` | - | The URL of the image used to generate video (File URL after upload, not file content; Accepted types: video/mp4, video/quicktime, video/x-matroska; Max size: 10.0MB) |
| `duration` | enum | いいえ | `"5"` | 5, 10 | The duration of the generated video in seconds |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Video resolution tier |
| `multi_shots` | boolean | いいえ | `false` | - | The multi shots parameter controls the shot composition style during AI video generation, determining whether the generated video is a single continuous shot or multiple shots with transitions. |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan 2.5 Text to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-5-text-to-video"` | wan/2-5-text-to-video | The model name used for generation. This field is required. - This endpoint must use the `wan/2-5-text-to-video` model |
| `input` | object | はい | `-` | - | Input parameters for the text-to-video task. |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | はい | `"A dimly lit jazz bar at night, wooden tables glowing under warm pendant lights. Patrons sip drinks and chat quietly while a three-piece band performs on stage. The saxophone player stands under a spotlight, gleaming instrument reflecting the light. No dialogue. Ambient audio: smooth live jazz music with saxophone and piano, clinking glasses, low murmur of audience conversations, occasional burst of laughter from a nearby table. Camera: slow pan across the crowd, then gentle zoom toward the saxophone player's solo, focusing on expressive hand movements."` | - | The text prompt for video generation. Supports Chinese and English. Maximum length: 800 characters. |
| `duration` | enum | はい | `"5"` | 5, 10 | The duration of the generated video in seconds. - `5`: 5 seconds
- `10`: 10 seconds |
| `aspect_ratio` | enum | いいえ | `"16:9"` | 16:9, 9:16, 1:1 | The aspect ratio of the generated video. - `16:9`: Landscape
- `9:16`: Portrait
- `1:1`: Square |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Video resolution tier. - `720p`: 720p
- `1080p`: 1080p |
| `negative_prompt` | string | いいえ | `-` | - | Negative prompt used to describe content to avoid. Maximum length: 500 characters. |
| `enable_prompt_expansion` | boolean | いいえ | `true` | - | Whether to enable prompt rewriting using LLM. Improves results for short prompts but increases processing time. - Boolean value: `true` / `false` |
| `seed` | number | いいえ | `-` | - | Random seed for reproducibility. If omitted, a random seed is chosen. |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan 2.5 Image to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-5-image-to-video"` | wan/2-5-image-to-video | The model name used for generation. This field is required. - This endpoint must use the `wan/2-5-image-to-video` model |
| `input` | object | はい | `-` | - | Input parameters for the image-to-video task. |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | はい | `"The same woman from the reference image looks directly into the camera, takes a breath, then smiles brightly and speaks with enthusiasm: \"Have you heard? Alibaba Wan 2.5 API is now available on AI Studio!\" Ambient audio: quiet indoor atmosphere, soft natural room tone. Camera: medium close-up, steady framing, natural daylight mood, accurate lip-sync with dialogue."` | - | The text prompt describing the desired video motion. Maximum length: 800 characters. |
| `image_url` | string | はい | `"https://file.aiquickdraw.com/custom-page/akr/section-images/1758796480945qb63zxq8.webp"` | - | URL of the image to use as the first frame. Must be publicly accessible. - Please provide the URL of the uploaded file, not raw file content
- Accepted types: `image/jpeg`, `image/png`, `image/webp`
- Max size: 10.0MB |
| `duration` | enum | はい | `"5"` | 5, 10 | The duration of the generated video in seconds. - `5`: 5 seconds
- `10`: 10 seconds |
| `resolution` | enum | いいえ | `"1080p"` | 720p, 1080p | Video resolution. Valid values: `720p`, `1080p`. |
| `negative_prompt` | string | いいえ | `-` | - | Negative prompt used to describe content to avoid. Maximum length: 500 characters. |
| `enable_prompt_expansion` | boolean | いいえ | `true` | - | Whether to enable prompt rewriting using LLM. - Boolean value: `true` / `false` |
| `seed` | number | いいえ | `-` | - | Random seed for reproducibility. If omitted, a random seed is chosen. |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan Text to Video
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-2-a14b-text-to-video-turbo"` | wan/2-2-a14b-text-to-video-turbo | The model name to use for generation. Required field. - Must be `wan/2-2-a14b-text-to-video-turbo` for this endpoint |
| `input` | object | いいえ | `-` | - | Input parameters for the generation task |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | はい | `"Drone shot, fast traversal, starting inside a cracked, frosty circular pipe. The camera bursts upward through the pipe to reveal a vast polar landscape bathed in golden sunrise light. Workers in orange suits operate steaming machinery. The camera tilts up, revealing the scene from the perspective of a rising hot air balloon. It continues ascending into a glowing sky, the balloon trailing steam and displaying the letters \"AI Studio\" as it rises into breathtaking polar majesty."` | - | The text prompt to guide video generation. (Max length: 5000 characters) |
| `resolution` | enum | いいえ | `"720p"` | 480p, 720p | Resolution of the generated video (480p or 720p). Default value: "720p" |
| `aspect_ratio` | enum | いいえ | `"16:9"` | 16:9, 9:16 | Aspect ratio of the generated video (16:9 or 9:16). Default value: "16:9" |
| `enable_prompt_expansion` | boolean | いいえ | `false` | - | Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning. (Boolean value (true/false)) |
| `seed` | number | いいえ | `0` | - | Random seed for reproducibility. If None, a random seed is chosen. (Min: 0, Max: 2147483647, Step: 1) (step: 1) |
| `acceleration` | enum | いいえ | `"none"` | none, regular | Acceleration level to use. The more acceleration, the faster the generation, but with lower quality. The recommended value is 'none'. Default value: "none" |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan 2.2 A14B Image to Video Turbo
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-2-a14b-image-to-video-turbo"` | wan/2-2-a14b-image-to-video-turbo | The model name to use for generation. Required field. - Must be `wan/2-2-a14b-image-to-video-turbo` for this endpoint |
| `input` | object | いいえ | `-` | - | Input parameters for the generation task |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `image_url` | string | はい | `"https://file.aiquickdraw.com/custom-page/akr/section-images/1755166042585gtf2mlrk.png"` | - | URL of the input image. If the input image does not match the chosen aspect ratio, it is resized and center cropped. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB) |
| `prompt` | string | はい | `"Overcast lighting, medium lens, soft lighting, low contrast lighting, edge lighting, low angle shot, desaturated colors, medium close-up shot, clean single shot, cool colors, center composition.The camera captures a low-angle close-up of a Western man outdoors, sharply dressed in a black coat over a gray sweater, white shirt, and black tie. His gaze is fixed on the lens as he advances. In the background, a brown building looms, its windows glowing with warm, yellow light above a dark doorway. As the camera pushes in, a blurred black object on the right side of the frame drifts back and forth, partially obscuring the view against a dark, nighttime background."` | - | The text prompt to guide video generation. (Max length: 5000 characters) |
| `resolution` | enum | いいえ | `"720p"` | 480p, 720p | Resolution of the generated video (480p or 720p). Default value: "720p" |
| `enable_prompt_expansion` | boolean | いいえ | `false` | - | Whether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning. (Boolean value (true/false)) |
| `seed` | number | いいえ | `0` | - | Random seed for reproducibility. If None, a random seed is chosen. (Min: 0, Max: 2147483647, Step: 1) (step: 1) |
| `acceleration` | enum | いいえ | `"none"` | none, regular | Acceleration level to use. The more acceleration, the faster the generation, but with lower quality. The recommended value is 'none'. Default value: "none" |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan 2.2 A14B Speech to Video Turbo
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-2-a14b-speech-to-video-turbo"` | wan/2-2-a14b-speech-to-video-turbo | The model name to use for generation. Required field. - Must be `wan/2-2-a14b-speech-to-video-turbo` for this endpoint |
| `input` | object | いいえ | `-` | - | Input parameters for the generation task |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `prompt` | string | はい | `"The lady is talking"` | - | The text prompt used for video generation (Max length: 5000 characters) |
| `image_url` | string | はい | `"https://file.aiquickdraw.com/custom-page/akr/section-images/1756797663082u4pjmcrq.png"` | - | URL of the input image. If the input image does not match the chosen aspect ratio, it is resized and center cropped (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB) |
| `audio_url` | string | はい | `"https://file.aiquickdraw.com/custom-page/akr/section-images/17567977044127d1emlmc.mp3"` | - | The URL of the audio file (File URL after upload, not file content; Accepted types: audio/mp3, audio/wav, audio/ogg, audio/m4a, audio/flac, audio/aac, audio/x-ms-wma, audio/mpeg; Max size: 10.0MB) |
| `num_frames` | number | いいえ | `80` | - | Number of frames to generate. Must be between 40 to 120, (must be multiple of 4) (Min: 40, Max: 120, Step: 4) (step: 4) |
| `frames_per_second` | number | いいえ | `16` | - | Frames per second of the generated video. Must be between 4 to 60. When using interpolation and adjust_fps_for_interpolation is set to true (default true,) the final FPS will be multiplied by the number of interpolated frames plus one. For example, if the generated frames per second is 16 and the number of interpolated frames is 1, the final frames per second will be 32. If adjust_fps_for_interpolation is set to false, this value will be used as-is (Min: 4, Max: 60, Step: 1) (step: 1) |
| `resolution` | enum | いいえ | `"480p"` | 480p, 580p, 720p | Resolution of the generated video (480p, 580p, or 720p) |
| `negative_prompt` | string | いいえ | `""` | - | Negative prompt for video generation (Max length: 500 characters) |
| `seed` | number | いいえ | `-` | - | Random seed for reproducibility. If None, a random seed is chosen |
| `num_inference_steps` | number | いいえ | `27` | - | Number of inference steps for sampling. Higher values give better quality but take longer (Min: 2, Max: 40, Step: 1) (step: 1) |
| `guidance_scale` | number | いいえ | `3.5` | - | Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality (Min: 1, Max: 10, Step: 0.1) (step: 0.1) |
| `shift` | number | いいえ | `5` | - | Shift value for the video. Must be between 1.0 and 10.0 (Min: 1, Max: 10, Step: 0.1) (step: 0.1) |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan Animate Move
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-2-animate-move"` | wan/2-2-animate-move | The model name to use for generation. Required field. - Must be `wan/2-2-animate-move` for this endpoint |
| `input` | object | いいえ | `-` | - | Input parameters for the generation task |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `video_url` | string | はい | `"https://file.aiquickdraw.com/custom-page/akr/section-images/17586254974931y2hottk.mp4"` | - | URL of the input video. (File URL after upload, not file content; Accepted types: video/mp4, video/quicktime, video/x-matroska; Max size: 10.0MB) |
| `image_url` | string | はい | `"https://file.aiquickdraw.com/custom-page/akr/section-images/1758625466310wpehpbnf.png"` | - | URL of the input image. If the input image does not match the chosen aspect ratio, it is resized and center cropped. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB) |
| `resolution` | enum | いいえ | `"480p"` | 480p, 580p, 720p | Resolution of the generated video (480p, 580p, or 720p). |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
### Wan Animate Replace
#### Payload フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `model` | enum | はい | `"wan/2-2-animate-replace"` | wan/2-2-animate-replace | The model name to use for generation. Required field. - Must be `wan/2-2-animate-replace` for this endpoint |
| `input` | object | いいえ | `-` | - | Input parameters for the generation task |
#### input フィールド
| フィールド | タイプ | 必須 | デフォルト / 例 | 選択肢 | 説明 |
| --- | --- | --- | --- | --- | --- |
| `video_url` | string | はい | `"https://file.aiquickdraw.com/custom-page/akr/section-images/17586199429271xscyd5d.mp4"` | - | URL of the input video. (File URL after upload, not file content; Accepted types: video/mp4, video/quicktime, video/x-matroska; Max size: 10.0MB) |
| `image_url` | string | はい | `"https://file.aiquickdraw.com/custom-page/akr/section-images/17586199255323tks43kq.png"` | - | URL of the input image. If the input image does not match the chosen aspect ratio, it is resized and center cropped. (File URL after upload, not file content; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB) |
| `resolution` | enum | いいえ | `"480p"` | 480p, 580p, 720p | Resolution of the generated video (480p, 580p, or 720p). |
| `nsfw_checker` | boolean | いいえ | `-` | - | Defaults to false. You can set it to false based on your needs. If set to false, our content filtering will be disabled, and all results will be returned directly by the model itself.
Note: There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements. |
## 価格
生成タスクの作成時にクレジットが予約されます。作成レスポンスの `reservedCredits` が、そのリクエストで予約されたクレジット数です。
| モデル | タイプ | 仕様 | 価格 | 課金 |
| --- | --- | --- | --- | --- |
| Wan 3.0 Video | テキスト/画像から動画 | 480P | 8 クレジット/秒 | 出力秒数 × 8 |
| Wan 3.0 Video | テキスト/画像から動画 | 720P | 16 クレジット/秒 | 出力秒数 × 16 |
| Wan 3.0 Video | テキスト/画像から動画 | 1080P | 32 クレジット/秒 | 出力秒数 × 32 |
| Wan 3.0 Video Prime | テキスト/画像から動画 | 480P | 12.2 クレジット/秒 | 出力秒数 × 12.2 |
| Wan 3.0 Video Prime | テキスト/画像から動画 | 720P | 25.2 クレジット/秒 | 出力秒数 × 25.2 |
| Wan 3.0 Video Prime | テキスト/画像から動画 | 1080P | 50.4 クレジット/秒 | 出力秒数 × 50.4 |
| Wan 3.0 Text to Video | テキストから動画 | 480p | 10 クレジット/秒 | 出力秒数 × 10 |
| Wan 3.0 Text to Video | テキストから動画 | 720p | 20 クレジット/秒 | 出力秒数 × 20 |
| Wan 3.0 Text to Video | テキストから動画 | 1080p | 40 クレジット/秒 | 出力秒数 × 40 |
| Wan 3.0 Image to Video | 画像から動画 | 480p | 10 クレジット/秒 | 出力秒数 × 10 |
| Wan 3.0 Image to Video | 画像から動画 | 720p | 20 クレジット/秒 | 出力秒数 × 20 |
| Wan 3.0 Image to Video | 画像から動画 | 1080p | 40 クレジット/秒 | 出力秒数 × 40 |
| Wan 3.0 Reference to Video | テキスト/画像から動画 | 480p | 10 クレジット/秒 | 出力秒数 × 10 |
| Wan 3.0 Reference to Video | テキスト/画像から動画 | 720p | 20 クレジット/秒 | 出力秒数 × 20 |
| Wan 3.0 Reference to Video | テキスト/画像から動画 | 1080p | 40 クレジット/秒 | 出力秒数 × 40 |
| Wan 3.0 Prime Text to Video | テキストから動画 | 480p | 14 クレジット/秒 | 出力秒数 × 14 |
| Wan 3.0 Prime Text to Video | テキストから動画 | 720p | 28 クレジット/秒 | 出力秒数 × 28 |
| Wan 3.0 Prime Text to Video | テキストから動画 | 1080p | 56 クレジット/秒 | 出力秒数 × 56 |
| Wan 3.0 Prime Image to Video | 画像から動画 | 480p | 14 クレジット/秒 | 出力秒数 × 14 |
| Wan 3.0 Prime Image to Video | 画像から動画 | 720p | 28 クレジット/秒 | 出力秒数 × 28 |
| Wan 3.0 Prime Image to Video | 画像から動画 | 1080p | 56 クレジット/秒 | 出力秒数 × 56 |
| Wan 3.0 Prime Reference to Video | テキスト/画像から動画 | 480p | 14 クレジット/秒 | 出力秒数 × 14 |
| Wan 3.0 Prime Reference to Video | テキスト/画像から動画 | 720p | 28 クレジット/秒 | 出力秒数 × 28 |
| Wan 3.0 Prime Reference to Video | テキスト/画像から動画 | 1080p | 56 クレジット/秒 | 出力秒数 × 56 |
| Wan 2.7 Text to Video | テキストから動画 | 720p | 16 クレジット/秒 | 出力秒数 × 16 |
| Wan 2.7 Text to Video | テキストから動画 | 1080p | 24 クレジット/秒 | 出力秒数 × 24 |
| Wan 2.7 Image to Video | 画像から動画 | 720p | 16 クレジット/秒 | 出力秒数 × 16 |
| Wan 2.7 Image to Video | 画像から動画 | 1080p | 24 クレジット/秒 | 出力秒数 × 24 |
| Wan 2.7 Video Edit | テキスト/画像から動画 | 720p | 16 クレジット/秒 | 出力秒数 × 16 |
| Wan 2.7 Video Edit | テキスト/画像から動画 | 1080p | 24 クレジット/秒 | 出力秒数 × 24 |
| Wan 2.7 Reference to Video | テキスト/画像から動画 | 720p | 16 クレジット/秒 | 出力秒数 × 16 |
| Wan 2.7 Reference to Video | テキスト/画像から動画 | 1080p | 24 クレジット/秒 | 出力秒数 × 24 |
| Wan 2.7 Text to Video | テキストから動画 | 720p | 20 クレジット/秒 | 出力秒数 × 20 |
| Wan 2.7 Text to Video | テキストから動画 | 1080p | 30 クレジット/秒 | 出力秒数 × 30 |
| Wan 2.7 Image to Video | 画像から動画 | 720p | 20 クレジット/秒 | 出力秒数 × 20 |
| Wan 2.7 Image to Video | 画像から動画 | 1080p | 30 クレジット/秒 | 出力秒数 × 30 |
| Wan 2.7 Reference to Video | テキスト/画像から動画 | - | 20 クレジット/秒 | 出力秒数 × 20 |
| Wan 2.6 Text to Video | テキストから動画 | 720p | 70 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Text to Video | テキストから動画 | 720p | 140 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Text to Video | テキストから動画 | 720p | 210 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Text to Video | テキストから動画 | 1080p | 105 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Text to Video | テキストから動画 | 1080p | 210 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Text to Video | テキストから動画 | 1080p | 315 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Image to Video | 画像から動画 | 720p | 70 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Image to Video | 画像から動画 | 720p | 140 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Image to Video | 画像から動画 | 720p | 210 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Image to Video | 画像から動画 | 1080p | 105 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Image to Video | 画像から動画 | 1080p | 210 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Image to Video | 画像から動画 | 1080p | 315 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Video to Video | テキスト/画像から動画 | 720p | 70 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Video to Video | テキスト/画像から動画 | 720p | 140 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Video to Video | テキスト/画像から動画 | 1080p | 105 クレジット | 生成ごとの固定価格 |
| Wan 2.6 Video to Video | テキスト/画像から動画 | 1080p | 210 クレジット | 生成ごとの固定価格 |
| Wan 2.5 Text to Video | テキストから動画 | 720p | 12 クレジット/秒 | 出力秒数 × 12 |
| Wan 2.5 Text to Video | テキストから動画 | 1080p | 20 クレジット/秒 | 出力秒数 × 20 |
| Wan 2.5 Image to Video | 画像から動画 | 720p | 12 クレジット/秒 | 出力秒数 × 12 |
| Wan 2.5 Image to Video | 画像から動画 | 1080p | 20 クレジット/秒 | 出力秒数 × 20 |
| Wan Text to Video | テキストから動画 | 480p | 8 クレジット | 生成ごとの固定価格 |
| Wan Text to Video | テキストから動画 | 720p | 16 クレジット | 生成ごとの固定価格 |
| Wan 2.2 A14B Image to Video Turbo | 画像から動画 | 480p | 8 クレジット | 生成ごとの固定価格 |
| Wan 2.2 A14B Image to Video Turbo | 画像から動画 | 720p | 16 クレジット | 生成ごとの固定価格 |
| Wan 2.2 A14B Speech to Video Turbo | テキスト/画像から動画 | 480p | 12 クレジット/秒 | 出力秒数 × 12 |
| Wan 2.2 A14B Speech to Video Turbo | テキスト/画像から動画 | 580p | 18 クレジット/秒 | 出力秒数 × 18 |
| Wan 2.2 A14B Speech to Video Turbo | テキスト/画像から動画 | 720p | 24 クレジット/秒 | 出力秒数 × 24 |
| Wan Animate Move | テキスト/画像から動画 | 480p | 6 クレジット | 生成ごとの固定価格 |
| Wan Animate Move | テキスト/画像から動画 | 580p | 10 クレジット | 生成ごとの固定価格 |
| Wan Animate Move | テキスト/画像から動画 | 720p | 13 クレジット | 生成ごとの固定価格 |
| Wan Animate Replace | テキスト/画像から動画 | 480p | 6 クレジット | 生成ごとの固定価格 |
| Wan Animate Replace | テキスト/画像から動画 | 580p | 10 クレジット | 生成ごとの固定価格 |
| Wan Animate Replace | テキスト/画像から動画 | 720p | 13 クレジット | 生成ごとの固定価格 |
## 一般的なエラー
| ステータス | 意味 |
| --- | --- |
| `400` | Invalid request payload |
| `401` | Missing or invalid API key |
| `402` | Insufficient credits or plan limit |
| `404` | Model or task not found |
| `429` | Rate limit exceeded |
| `500` | Server error |