Wan Görüntüden Videoya

01

Genel Bakış

Görüntüden videoya uç noktasını desteklenen bir modelle kullanın. Durumunu almak için döndürülen Görev Kimliğini kullanın veya aşağıda belgelenen teslimler için callback_url sağlayın.

Hızlı başlangıç

Bir API anahtarı oluşturun ve RUNAPI_API_KEY olarak ayarlayın.
Desteklenen bir model seçin ve gövdesi o modelin şemasıyla eşleşen bir POST isteği gönderin.
Döndürülen görev kimliğini saklayın, ardından bir terminal durumuna ulaşana kadar yoklama yapın ya da aşağıda belgelenen geri çağırmaları işleyin.

POST /api/v1/wan/image_to_video

Temel URL: https://runapi.ai
API sürümü: v1
Kimlik doğrulama: Authorization: Bearer YOUR_API_TOKEN

02

Desteklenen modeller

Güncel fiyatlandırma, hız sınırları ve ticari kullanım ayrıntıları için bir model sayfası açın.

03

İstek şeması

JSON gövdesi

Alanlar ve izin verilen değerler seçili modele göre değişir. Sağlandığında, callback_url aşağıda belgelenen Görev teslimatlarını alır.

wan-2.2-a14b-image-to-video-turbo19 alan

accelerationstring

İsteğe bağlı

aspect_ratiostring

İsteğe bağlı

audioboolean

İsteğe bağlı

background_audio_urlstring

İsteğe bağlı

callback_urlstring

İsteğe bağlı

driving_audio_urlstring

İsteğe bağlı

duration_secondsinteger

İsteğe bağlı

enable_prompt_expansionboolean

İsteğe bağlı

enable_safety_checkerboolean

İsteğe bağlı

first_frame_image_urlstring

Zorunlu

last_frame_image_urlstring

İsteğe bağlı

modelstring

İsteğe bağlı

negative_promptstring

İsteğe bağlı

output_resolutionstring

İsteğe bağlı İzin verilen değerler: 480p, 720p

promptstring

İsteğe bağlı

ratiostring

İsteğe bağlı

seedinteger

İsteğe bağlı

source_video_urlstring

İsteğe bağlı

watermarkboolean

İsteğe bağlı

wan-2.5-image-to-video19 alan

accelerationstring

İsteğe bağlı

aspect_ratiostring

İsteğe bağlı

audioboolean

İsteğe bağlı

background_audio_urlstring

İsteğe bağlı

callback_urlstring

İsteğe bağlı

driving_audio_urlstring

İsteğe bağlı

duration_secondsinteger

Zorunlu

enable_prompt_expansionboolean

İsteğe bağlı

enable_safety_checkerboolean

İsteğe bağlı

first_frame_image_urlstring

Zorunlu

last_frame_image_urlstring

İsteğe bağlı

modelstring

İsteğe bağlı

negative_promptstring

İsteğe bağlı

output_resolutionstring

İsteğe bağlı İzin verilen değerler: 720p, 1080p

promptstring

İsteğe bağlı

ratiostring

İsteğe bağlı

seedinteger

İsteğe bağlı

source_video_urlstring

İsteğe bağlı

watermarkboolean

İsteğe bağlı

wan-2.6-flash-image-to-video19 alan

accelerationstring

İsteğe bağlı

aspect_ratiostring

İsteğe bağlı

audioboolean

Zorunlu

background_audio_urlstring

İsteğe bağlı

callback_urlstring

İsteğe bağlı

driving_audio_urlstring

İsteğe bağlı

duration_secondsinteger

İsteğe bağlı İzin verilen değerler: 5, 10, 15 Varsayılan: 5

enable_prompt_expansionboolean

İsteğe bağlı

enable_safety_checkerboolean

İsteğe bağlı

first_frame_image_urlstring

Zorunlu

last_frame_image_urlstring

İsteğe bağlı

modelstring

İsteğe bağlı

multi_shotsboolean

İsteğe bağlı

negative_promptstring

İsteğe bağlı

output_resolutionstring

İsteğe bağlı İzin verilen değerler: 720p, 1080p Varsayılan: 1080p

promptstring

Zorunlu

ratiostring

İsteğe bağlı

source_video_urlstring

İsteğe bağlı

watermarkboolean

İsteğe bağlı

wan-2.6-image-to-video19 alan

accelerationstring

İsteğe bağlı

aspect_ratiostring

İsteğe bağlı

audioboolean

İsteğe bağlı

background_audio_urlstring

İsteğe bağlı

callback_urlstring

İsteğe bağlı

