> ## 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 Image-to-Video 画像から動画 > - `image_start` を渡して動画の**先頭フレーム**を厳密に指定します。さらに `image_end` を渡すと**末尾フレーム**も同時に厳密指定できます - **参照素材は受け付けません**（参照動画 / 参照音声 / ファイル / ウェブページ）：先頭/末尾フレームと参照素材は排他です。参照を組み合わせたい場合は [Wan3.0 参照から動画](/ja/api-manual/video-series/wan3.0/wan3.0-reference-video) をご利用ください - 画像は最大 2 枚（先頭フレーム + 末尾フレーム）。3 枚以上の参照画像が必要な場合は参照から動画をご利用ください - 非同期処理モード、返却されたタスク 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-image-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: Wan3.0 Image-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 Image-to-Video 画像から動画 description: >- - `image_start` を渡して動画の**先頭フレーム**を厳密に指定します。さらに `image_end` を渡すと**末尾フレーム**も同時に厳密指定できます - **参照素材は受け付けません**（参照動画 / 参照音声 / ファイル / ウェブページ）：先頭/末尾フレームと参照素材は排他です。参照を組み合わせたい場合は [Wan3.0 参照から動画](/ja/api-manual/video-series/wan3.0/wan3.0-reference-video) をご利用ください - 画像は最大 2 枚（先頭フレーム + 末尾フレーム）。3 枚以上の参照画像が必要な場合は参照から動画をご利用ください - 非同期処理モード、返却されたタスク ID で[ステータスを照会](/ja/api-manual/task-management/get-task-detail) - 生成された動画リンクの有効期間は 24 時間です。お早めに保存してください ## 課金について - **課金式**：課金時間 = 入力動画の長さ + 出力動画の長さ、秒単位で課金 - **解像度倍率**：`480p` = 1x（基準）、`720p` = 2x、`1080p` = 4x - 参照画像、参照音声、参照ファイル、ウェブページのリンクは**いずれも課金対象外** - `duration` に `-1`（スマート時間）を指定した場合は上限の `30` 秒で満額を事前確保し、タスク成功後に実際の出力時間で精算、差額は自動的に返却されます - `audio` トラックのオン/オフで**価格は同じ**です - **タスク失敗時は課金されず**、凍結された金額は全額返却されます operationId: createWan30ImageToVideo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: first_frame: summary: 先頭フレーム→動画 value: model: wan3.0-image-to-video prompt: >- The boy in the frame “comes alive” out of the wall and performs an English rap at breakneck speed, while street lights under a railway bridge at night create a cinematic mood. image_start: https://example.com/first_frame.png duration: 5 quality: 720p first_last_frame: 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 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-image-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 - image_start properties: model: type: string description: モデル名。`wan3.0-image-to-video` で固定 enum: - wan3.0-image-to-video example: wan3.0-image-to-video default: wan3.0-image-to-video prompt: type: string description: >- 動画生成のテキストプロンプト。中国語と英語に対応し、**漢字/アルファベットはそれぞれ 1 文字としてカウント**、最大長は `20000` 文字で、超過分は自動的に切り捨てられます（エラーにはなりません） 先頭フレーム（または先頭/末尾フレーム）の間に起こる動き、カメラワーク、画面の変化を記述します。 example: >- 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: type: string format: uri description: |- 先頭フレーム画像 URL。生成される動画の最初のフレームとして厳密に使用されます。**必須** **画像制限：** - フォーマット：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。生成される動画の最後のフレームとして厳密に使用されます。省略可 **制約：** `image_start` と組み合わせて使用する必要があり、**末尾フレームのみの指定はできません**。 **画像制限：** - フォーマット：JPEG、JPG、PNG（透明非対応）、BMP、WEBP - 解像度：幅・高さが `[240, 8000]` ピクセル - アスペクト比：1:8 ~ 8:1 - ファイルサイズ：`20MB` 以下 example: https://example.com/last_frame.jpg duration: type: integer description: >- 生成する動画の長さ（秒）、デフォルトは `5` **指定できる値：** - `2` ～ `30` の任意の整数 - `-1`：スマート時間。プロンプトと入力素材に基づきモデルが出力の長さを自動的に決定します **スマート時間の課金方法：** 送信時点ではモデルがどれだけの長さを生成するか分からないため、上限の `30` 秒で**満額を事前確保**し、タスク成功後に実際の出力時間で精算、多く凍結した分は自動的に返却されます。残高が満額の事前確保を賄えない場合は、明示的な秒数を指定してください。 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-image-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 ``` ````