Wan 3.0 · Image to Video

Animate a first-frame image with a text prompt, optionally guiding the ending with a last-frame image. Retrieve the finished video through the asynchronous task query.

Developer API pricing

Provider: SeeAPI

USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.

480p: 12 credits/sec (≈ $0.045/sec)

720p: 24 credits/sec (≈ $0.09/sec)

1080p: 47 credits/sec (≈ $0.18/sec)

Request

POST/v1/generations

AuthorizationSend your API key in the Authorization header using the Bearer scheme.Authorization: Bearer ****************

Header Params

stringrequired

A unique key for one logical generation request. Reuse the same key and unchanged request body when retrying after a network interruption.

Use a new key when changing the prompt or any generation setting.

max length: 255

Example:: order-20260818-001

Body Params

application/json

stringrequired

Select Wan 3.0 standard video generation.

Allowed:wan-3-0

Default:: wan-3-0
Example:: wan-3-0

stringrequired

Select image-to-video for first-frame animation with an optional last frame. Use reference-to-video for other reference assets.

Allowed:image-to-video

Default:: image-to-video
Example:: image-to-video

stringoptional

Optional public provider selection. Omit this field to use the default provider, or send seeapi.

Allowed:seeapi

Default:: seeapi
Example:: seeapi

objectrequired

Place the prompt, frame URLs and generation settings inside this object.

Provider parameters

SeeAPIseeapiDefault Provider

string <uri>required

Publicly accessible image URL used as the first frame. Send one URL string, not an array or a local file path.

JPEG, PNG, WebP or BMP; up to 20 MB.
Width and height must each be 240–8000 pixels;
width-to-height ratio must be between 1:8 and 8:1.
Use a direct downloadable URL that remains available while processing. Replace the example URL with your own image.

Example:: https://client.example.com/first-frame.png

string <uri>optional

Optional image URL guiding the final frame. Omit it when you only want to animate the first frame.

The first frame remains required. The last frame follows the same file and dimension limits as the first frame.
Do not combine frame inputs with document, webpage or other reference-to-video parameters.

stringrequired

Describe the motion, camera movement and transition you want between the supplied frames.

Use compatible first and last frames for a coherent transition. Include audio direction when generate_audio is true.

max length: 20000

Example:: The camera slowly moves forward as the garden lights come on; leaves sway gently in the evening breeze.

stringoptional

Output video resolution. Higher resolution costs more credits per generated second.

Allowed:480p720p1080p

Default:: 720p

stringoptional

Output frame shape. Use an explicit ratio for a fixed delivery format, or adaptive for automatic selection.

Allowed:adaptive16:94:31:13:49:16

Default:: adaptive

numberoptional

Requested output length in whole seconds.

Only integers from 2 to 30 are supported;

min: 2max: 30

Default:: 5

booleanoptional

Whether to generate audio along with the video.

Set false when you want video without generated audio. This switch does not change the configured per-second rate.

Default:: true

numberoptional

Optional random seed for controlled comparisons between requests.

Keep the same seed and other settings when comparing prompts; a seed does not guarantee identical output.

min: 0max: 2147483647

string <uri>optional

Optional HTTPS endpoint for the terminal generation notification.

Verify webhook signatures before trusting notifications. Poll the task if you do not supply a callback URL.

max length: 2048

Example:: https://client.example.com/webhooks/seeapi

Responses

202The generation has been accepted and is processing asynchronously. Save its ID and use the task query endpoint to obtain the final result.

Bodyapplication/json

objectrequired

stringrequired

Generation identifier used for subsequent task queries and support requests.

Example:: task_xxx

stringrequired

Example:: wan-3-0

stringrequired

Example:: image-to-video

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current state at acceptance. A processing response is not a completed video.

Allowed:processing

Example:: processing

numberrequired

Estimated public API credits for this request.

Example:: 120

numberrequired

Credits recorded as consumed; read the latest task state for final accounting.

Example:: 0

numberrequired

Credits recorded as refunded. Do not infer a refund solely from a client-side timeout.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200A replay of an existing generation request using the same idempotency key.

Bodyapplication/json

Inspect the returned generation instead of creating another request with a new key.

objectrequired

stringrequired

Generation identifier used for subsequent task queries and support requests.

Example:: task_xxx

stringrequired

Example:: wan-3-0

stringrequired

Example:: image-to-video

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current state at acceptance. A processing response is not a completed video.

Allowed:processing

Example:: processing

numberrequired

Estimated public API credits for this request.