driving_audio_urlstring

İsteğe bağlı

duration_secondsinteger

İsteğe bağlı

enable_prompt_expansionboolean

İsteğe bağlı

enable_safety_checkerboolean

İsteğe bağlı

first_frame_image_urlstring

Zorunlu

last_frame_image_urlstring

İsteğe bağlı

modelstring

İsteğe bağlı

multi_shotsboolean

İsteğe bağlı

Oluşturulan videonun tek kesintisiz çekim yerine geçişli birden fazla çekim kullanıp kullanmayacağını kontrol eder.

negative_promptstring

İsteğe bağlı

output_resolutionstring

İsteğe bağlı İzin verilen değerler: 720p, 1080p

promptstring

Zorunlu

ratiostring

İsteğe bağlı

source_video_urlstring

İsteğe bağlı

watermarkboolean

İsteğe bağlı

wan-2.7-image-to-video19 alan

accelerationstring

İsteğe bağlı

aspect_ratiostring

İsteğe bağlı

audioboolean

İsteğe bağlı

background_audio_urlstring

İsteğe bağlı

callback_urlstring

İsteğe bağlı

driving_audio_urlstring

İsteğe bağlı

duration_secondsinteger

İsteğe bağlı

enable_prompt_expansionboolean

İsteğe bağlı

enable_safety_checkerboolean

İsteğe bağlı

first_frame_image_urlstring

İsteğe bağlı

last_frame_image_urlstring

İsteğe bağlı

modelstring

İsteğe bağlı

negative_promptstring

İsteğe bağlı

output_resolutionstring

İsteğe bağlı İzin verilen değerler: 720p, 1080p

promptstring

Zorunlu

ratiostring

İsteğe bağlı

seedinteger

İsteğe bağlı

source_video_urlstring

İsteğe bağlı

watermarkboolean

İsteğe bağlı

Koşullu kurallar

Bu gereksinimler, listelenen tüm koşulların eşleştiği durumlarda uygulanır.

Şu durumlarda model = wan-2.2-a14b-image-to-video-turbo

Gerekli

Kabul edilmez

multi_shots
Şu durumlarda model = wan-2.5-image-to-video

Gerekli

Kabul edilmez

multi_shots
Şu durumlarda model = wan-2.6-flash-image-to-video

Gerekli

Kabul edilmez

seed
Şu durumlarda model = wan-2.6-image-to-video

Gerekli

Kabul edilmez

seed
Şu durumlarda model = wan-2.7-image-to-video

Gerekli

Kabul edilmez

multi_shots

04

Kabul oluştur

HTTP 202

POST /api/v1/wan/image_to_video

Yanıt şeması

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    },
    "task_replayed": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}

05

Yoklama işleniyor

HTTP 200

GET /api/v1/wan/image_to_video/:id

Yanıt şeması

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}

06

Yoklama tamamlandı

HTTP 200

GET /api/v1/wan/image_to_video/:id

Yanıt şeması

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    },
    "videos": {
      "items": {
        "properties": {
          "url": {
            "type": "string",
            "x-runapi-generated-media": true
          }
        },
        "required": [
          "url"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    }
  },
  "required": [
    "id",
    "status",
    "videos",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}

07

Yoklama başarısız oldu

HTTP 200

GET /api/v1/wan/image_to_video/:id

Yanıt şeması

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "error": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "error": "Task processing failed.",
  "id": "tsk_reference_demo",
  "status": "failed"
}

08

Müşteri geri çağırması: tamamlandı

HTTP 200

POST callback_url

Yanıt şeması

JSON

{
  "properties": {
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    },
    "videos": {
      "items": {
        "properties": {
          "url": {
            "type": "string",
            "x-runapi-generated-media": true
          }
        },
        "required": [
          "url"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    }
  },
  "required": [
    "id",
    "status",
    "videos"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "id": "tsk_reference_demo",
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}

09

Müşteri geri çağırması: başarısız oldu

HTTP 200

POST callback_url

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "properties": {
            "code": {
              "type": "string"
            },
            "limit_cents": {
              "type": "integer"
            },
            "message": {
              "type": "string"
            },
            "reset_at": {
              "format": "date-time",
              "type": [
                "string",
                "null"
              ]
            },
            "used_cents": {
              "type": "integer"
            },
            "window": {
              "enum": [
                "1h",
                "1d",
                "7d",
                "daily",
                "weekly",
                "monthly",
                "lifetime"
              ],
              "type": "string"
            }
          },
          "required": [
            "code",
            "message"
          ],
          "type": "object",
          "unevaluatedProperties": false
        }
      ]
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": {
    "code": "generation_failed",
    "message": "Task processing failed."
  },
  "id": "tsk_reference_demo",
  "status": "failed"
}

