Skip to content

Task: Reference-to-Video

Overview

  • Method: POST
  • Path: /task/vidu/reference2video
  • Content-Type: application/json
  • Tags: Video Models (Video) / Vidu Video

Authentication

  • Header: Authorization: Bearer <token>

Request Parameters

ParameterTypeRequiredDescription
modelstringYesvidu2.0 / vidu1.5 / vidu1.0, default vidu2.0
imagesarray[string]Yes1-3 images (vidu1.0 supports only 1), URL or Base64, formats png/jpg/webp, <=50MB
promptstringYesText prompt, up to 1500 characters
durationintegerYesVideo duration, currently 4 seconds
seedintegerNoRandom seed, 0 or omit for random
aspect_ratiostringNo16:9 / 9:16 (default 16:9)
resolutionstringYes360p / 720p / 1080p (vidu1.0 only supports 360p)
movement_amplitudestringNoauto / small / medium / large
callback_urlstringNoCallback URL, status values: processing/success/failed

Example Request

bash
curl -X POST "https://api.gpt.ge/task/vidu/reference2video" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{
    "model":"vidu2.0",
    "images":["https://p1-kling.klingai.com/bs2/...png"],
    "prompt":"A girl walks gracefully toward the camera...",
    "duration":4,
    "resolution":"720p"
  }'

Success Response Example (200)

json
{
  "task_id":"809390691347075072",
  "type":"character2video",
  "state":"created",
  "model":"vidu2.0",
  "style":"general",
  "prompt":"A girl walks gracefully toward the camera...",
  "images":["https://p1-kling.klingai.com/bs2/...png"],
  "duration":4,
  "seed":305233514,
  "aspect_ratio":"16:9",
  "resolution":"720p",
  "movement_amplitude":"auto",
  "created_at":"2025-04-14T15:41:33.695830549Z"
}