Example:: 120

numberrequired

Credits recorded as consumed; read the latest task state for final accounting.

Example:: 0

numberrequired

Credits recorded as refunded. Do not infer a refund solely from a client-side timeout.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Check the first-frame URL, parameter types and permitted values before retrying.

401

Supply a valid Bearer API key in the Authorization header.

402

The account does not have sufficient credits for the request.

403

Check that the API key and account have access to this model and endpoint.

404

Check the model, endpoint or task identifier.

409

The idempotency key conflicts with another request, or creation is still in progress. Retry only with the same intended body.

413

Reduce the JSON request size.

429

Back off before retrying; retain the original idempotency key for the same request.

503

The service is temporarily unavailable. Retry with backoff and the same idempotency key.

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task DetailsLearn how to query task status and retrieve generation results

Keep the returned generation.id and query the task until it reaches a terminal state. Acceptance is not completion; do not submit a new generation simply because the video is still processing.

Related Resources

Market Overview

Explore all available models

Credits & Billing

View credit balance, plans, and billing activity

Usage

Review API usage and credit consumption

Callbacks

Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.

Webhook flow

Callback URL per generation.

Webhook signing key

Code Examples

Request

const response = await fetch("https://api.seeapi.com/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": "order-20260818-001",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "wan-3-0",
  "endpoint": "image-to-video",
  "provider": "seeapi",
  "input": {
    "first_frame_image": "https://client.example.com/first-frame.png",
    "prompt": "The camera slowly moves forward as the garden lights come on; leaves sway gently in the evening breeze.",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration_seconds": 5,
    "generate_audio": true
  },
  "callback_url": "https://client.example.com/webhooks/seeapi"
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_xxx",
    "model": "wan-3-0",
    "endpoint": "image-to-video",
    "provider": "seeapi",
    "status": "processing",
    "estimated_credits": 120,
    "consumed_credits": 0,
    "refunded_credits": 0,
    "created_at": "2026-08-18T10:00:00Z",
    "updated_at": "2026-08-18T10:00:00Z"
  },
  "idempotent": false
}

{ "generation": { "id": "task_xxx", "model": "wan-3-0", "endpoint": "image-to-video", "provider": "seeapi", "status": "processing", "estimated_credits": 120, "consumed_credits": 0, "refunded_credits": 0, "created_at": "2026-08-18T10:00:00Z", "updated_at": "2026-08-18T10:00:00Z" }, "idempotent": false }

Responses

202The generation has been accepted and is processing asynchronously. Save its ID and use the task query endpoint to obtain the final result.

Bodyapplication/json

objectrequired

stringrequired

Generation identifier used for subsequent task queries and support requests.

Example:: task_xxx

stringrequired

Example:: wan-3-0

stringrequired

Example:: image-to-video

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current state at acceptance. A processing response is not a completed video.

Allowed:processing

Example:: processing

numberrequired

Estimated public API credits for this request.

Example:: 120

numberrequired

Credits recorded as consumed; read the latest task state for final accounting.

Example:: 0

numberrequired

Credits recorded as refunded. Do not infer a refund solely from a client-side timeout.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200A replay of an existing generation request using the same idempotency key.

Bodyapplication/json

Inspect the returned generation instead of creating another request with a new key.

objectrequired

stringrequired

Generation identifier used for subsequent task queries and support requests.

Example:: task_xxx

stringrequired

Example:: wan-3-0

stringrequired

Example:: image-to-video

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current state at acceptance. A processing response is not a completed video.

Allowed:processing

Example:: processing

numberrequired

Estimated public API credits for this request.

Example:: 120

numberrequired

Credits recorded as consumed; read the latest task state for final accounting.

Example:: 0

numberrequired

Credits recorded as refunded. Do not infer a refund solely from a client-side timeout.

Example:: 0

string <date-time>required

Example:: 2026-08-18T10:00:00Z

string <date-time>required

Example:: 2026-08-18T10:00:00Z

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Check the first-frame URL, parameter types and permitted values before retrying.

401

Supply a valid Bearer API key in the Authorization header.

402

The account does not have sufficient credits for the request.

403

Check that the API key and account have access to this model and endpoint.

404

Check the model, endpoint or task identifier.

409

The idempotency key conflicts with another request, or creation is still in progress. Retry only with the same intended body.

413

Reduce the JSON request size.

429

Back off before retrying; retain the original idempotency key for the same request.

503

The service is temporarily unavailable. Retry with backoff and the same idempotency key.