# StableStudio Seedance Image-to-Video (i2v)

> StableStudio Seedance Image-to-Video (i2v) is a paid API for AI agents from StableStudio at stablestudio.dev, paid per call via MPP or x402, $20/call, status unknown (last checked 2026-10-12, last successful call 2026-04-24).

Generates a video from one or more reference images using the Seedance 2 Pro model, returning an async job ID

## Facts

- Endpoint: POST https://stablestudio.dev/api/generate/seedance/i2v?utm_source=zero.xyz
- Price: $20/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-12
- Last successful call: 2026-04-24
- Success rate: 100% of calls made through Zero
- Rating: 4.6 / 5 from 3 reviews
- Activations on Zero: 11
- Provider: StableStudio
- Docs: https://stablestudio.dev
- Website: https://stablestudio.dev
- Tags: image, video, generation, nano-banana, gpt-image, grok, flux, sora, veo, seedance, wan, ai, media, x402
- Canonical page: https://www.zero.xyz/c/stablestudio-i2v-76e5a22e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MuIqWoRWUON88ASTCrk7e

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stablestudio-i2v-76e5a22e -d '<json body>'
```

Example prompt: Animate this cat photo into a 5-second 16:9 video — keyframe mode — with the prompt 'A curious cat walking through a sunlit garden, gentle breeze, warm afternoon light', output at 720p: https://upload.wikimedia.org/wikipedia/commons/thumb/3/3a/Cat03.jpg/1200px-Cat03.jpg

## When to prefer this

Use this endpoint when you have one or more reference images and want to animate them into a video clip using the Seedance 2 Pro model. Prefer this over text-to-video (T2v) when a visual reference image is available and you want motion grounded in that image. Choose keyframe mode to start the video from the image, or reference mode for style/content guidance. Best for 4–15 second clips at up to 1080p or optional 4K upscale.

## Known failure modes

- Invalid or inaccessible image URL returns an error before charging
- Prompt exceeding 4000 characters is rejected with a validation error
- Unsupported resolution/aspect ratio combination returns a 400 error
- Payment failure (insufficient USDC balance) prevents job creation
- Callback URL unreachable results in missed completion notification
- Job creation succeeds but video generation fails asynchronously, requiring status polling

## How this service works

Pay-per-generation AI image and video creation. No subscriptions ever.

## Output

Returns a JSON object with success=true, a jobId string, status='pending', and a type string ('seedance-i2v'). The video is generated asynchronously; the jobId is used to poll for completion or receive results via a callback URL.

## Example request

```json
{
 "mode": "keyframe",
 "urls": [
  "https://images.unsplash.com/photo-1529778873920-4da4926a72c2?w=400"
 ],
 "prompt": "A serene landscape with rolling hills and a clear blue sky, soft clouds drifting slowly across the horizon",
 "duration": "4",
 "aspectRatio": "1:1",
 "urlMediaTypes": [
  "image"
 ],
 "outputResolution": "480p"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "keyframe",
    "reference"
   ],
   "type": "string",
   "default": "keyframe",
   "description": "Use keyframe image-to-video or reference-guided generation"
  },
  "urls": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uri"
   },
   "maxItems": 12,
   "minItems": 1,
   "description": "Public image/video reference URLs"
  },
  "prompt": {
   "type": "string",
   "maxLength": 4000,
   "minLength": 1,
   "description": "A detailed description of the video to generate"
  },
  "duration": {
   "enum": [
    "4",
    "5",
    "6",
    "7",
    "8",
    "9",
    "10",
    "11",
    "12",
    "13",
    "14",
    "15"
   ],
   "type": "string",
   "default": "5",
   "description": "Duration of the video in seconds"
  },
  "audioUrls": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uri"
   },
   "maxItems": 3,
   "description": "Public audio reference URLs"
  },
  "resolution": {
   "enum": [
    "720x720",
    "720x960",
    "960x720",
    "1280x720",
    "720x1280",
    "1280x540"
   ],
   "type": "string",
   "description": "Optional exact pixel resolution override"
  },
  "aspectRatio": {
   "enum": [
    "1:1",
    "3:4",
    "4:3",
    "16:9",
    "9:16",
    "21:9"
   ],
   "type": "string",
   "default": "16:9",
   "description": "Aspect ratio of the output video"
  },
  "callBackUrl": {
   "type": "string",
   "format": "uri",
   "description": "Optional Kinovi callback URL for API users"
  },
  "urlMediaTypes": {
   "type": "array",
   "items": {
    "enum": [
     "image",
     "video"
    ],
    "type": "string"
   },
   "maxItems": 12,
   "description": "One media type per urls item, aligned by index. Include this for API clarity; Stable Studio also infers and persists it from URL content types before charging."
  },
  "outputResolution": {
   "enum": [
    "480p",
    "720p",
    "1080p"
   ],
   "type": "string",
   "default": "720p",
   "description": "Output quality tier"
  },
  "upscaleResolution": {
   "type": "string",
   "const": "4k",
   "description": "Upscale the generated video to 4K"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "seedance-i2v",
  "jobId": "cmpbmzaee000j04jrzx4f43tw",
  "status": "pending",
  "pollUrl": "https://stablestudio.dev/api/jobs/cmpbmzaee000j04jrzx4f43tw",
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablestudio-i2v-76e5a22e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablestudio.dev](https://www.zero.xyz/host/stablestudio.dev/llms.txt)