apyhub
Back

Generate Image to Video With (Wan2.2 I2V, RTX 5090)

What it does

Image to Video Generator turns a photo into a short animated MP4 using the Wan2.2-TI2V-5B model. Send a prompt describing the motion and an image (base64-encoded), and optionally quality (fast or best) and resolution (sd or hd).

The POST /v1/video/i2v endpoint starts a generation task and returns a task_id. Use GET /v1/i2v/tasks/:task_id to check progress until the job reaches completed or error. When the video is ready, the response includes an output_url to the finished MP4.

Use Image to Video Generator when you want to animate a product photo, portrait, or scene image into a short cinematic clip while keeping the composition of the source photo.

Notes: Image-to-video with Wan2.2-TI2V-5B on a dedicated NVIDIA RTX 5090. Generates a ~5-second clip in roughly 1-3 minutes depending on quality/resolution tier.

▣ ENDPOINT 01 / 02
POST
Generate a video from photo (Wan2.2 I2V)
https://api.eu.apyhub.com/mastera-ai/generate-image-to-video-with-wan/v1/video/i2v

QUICKSTART

GUIDE

Quickstart

Start an image-to-video generation job with a source photo and a motion prompt.

curl -X POST "https://api.eu.apyhub.com/mastera-ai/generate-image-to-video-with-wan/v1/video/i2v" \
  -H 'apy-token: $APY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "the subject slowly turns and smiles at the camera",
    "image": "<base64-encoded-image>",
    "quality": "best",
    "resolution": "hd"
  }'

What you'll get back

Returns a JSON object with status (string) and task_id (string) fields. No message field is included.

{
  "task_id": "d2cf2023f8c7",
  "status": "processing"
}
TRY ITLIVE · 2000 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Base64-encoded source image to animate.
The text description of the motion to generate.
Generation quality tier.
Output resolution tier.

About this endpoint

What this endpoint does

Image to Video Generator turns a photo into a short animated MP4 using the Wan2.2-TI2V-5B model. Send an image (base64-encoded) and a prompt describing the motion, and optionally tune quality (fast or best) and resolution (sd or hd).

The POST /v1/video/i2v endpoint starts a generation task asynchronously and returns only status and task_id — it does not return the video itself. Use the paired job-check endpoint GET /v1/i2v/tasks/:task_id to poll progress until the job reaches completed or error. Only that job-check response includes an output_url field, and only once status is completed — it is never present in the submit response.

Use Image to Video Generator when you want to animate a product photo, portrait, or scene image into a short cinematic clip while keeping the composition of the source photo.

Request Body

ParameterTypeMandatoryDescription
promptStringYesThe text description of the motion to generate.
imageStringYesBase64-encoded source image to animate.
qualityENUMNoGeneration quality tier. Allowed values: fast, best. Default: best.
resolutionENUMNoOutput resolution tier. Allowed values: sd, hd. Default: hd.

Response

Returns a JSON object with status and task_id string fields. Unlike the LTX/LTX-2 submit endpoints, no message field is returned here.

ParameterTypeMandatoryDescription
statusStringNoJob status. Example: processing.
task_idStringNoThe job identifier to use when checking progress.

Notes

This endpoint kicks off an async job and returns immediately with a job identifier; the actual work runs in the background. Pair this call with the wan-image-to-video endpoint (GET /v1/i2v/tasks/:task_id) — poll that until the status reaches a terminal state to retrieve the result. Extract the job id from task_id.

Notes: Image-to-video with Wan2.2-TI2V-5B on a dedicated NVIDIA RTX 5090. Generates a ~5-second clip in roughly 1-3 minutes depending on quality/resolution tier — slower than the LTX models but higher-fidelity image-to-video conditioning.

▣ ENDPOINT 02 / 02
GET
Poll Wan I2V video status
https://api.eu.apyhub.com/mastera-ai/generate-image-to-video-with-wan/v1/i2v/tasks/:task_id

QUICKSTART

GUIDE

Quickstart

Check the status of a video-generation task by its task_id.

curl "https://api.eu.apyhub.com/mastera-ai/generate-image-to-video-with-wan/v1/i2v/tasks/:task_id" \
  -H 'apy-token: $APY_TOKEN'

Replace the :task_id segment in the URL above with the task_id value returned by the submit endpoint (e.g. d2cf2023f8c7).

What you'll get back

{
  "task_id": "d2cf2023f8c7",
  "status": "completed",
  "output_url": "https://api.eu.apyhub.com/mastera-ai/generate-image-to-video-with-wan"
}

On this completed response, check the X-Apy-Atoms response header for the actual total cost of the job.

TRY ITLIVE · 1 ATOM
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
The task identifier returned by the submit endpoint.

About this endpoint

What this endpoint does

Polls the status of a Wan2.2 I2V (photo-to-video) task using the task identifier in the path. The response reports the task's current status and includes the finished video URL once the task is completed.

Path Parameter(s)

AttributeTypeMandatoryDescription
task_idStringYesThe task identifier returned by the submit endpoint.

Response

ParameterTypeMandatoryDescription
task_idStringNoThe job identifier.
statusStringNoprocessing, completed, or error.
output_urlStringNoPresent only when status is completed — URL to the finished MP4.
errorStringNoError message, if present.

Pricing

On the final completed response, the X-Apy-Atoms response header reports the actual total cost of the completed generation job.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLGenerate Text to Video With LTX Video (RTX 5090)MasterA AICALLGenerate Text to Video With LTX 2 Video (RTX 5090)MasterA AICALLGenerate Thumbnail from Video APIApyHubCALLGenerate Text to Image Job APIMasterA AI

From the blog

Reads that touch this API.

Generating Video Thumbnails with ApyHub’s API (Go Guide)Aug 7, 2026Generating Thumbnails from Videos : A step-by-step guide in NodeJSJul 9, 2026Video Thumbnails for SEO: How They Lift CTR, and How to Generate Them with an APISep 22, 2026Exploring the Top Video Thumbnail ( Preview) APIsJul 9, 2026