> ## 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 Reference-to-Video 参照から動画 > - 参照画像 / 参照動画 / 参照音声 / ファイル / ウェブページを素材として、モデルが意図を自動的に理解したうえで動画を生成します - プロンプト内では「画像1」「動画1」「音声1」で対応する素材を指定します。**三種類の素材はそれぞれ独立してカウント**されます - `prompt` と参照素材は**少なくともどちらか一方が必要**です - **先頭/末尾フレームは受け付けません**（`image_start` / `image_end`）：参照素材と先頭/末尾フレームは排他です。開始と終了の画を厳密に制御したい場合は [Wan3.0 画像から動画](/ja/api-manual/video-series/wan3.0/wan3.0-image-to-video) をご利用ください - **🔴 参照動画は課金対象**で、参照画像 / 参照音声 / ファイル / ウェブページは課金されません - 非同期処理モード、返却されたタスク 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-reference-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: Wan3.0 Reference-to-Video API description: Wan 3.0 参照から動画生成。参照画像、参照動画、参照音声、ファイル、ウェブページのマルチモーダル混合入力に対応 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 Reference-to-Video 参照から動画 description: >- - 参照画像 / 参照動画 / 参照音声 / ファイル / ウェブページを素材として、モデルが意図を自動的に理解したうえで動画を生成します - プロンプト内では「画像1」「動画1」「音声1」で対応する素材を指定します。**三種類の素材はそれぞれ独立してカウント**されます - `prompt` と参照素材は**少なくともどちらか一方が必要**です - **先頭/末尾フレームは受け付けません**（`image_start` / `image_end`）：参照素材と先頭/末尾フレームは排他です。開始と終了の画を厳密に制御したい場合は [Wan3.0 画像から動画](/ja/api-manual/video-series/wan3.0/wan3.0-image-to-video) をご利用ください - **🔴 参照動画は課金対象**で、参照画像 / 参照音声 / ファイル / ウェブページは課金されません - 非同期処理モード、返却されたタスク ID で[ステータスを照会](/ja/api-manual/task-management/get-task-detail) - 生成された動画リンクの有効期間は 24 時間です。お早めに保存してください ## 課金について - **課金式**：課金時間 = 入力動画の長さ + 出力動画の長さ、秒単位で課金 - **解像度倍率**：`480p` = 1x（基準）、`720p` = 2x、`1080p` = 4x - 参照画像、参照音声、参照ファイル、ウェブページのリンクは**いずれも課金対象外** - `duration` に `-1`（スマート時間）を指定した場合は上限の `30` 秒で満額を事前確保し、タスク成功後に実際の出力時間で精算、差額は自動的に返却されます - `audio` トラックのオン/オフで**価格は同じ**です - **タスク失敗時は課金されず**、凍結された金額は全額返却されます operationId: createWan30ReferenceVideo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: multi_modal: 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 with_audio: summary: 参照音声あり value: model: wan3.0-reference-video prompt: >- The character in Image 1 dances to the rhythm of Audio 1, with the camera orbiting around them. image_urls: - https://example.com/dancer.jpg audio_urls: - https://example.com/beat.mp3 duration: 10 from_file: summary: 参照ファイルから動画（PPT を紹介動画に） value: model: wan3.0-reference-video prompt: >- Turn this product deck into a high-end product ad, minimalist, futuristic and upmarket overall, with restrained lighting. model_params: file_url: https://example.com/product-deck.pptx duration: 10 quality: 1080p aspect_ratio: '16:9' from_link: summary: 参照ウェブページから動画 value: model: wan3.0-reference-video prompt: >- Turn the key points of this article into a short infographic-style video. model_params: link_url: https://example.com/article/12345 duration: 15 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-reference-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: モデル名。`wan3.0-reference-video` で固定 enum: - wan3.0-reference-video example: wan3.0-reference-video default: wan3.0-reference-video prompt: type: string description: >- 動画生成のテキストプロンプト。中国語と英語に対応し、**漢字/アルファベットはそれぞれ 1 文字としてカウント**、最大長は `20000` 文字で、超過分は自動的に切り捨てられます（エラーにはなりません） **素材の指定ルール：** - 「画像1、画像2」で `image_urls` 内の対応する順序の画像を指定します（1 始まり） - 「動画1、動画2」で `video_urls` 内の対応する順序の動画を指定します - 「音声1、音声2」で `audio_urls` 内の対応する順序の音声を指定します - **画像・動画・音声はそれぞれ独立してカウント**されるため、「画像1」と「動画1」が同時に存在できます - 英語のプロンプトでは "Image 1"、"Video 1"、"Audio 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_urls: type: array items: type: string format: uri maxItems: 10 description: >- 参照画像 URL の配列、**最大 10 枚**。主体（人物/動物/物体）またはシーン背景を指定できます。主体を含む場合、各画像には**単一**のキャラクターのみ含めることを推奨 配列の順序はプロンプト内の「画像1、画像2……」に対応します。 **画像制限：** - フォーマット：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 本**。配列の順序はプロンプト内の「動画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 本**。配列の順序はプロンプト内の「音声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 model_params: type: object description: モデル拡張パラメータ。`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 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 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-reference-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 ``` ````