> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Wan3.0 全パラメータガイド > Wan 3.0（オールラウンド参照動画）統合 API。`model` パラメータでモードを選択します **3 種類の生成モード：** - **Text-to-Video**（`wan3.0-text-to-video`）：テキストプロンプトのみで動画を生成 - **Image-to-Video**（`wan3.0-image-to-video`）：先頭フレーム / 先頭・末尾フレームで画の開始と終了を厳密に制御 - **Reference-to-Video**（`wan3.0-reference-video`）：参照画像 + 参照動画 + 参照音声 + ファイル / ウェブページのマルチモーダル混合参照 **共通機能：** - 最長 **30 秒**の動画を生成可能 - 非同期処理モード、返却されたタスク ID で[ステータスを照会](/ja/api-manual/task-management/get-task-detail) - 生成された動画リンクの有効期間は 24 時間です。お早めに保存してください ## 課金について - **課金式**：課金時間 = 入力動画の長さ + 出力動画の長さ、秒単位で課金 - **解像度倍率**：`480p` = 1x（基準）、`720p` = 2x、`1080p` = 4x - 参照画像、参照音声、参照ファイル、ウェブページのリンクは**いずれも課金対象外** - `duration` に `-1`（スマート時間）を指定した場合は上限の `30` 秒で満額を事前確保し、タスク成功後に実際の出力時間で精算、差額は自動的に返却されます - `audio` トラックのオン/オフで**価格は同じ**です - **タスク失敗時は課金されず**、凍結された金額は全額返却されます ## OpenAPI ````yaml ja/api-manual/video-series/wan3.0/wan3.0-overview.json POST /v1/videos/generations openapi: 3.1.0 info: title: Wan3.0 全モデル API description: Wan 3.0 オールラウンド参照動画生成。単一の API でテキストから動画、画像から動画、参照から動画の三つのモードをカバーします license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: 本番環境 security: - bearerAuth: [] tags: - name: 動画生成 description: AI動画生成関連API paths: /v1/videos/generations: post: tags: - 動画生成 summary: Wan3.0 全モデル API description: >- Wan 3.0（オールラウンド参照動画）統合 API。`model` パラメータでモードを選択します **3 種類の生成モード：** - **Text-to-Video**（`wan3.0-text-to-video`）：テキストプロンプトのみで動画を生成 - **Image-to-Video**（`wan3.0-image-to-video`）：先頭フレーム / 先頭・末尾フレームで画の開始と終了を厳密に制御 - **Reference-to-Video**（`wan3.0-reference-video`）：参照画像 + 参照動画 + 参照音声 + ファイル / ウェブページのマルチモーダル混合参照 **共通機能：** - 最長 **30 秒**の動画を生成可能 - 非同期処理モード、返却されたタスク ID で[ステータスを照会](/ja/api-manual/task-management/get-task-detail) - 生成された動画リンクの有効期間は 24 時間です。お早めに保存してください ## 課金について - **課金式**：課金時間 = 入力動画の長さ + 出力動画の長さ、秒単位で課金 - **解像度倍率**：`480p` = 1x（基準）、`720p` = 2x、`1080p` = 4x - 参照画像、参照音声、参照ファイル、ウェブページのリンクは**いずれも課金対象外** - `duration` に `-1`（スマート時間）を指定した場合は上限の `30` 秒で満額を事前確保し、タスク成功後に実際の出力時間で精算、差額は自動的に返却されます - `audio` トラックのオン/オフで**価格は同じ**です - **タスク失敗時は課金されず**、凍結された金額は全額返却されます operationId: createWan30Video requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: text_to_video: summary: テキストから動画 value: model: wan3.0-text-to-video prompt: >- A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work. duration: 5 quality: 720p aspect_ratio: '16:9' generate_audio: true image_to_video: summary: 画像から動画（先頭/末尾フレーム） value: model: wan3.0-image-to-video prompt: >- A young girl's smile gradually turns into a big laugh, the camera slowly pushes in, and the background light shifts from cool tones to warm tones. image_start: https://example.com/first_frame.jpg image_end: https://example.com/last_frame.jpg duration: 5 quality: 720p reference_to_video: summary: 参照から動画（マルチモーダル素材） value: model: wan3.0-reference-video prompt: >- The character in Video 1 holds Image 3 and plays a soft country folk tune on the chair in Image 4, saying: “What lovely sunshine today.” image_urls: - https://example.com/role.jpg - https://example.com/object.png - https://example.com/guitar.png - https://example.com/chair.png video_urls: - https://example.com/ref_role.mp4 duration: 10 quality: 720p aspect_ratio: adaptive smart_duration: summary: スマート時間（長さはモデルが決定） value: model: wan3.0-text-to-video prompt: >- A high-end smart glasses product ad, minimalist and futuristic, the camera glides over the lens and hinge details and finally settles on the brand logo. duration: -1 quality: 1080p aspect_ratio: '16:9' responses: '200': description: 動画生成タスクの作成に成功 content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: リクエストパラメータが不正です content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_parameter message: Invalid request parameters type: invalid_request_error '401': description: 未認証、トークンが無効または期限切れです content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: クォータ不足のため、チャージが必要です content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: アクセスが拒否されました content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: wan3.0-text-to-video' type: invalid_request_error '429': description: レート制限を超えました content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: サーバー内部エラー content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: VideoGenerationRequest: type: object required: - model properties: model: type: string description: 動画生成モデル名 enum: - wan3.0-text-to-video - wan3.0-image-to-video - wan3.0-reference-video example: wan3.0-text-to-video prompt: type: string description: >- 動画生成のテキストプロンプト。中国語と英語に対応し、**漢字/アルファベットはそれぞれ 1 文字としてカウント**、最大長は `20000` 文字で、超過分は自動的に切り捨てられます（エラーにはなりません） **必須かどうか：** `wan3.0-text-to-video` は必須。`wan3.0-reference-video` は参照素材と合わせて少なくともどちらか一方が必要。`wan3.0-image-to-video` では画面の変化を記述するために指定を推奨 **素材の指定ルール（参照から動画）：** - 「画像1」「動画1」「音声1」で対応する配列内の素材を指定します（1 始まり） - 画像・動画・音声は**それぞれ独立してカウント**されるため、「画像1」と「動画1」が同時に存在できます example: >- The character in Video 1 holds Image 3 and plays a soft country folk tune on the chair in Image 4, saying: “What lovely sunshine today.” image_start: type: string format: uri description: >- 先頭フレーム画像 URL。生成される動画の最初のフレームとして厳密に使用されます。**`wan3.0-image-to-video` でのみ利用可能** **画像制限：** - フォーマット：JPEG、JPG、PNG（透明非対応）、BMP、WEBP - 解像度：幅・高さが `[240, 8000]` ピクセル - アスペクト比：1:8 ~ 8:1 - ファイルサイズ：`20MB` 以下 example: https://example.com/first_frame.jpg image_end: type: string format: uri description: >- 末尾フレーム画像 URL。生成される動画の最後のフレームとして厳密に使用されます。**`wan3.0-image-to-video` でのみ利用可能** **制約：** `image_start` と組み合わせて使用する必要があり、末尾フレームのみの指定はできません。 **画像制限：** - フォーマット：JPEG、JPG、PNG（透明非対応）、BMP、WEBP - 解像度：幅・高さが `[240, 8000]` ピクセル - アスペクト比：1:8 ~ 8:1 - ファイルサイズ：`20MB` 以下 example: https://example.com/last_frame.jpg image_urls: type: array items: type: string format: uri maxItems: 10 description: >- 参照画像 URL の配列、**最大 10 枚**、**`wan3.0-reference-video` でのみ利用可能**。主体（人物/動物/物体）またはシーン背景を指定できます。主体を含む場合、各画像には**単一**のキャラクターのみ含めることを推奨 配列の順序はプロンプト内の「画像1、画像2……」に対応します **注意：** 画像から動画の先頭/末尾フレームには `image_start` / `image_end` を使用し、本フィールドは使用しないでください **画像制限：** - フォーマット：JPEG、JPG、PNG（透明非対応）、BMP、WEBP - 解像度：幅・高さが `[240, 8000]` ピクセル - アスペクト比：1:8 ~ 8:1 - ファイルサイズ：`20MB` 以下 example: - https://example.com/ref1.jpg - https://example.com/ref2.png video_urls: type: array items: type: string format: uri maxItems: 5 description: >- 参照動画 URL の配列、**最大 5 本**、**`wan3.0-reference-video` でのみ利用可能**。配列の順序はプロンプト内の「動画1、動画2……」に対応します **長さの制限：** - 各クリップ `1 ~ 15` 秒 - **合計 15 秒以内** - 参照動画の合計時間 + 出力動画の長さは **30 秒を超えられません** **🔴 参照動画は課金対象です**：課金時間 = 入力動画の長さ + 出力動画の長さ。参照画像、参照音声、ファイル、ウェブページはいずれも課金されません **動画制限：** - フォーマット：mp4、mov - 解像度：幅・高さが `[240, 4096]` ピクセル - アスペクト比：1:8 ~ 8:1 - ファイル単体のサイズ：`100MB` 以下 example: - https://example.com/ref_video.mp4 audio_urls: type: array items: type: string format: uri maxItems: 5 description: >- 参照音声 URL の配列、**最大 5 本**、**`wan3.0-reference-video` でのみ利用可能**。配列の順序はプロンプト内の「音声1、音声2……」に対応します **⚠️ Wan2.7 とは意味が異なります：** Wan2.7 の `audio_urls` は特定の参照画像/参照動画に紐づく**声質**でしたが、Wan3.0 の参照音声は**独立した素材**で、プロンプトから「音声1」で直接指定します。`model_params.voice_bindings` の声質バインディングプロトコルは**サポートされません**。Wan2.7 から移行する際は書き換えにご注意ください。 **長さの制限：** - 各クリップ `1 ~ 15` 秒、合計 15 秒以内 - 参照音声は**課金されません** **音声制限：** - フォーマット：wav、mp3 - ファイルサイズ：`15MB` 以下 example: - https://example.com/ref_audio.mp3 duration: type: integer description: >- 生成する動画の長さ（秒）、デフォルトは `5` **指定できる値：** - `2` ～ `30` の任意の整数 - `-1`：スマート時間。プロンプトと入力素材に基づきモデルが出力の長さを自動的に決定します **スマート時間の課金方法：** 送信時点ではモデルがどれだけの長さを生成するか分からないため、上限の `30` 秒で**満額を事前確保**し、タスク成功後に実際の出力時間で精算、多く凍結した分は自動的に返却されます。残高が満額の事前確保を賄えない場合は、明示的な秒数を指定してください。 **参照動画を渡す場合の追加制約：** - 参照動画の合計時間 + 出力動画の長さは **30 秒を超えられません** - 例：参照動画が合計 10 秒の場合、`duration` は最大 20 までです default: 5 example: 5 quality: type: string description: |- 動画の解像度、デフォルトは `720p` **選択肢：** - `480p`：解像度は低め、価格は最安（課金の基準） - `720p`：標準解像度、デフォルト値。価格は `480p` の 2 倍 - `1080p`：高解像度、価格は `480p` の 4 倍 enum: - 480p - 720p - 1080p default: 720p example: 720p aspect_ratio: type: string description: |- 動画のアスペクト比、デフォルトは `adaptive` **選択肢：** - `adaptive`：自動。入力素材の比率とプロンプトの意図からモデルが適切なアスペクト比を推奨します。デフォルト値 - `16:9`（横向き）、`9:16`（縦向き）、`1:1`（正方形）、`4:3`、`3:4` enum: - adaptive - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' default: adaptive example: '16:9' generate_audio: type: boolean description: |- 出力動画に音声トラックを含めるかどうか、デフォルトは `true` **選択肢：** - `true`：出力動画に音（人の声、効果音、BGM）を含めます。デフォルト値 - `false`：無音の動画を出力します **音のオン/オフで価格は同じ**で、追加料金はかかりません。 default: true example: true seed: type: integer description: |- ランダムシード。生成結果の再現に使用します。デフォルトはランダム **説明：** - 範囲：`0` ～ `2147483647` - シードを固定するとプロンプト調整時の変動を抑え、再現性が向上します minimum: 0 maximum: 2147483647 example: 42 model_params: type: object description: >- モデル拡張パラメータ、**`wan3.0-reference-video` でのみ利用可能**。`file_url` と `link_url` は**排他**で、どちらか一方のみ指定できます properties: file_url: type: string format: uri description: >- 参照ファイル URL、**最大 1 個**。モデルがファイルの内容を自動的に理解し、それに基づいて動画を生成します（例：製品の PPT を製品紹介動画に変換） **`link_url` と排他**で、両方を同時に渡すことはできません **ファイル制限：** - フォーマット：docx、doc、xlsx、xls、pptx、ppt、pdf、txt、key、pages、numbers、md - ファイルサイズ：`100MB` 以下 - ページ数：50 ページ以下 example: https://example.com/product-deck.pptx link_url: type: string format: uri description: |- 参照ウェブページのリンク、**最大 1 個**。モデルが自動的にページを取得・理解したうえで動画を生成します **`file_url` と排他**で、両方を同時に渡すことはできません **制限：** **ログイン不要**の公開ページ（ニュース、ブログ、公式アカウントの記事など）のみ解析できます example: https://example.com/article/12345 callback_url: type: string description: >- タスク完了後の HTTPS コールバックアドレス **コールバックタイミング：** - タスク完了（completed）、失敗（failed）、またはキャンセル（cancelled）時にトリガー - 課金確認完了後に送信 **セキュリティ制限：** - 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 ステータスコードを成功とみなし、その他のステータスコードでリトライをトリガー format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: タスク作成タイムスタンプ example: 1761313744 id: type: string description: タスク ID example: task-unified-1774857405-abc123 model: type: string description: 実際に使用されたモデル名 example: wan3.0-text-to-video object: type: string enum: - video.generation.task description: タスクタイプ progress: type: integer description: タスク進捗率（0-100） minimum: 0 maximum: 100 example: 0 status: type: string description: タスクステータス enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: 動画タスクの詳細情報 type: type: string enum: - text - image - audio - video description: タスク出力タイプ example: video usage: $ref: '#/components/schemas/VideoUsage' description: 使用量と課金情報 ErrorResponse: type: object properties: error: type: object properties: code: type: string description: エラーコード識別子 message: type: string description: エラーの説明 type: type: string description: エラータイプ VideoTaskInfo: type: object properties: can_cancel: type: boolean description: タスクをキャンセルできるかどうか example: true estimated_time: type: integer description: 推定完了時間（秒） minimum: 0 example: 165 video_duration: type: integer description: 動画の再生時間（秒） example: 8 VideoUsage: type: object description: 使用量と課金情報 properties: billing_rule: type: string description: 課金ルール enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: 推定消費クレジット minimum: 0 example: 50 user_group: type: string description: ユーザーグループカテゴリ example: default securitySchemes: bearerAuth: type: http scheme: bearer description: |- ##すべてのAPIはBearer Tokenによる認証が必要です## **APIキーの取得：** [APIキー管理ページ](https://evolink.ai/dashboard/keys) にアクセスしてAPIキーを取得してください **リクエストヘッダーに以下を追加：** ``` Authorization: Bearer YOUR_API_KEY ``` ````