10

Hatalar

HTTP 401

POST /api/v1/wan/image_to_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Authentication required"
}

11

Hatalar

HTTP 401

GET /api/v1/wan/image_to_video/:id

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Authentication required"
}

12

Hatalar

HTTP 400

POST /api/v1/wan/image_to_video

Yanıt şeması

JSON

{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "İnsan tarafından okunabilir hata mesajı.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "İnsan tarafından okunabilir doğrulama özeti.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Herkese açık istek alanına göre anahtarlanan doğrulama mesajları; her alan için insan tarafından okunabilir dizelerden oluşan bir dizi içerir.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Yanıt örneği

JSON

{
  "error": "model must be one of: wan-2.2-a14b-image-to-video-turbo, wan-2.5-image-to-video, wan-2.6-flash-image-to-video, wan-2.6-image-to-video, wan-2.7-image-to-video"
}

13

Hatalar

HTTP 402

POST /api/v1/wan/image_to_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Insufficient balance"
}

14

Hatalar

HTTP 429

POST /api/v1/wan/image_to_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "API key credit limit exceeded"
}

15

Hatalar

HTTP 409

POST /api/v1/wan/image_to_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "The request uses features that are not supported for the selected model"
}

16

Hatalar

HTTP 429

POST /api/v1/wan/image_to_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Rate limit reached. Please retry later."
}

17

Hatalar

HTTP 503

POST /api/v1/wan/image_to_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Service under maintenance, please try again later"
}

18

Hatalar

HTTP 504

POST /api/v1/wan/image_to_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "The request timed out"
}

19

Hatalar

HTTP 404

GET /api/v1/wan/image_to_video/:id

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Task with id 'tsk_reference_demo' not found"
}

20

Oluşturulan Kod Örnekleri

Doğrudan cURL kullanın veya diliniz için bir SDK yükleyin. Her örnek, bu başvuruda gösterilen doğrulanmış isteği gönderir.

Yükle

Shell

pip install runapi-wan

PYTHON

import os
from runapi.wan import WanClient

client = WanClient(api_key=os.environ["RUNAPI_API_KEY"])
task = client.image_to_video.create(
  model="wan-2.2-a14b-image-to-video-turbo",
  first_frame_image_url="https://file.runapi.ai/first-frame.png",
  prompt="Gentle ocean waves move in the background."
)

Yükle

Shell

npm install @runapi.ai/wan

JAVASCRIPT

import { WanClient } from "@runapi.ai/wan";

const client = new WanClient({ apiKey: process.env.RUNAPI_API_KEY });
const task = await client.imageToVideo.create({
  "model": "wan-2.2-a14b-image-to-video-turbo",
  "first_frame_image_url": "https://file.runapi.ai/first-frame.png",
  "prompt": "Gentle ocean waves move in the background."
});

CURL

curl -X POST https://runapi.ai/api/v1/wan/image_to_video \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"model":"wan-2.2-a14b-image-to-video-turbo","first_frame_image_url":"https://file.runapi.ai/first-frame.png","prompt":"Gentle ocean waves move in the background."}'

Yükle

Shell

go get github.com/runapi-ai/wan-sdk/go@latest

GO

package main

import (
  "context"
  "log"
  "os"

  "github.com/runapi-ai/core-sdk/go/option"
  wan "github.com/runapi-ai/wan-sdk/go/wan"
)

func main() {
  client, err := wan.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY")))
  if err != nil {
    log.Fatal(err)
  }

  task, err := client.ImageToVideo.Create(context.Background(), wan.ImageToVideoParams{
    Model: "wan-2.2-a14b-image-to-video-turbo",
    FirstFrameImageURL: "https://file.runapi.ai/first-frame.png",
    Prompt: "Gentle ocean waves move in the background.",
  })
  if err != nil {
    log.Fatal(err)
  }
  _ = task
}

21

Wan Görüntüden Videoya

Genel Bakış

Hızlı başlangıç

Uç Nokta

Desteklenen modeller

İstek şeması

Koşullu kurallar

Kabul oluştur

Yanıt örneği

Yoklama işleniyor

Yanıt örneği

Yoklama tamamlandı

Yanıt örneği

Yoklama başarısız oldu

Yanıt örneği

Müşteri geri çağırması: tamamlandı

Yanıt örneği

Müşteri geri çağırması: başarısız oldu

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Oluşturulan Kod Örnekleri

Yükle

İlgili Kılavuzlar