>docs/api/image-to-video

Image-to-Video API

Generate videos from a reference image using the image_url parameter. Provide a publicly accessible image URL alongside a motion prompt to animate it into a high-quality Seedance 2.0 video clip.

# How It Works

Provide Image URL

Pass a publicly accessible image URL in the image_url parameter. This triggers Image-to-Video mode.

Describe Motion

Provide a prompt describing the desired motion, camera movement, and animation.

Poll & Download

Poll the generation endpoint until completed, then download the video from result.url.

# Generate Video from Image

POST/v1/videos/generate

Generate a video using a reference image. Uses the same endpoint as text-to-video -- including the image_url parameter triggers I2V mode.

Parameters

Name	Type	Required	Description
`prompt`	string	required	Describe the desired motion, camera movement, and animation (e.g., "camera slowly zooms in, hair blowing in the wind").
`image_url`	string	required	Publicly accessible URL to the reference image (JPG, PNG, WebP). Including this parameter triggers Image-to-Video mode.
`resolution`	string	optional ("720p")	Output resolution. Options: "720p" or "1080p".
`aspect_ratio`	string	optional ("16:9")	Output aspect ratio. Options: "16:9", "9:16", "4:3", "3:4", "1:1", "21:9".
`duration`	number	optional (5)	Video duration in seconds. Range: 4 to 15.
`sound`	boolean	optional (true)	Enable audio generation for the output video.

Response

{
  "id": "gen_img2v_x7y8z9",
  "model": "seedance-2.0-turbo",
  "status": "created",
  "poll_url": "/v1/videos/generations/gen_img2v_x7y8z9"
}

# Code Examples

Image-to-Video Generation

curl -X POST https:"code-comment">//api.nohuman.studio/v1/videos/generate \
  -H "Authorization: Bearer $NOHUMAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Camera slowly zooms in, subject turns head and smiles, cinematic lighting",
    "image_url": "https://example.com/reference_photo.jpg",
    "duration": 12,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

# Image Requirements

Requirement	Specification
Formats	JPG, PNG, WebP
Access	Publicly accessible URL
Max file size	10 MB
Recommended resolution	1024x1024 or higher

TIP

For best results, use high-quality images that match your target aspect ratio. The model uses the image as a visual reference and applies the motion described in your prompt.

# Pricing

Duration	Cost
720p 4-5s	$0.88
720p 6-10s	$1.75
720p 11-15s	$2.63
1080p 4-5s	$0.94
1080p 6-10s	$1.88
1080p 11-15s	$2.82

# Generation Status

After submitting, poll GET /v1/videos/generations/{id} every 5 seconds to check progress.

Status	Description
created	Request received, waiting for processing
processing	Video is being generated
completed	Video ready -- download from result.url
failed	Generation failed - check error field and retry

SYS :: image-to-video/v1 :: endpoint reference