---
title: "sd-2-i2v (best)"
method: POST
path: "/api/v1/seedance-v2.0-i2v"
tags: ["Video: Image-to-Video"]
---

# sd-2-i2v (best)

`POST /api/v1/seedance-v2.0-i2v`

## Request

- Base URL: `https://api.muapi.ai`
- URL: `https://api.muapi.ai/api/v1/seedance-v2.0-i2v`
- Auth: one of:
  - API key in header `x-api-key`
  - OAuth 2 (client credentials, token URL `https://api.muapi.ai/oauth/token`)

Animate images using Seedance 2 (Feb 2026, #1 I2V benchmark, multimodal 9-image+3-video input, 15s). Input: image, text prompt, with selectable resolution (480p/720p, price scales accordingly). Output: up to 15-second video. Use for: best-in-class image animation, long video creation.

## Query parameters

- `webhook` string
- `team_id` integer, nullable

## Headers

- `x-api-key` string
- `x-embed-code` string, nullable
- `x-agent-embed-code` string, nullable
- `x-whitelabel-studio` string, nullable
- `authorization` string, nullable

## Request body

- Seedance2I2VBaseRequest: Used only by the real base /seedance-v2.0-i2v API endpoint (handle_seedance_v20_i2v) to add a real `resolution` param — see Seedance2T2VBaseRequest above.
  - `prompt` string, required: Text prompt describing the video. Reference uploaded images via @image1, @image2, … @imageN (1-based, matching the order of images_list). To use a fictional character, reference it with @character:<id> (request_id from a completed Seedance 2 Character generation) — characters are automatically appended to images_list. Multiple characters are supported. Example: 'The cat in @image1 walks through a garden alongside @character:ab539e5f'.
  - `images_list` string[], nullable: Up to 9 image URLs. Reference them in the prompt via @image1 … @image9. Not required when using @character:<id> references.
  - `webhook_url` string, uri, nullable
  - `aspect_ratio` '16:9' | '9:16' | '4:3' | '3:4'
  - `quality` 'high' | 'basic'
  - `duration` 5 | 10 | 15
  - `remove_watermark` boolean
  - `resolution` '480p' | '720p': Output resolution. Price scales with resolution — see the model's pricing table.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/muapi/apis/muapi-api.md) · [All operations](https://skmtc.dev/muapi/apis/muapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/muapi/apis/muapi-api/revisions/e4b7374381e5?raw)