Name: BytePlus Seedance – Image to Video AI | $0.02/call | API.market
Brand: byteplus
SKU: api-byteplus-seedance-image-to-video-1-5-pro
Availability: InStock
Author: API Market

Pulkit

# 🖼️📽️ Seedance 1.5 Pro Image-to-Video Generation API (seedance-image-to-video-1-5-pro)

The Seedance 1.5 Pro Image‑to‑Video Model converts static images into short, cinematic MP4 clips with optional motion guidance from text prompts.It lets you create 4-12 second videos in 480p, 720p, or 1080p with a single POST request.

Typical flow:

1. **POST** your image URL, optional prompt, and parameters to start the job.
2. Receive an immediate **`job_id`**.
3. **GET** the job status until `status` is **`succeeded`** and the `output.video_url` is ready.

## Features

* **Image‑to‑video generation** – animate static photos with optional motion guidance.
* **Enhanced resolutions** – 480p, **720p** (new!), and 1080p for crystal‑clear output.
* **Extended duration** – 4 to 12 seconds (vs. 5-10s in older models).
* **Audio generation** – optional audio synthesis (affects pricing).
* **Multiple aspect ratios** – 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21, adaptive.
* **Seed + camera lock** – deterministic runs for consistent A/B testing.
* **Async workflow** with lightweight polling.
* **Usage metrics** – completion & total token counts for every job.

Input:

![Model walking reference](https://blog.api.market/wp-content/uploads/2026/02/resturant.png)

**Prompt:** "Food truck in snow serving hot ramen"  
**Parameters:** 720p, 5s, with audio

**Generated output**

![Food truck in snow serving hot ramen](https://blog.api.market/wp-content/uploads/2026/02/seedance-1.5-pro-apimarket.mp4)
## Pricing

* **Per-second pricing** based on resolution, aspect ratio, and audio generation.
* `GET` requests to check status are **free** and don't count toward usage.

### With Audio (`generate_audio: true`)

| Resolution | Aspect Ratio | Cost per Second | 5s Example | 8s Example | 12s Example |
|:---|:---|:---|:---|:---|:---|
| **480p** | All | $0.024/sec | **$0.12** | $0.19 | $0.29 |
| **720p** | All | $0.0528/sec | **$0.26** | $0.42 | $0.63 |
| **1080p** | 16:9, 4:3, 1:1 | $0.1152/sec | **$0.58** | $0.92 | $1.38 |
| **1080p** | **21:9** | $0.12/sec | **$0.60** | $0.96 | $1.44 |

### Without Audio (`generate_audio: false`)

**50% discount** when audio is not needed:

| Resolution | Aspect Ratio | Cost per Second | 5s Example | 8s Example | 12s Example |
|:---|:---|:---|:---|:---|:---|
| **480p** | All | $0.012/sec | **$0.06** | $0.10 | $0.14 |
| **720p** | All | $0.0264/sec | **$0.13** | $0.21 | $0.32 |
| **1080p** | All | $0.0576/sec | **$0.29** | $0.46 | $0.69 |

**Note:** Pricing is calculated as: `Math.ceil(duration × multiplier) × $0.024`
- **Multipliers (With Audio):** 480p = 1.0x, 720p = 2.2x, 1080p = 4.8x (5.0x for 21:9)
- **Multipliers (No Audio):** 480p = 0.5x, 720p = 1.1x, 1080p = 2.4x

## Use Cases

* **E‑commerce** – animate product photos into engaging showcases.
* **Marketing & Advertising** – bring static ads to life with motion.
* **Social‑Media Content** – create eye‑catching posts for Instagram, TikTok, YouTube.
* **Real Estate** – transform property photos into virtual tours.
* **Creative Projects** – add motion to artwork, illustrations, and designs.
* **Photo Restoration** – bring old photos to life with subtle animations.

## API Documentation

### Base URL

```
https://prod.api.market/api/v1/byteplus/seedance-image-to-video-1-5-pro
```

### Authentication

Add your key on every request:

```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing

1. **POST** `/image-to-video-1-5-pro/run` – returns `{ id, status: "submitted" }`.
2. **Poll** `/image-to-video-1-5-pro/status/{id}` every 2-3 seconds.
3. Exit when `status` is **`succeeded`** (use `output.video_url`) or **`failed`**.
4. Abort after 600 seconds if still running.

### Endpoints

#### 1. Start a job

`POST /image-to-video-1-5-pro/run`

```bash
curl -X POST \
  "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-1-5-pro/image-to-video-1-5-pro/run" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "input": {
      "prompt": "Woman smiling and waving at camera",
      "image_url": "https://dtu1vvf8tvi89.cloudfront.net/4k.jpg",
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false,
      "seed": -1,
      "camerafixed": false,
      "generate_audio": true
    }
  }'
```

**Parameters**

| Field | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| `prompt` | string | Yes | - | Text to guide animation (e.g., "person waving") |
| `image_url` | string (URL) | Yes | - | Publicly accessible image URL (JPEG, PNG, WebP) |
| `resolution` | string | Yes | - | `480p`, `720p`, or `1080p` |
| `ratio` | string | Yes | - | `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, `9:21`, or `adaptive` |
| `duration` | integer | Yes | - | Video length in seconds (4-12) |
| `watermark` | boolean | No | `false` | Add watermark |
| `seed` | integer | No | `-1` | Random seed (-1 for random) |
| `camerafixed` | boolean | No | `false` | Keep camera static |
| `generate_audio` | boolean | No | `true` | Generate audio (false = 50% discount) |

**Response**

```json
{
  "id": "cgt-20260217025904-c5vrl",
  "status": "submitted"
}
```

#### 2. Check job status

`GET /image-to-video-1-5-pro/status/{job_id}`

```bash
curl -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-1-5-pro/image-to-video-1-5-pro/status/cgt-20260217025904-c5vrl"
```

**Job in progress**

```json
{
  "id": "cgt-20260217025904-c5vrl",
  "status": "IN_PROGRESS"
}
```

**Job complete**

```json
{
  "id": "cgt-20260217025904-c5vrl",
  "status": "succeeded",
  "output": {
    "video_url": "https://blog.api.market/wp-content/uploads/2026/02/seedance-i2v-output.mp4"
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1771224109,
  "updated_at": 1771224158
}
```

### Status Codes

* **200 OK** – Success.
* **400 Bad Request** – Invalid parameters.
* **401 Unauthorized** – Missing/invalid key.
* **403 Forbidden** – Key lacks permission.
* **404 Not Found** – Unknown `job_id`.
* **429 Too Many Requests** – Rate limit exceeded.
* **500 Internal Server Error** – Server fault.
* **503 Service Unavailable** – Temporary outage.

### Rate Limits

* **Run endpoint**: 20 submissions / minute / key.
* **Status endpoint**: 60 polls / minute / job.
  Handle HTTP 429 with exponential back‑off starting at 2 seconds.

### Error Handling

```json
{
  "error": {
    "code": "invalid_image_url",
    "message": "The image_url must be a valid, publicly accessible URL",
    "status": 400
  }
}
```

Best practices:

* Validate your payload before sending.
* Ensure image URLs are publicly accessible.
* Surface `error.message` to callers.
* Retry idempotent requests (GET) on 500/503 with back‑off.

## Implementation Guide

### JavaScript (ES Modules)

```javascript
import fetch from "node-fetch";

const API_KEY = "YOUR_API_MARKET_KEY";
const BASE = "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-1-5-pro";

export async function animateImage(imageUrl, prompt, {
  ratio = "16:9",
  duration = 5,
  resolution = "720p",
  generateAudio = true
} = {}) {
  const start = await fetch(`${BASE}/image-to-video-1-5-pro/run`, {
    method: "POST",
    headers: { "Content-Type": "application/json", "x-api-market-key": API_KEY },
    body: JSON.stringify({
      input: {
        prompt,
        image_url: imageUrl,
        ratio,
        duration,
        resolution,
        generate_audio: generateAudio,
        watermark: false,
        seed: -1,
        camerafixed: false
      }
    })
  });
  if (!start.ok) throw new Error(`Start failed: ${start.statusText}`);
  const { id } = await start.json();

  const deadline = Date.now() + 600_000;
  while (Date.now() < deadline) {
    await new Promise(r => setTimeout(r, 2000));
    const poll = await fetch(`${BASE}/image-to-video-1-5-pro/status/${id}`, {
      headers: { "x-api-market-key": API_KEY }
    });
    if (!poll.ok) throw new Error(`Poll failed: ${poll.statusText}`);
    const data = await poll.json();
    if (data.status === "succeeded") {
      return {
        videoUrl: data.output.video_url,
        tokensUsed: data.usage.completion_tokens
      };
    }
    if (data.status === "FAILED") throw new Error("Generation failed");
  }
  throw new Error("Timed out after 10 minutes");
}

// Example usage
const result = await animateImage(
  "https://dtu1vvf8tvi89.cloudfront.net/4k.jpg",
  "Woman smiling and waving at camera",
  { resolution: "720p", duration: 5, generateAudio: true }
);
console.log(`Video ready: ${result.videoUrl}`);
console.log(`Cost: ${(result.tokensUsed / 1000000 * 2.4).toFixed(2)} USD`);
```

### Python (3.9+)

```python
import requests, time

API_KEY = "YOUR_API_MARKET_KEY"
BASE = "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-1-5-pro"

def animate_image(image_url, prompt, ratio="16:9", duration=5, resolution="720p", generate_audio=True):
    start = requests.post(
        f"{BASE}/image-to-video-1-5-pro/run",
        headers={"x-api-market-key": API_KEY, "Content-Type": "application/json"},
        json={
            "input": {
                "prompt": prompt,
                "image_url": image_url,
                "ratio": ratio,
                "duration": duration,
                "resolution": resolution,
                "watermark": False,
                "seed": -1,
                "camerafixed": False,
                "generate_audio": generate_audio
            }
        }
    )
    start.raise_for_status()
    job_id = start.json()["id"]

    deadline = time.time() + 600
    while time.time() < deadline:
        time.sleep(2)
        poll = requests.get(
            f"{BASE}/image-to-video-1-5-pro/status/{job_id}",
            headers={"x-api-market-key": API_KEY}
        )
        poll.raise_for_status()
        data = poll.json()

        if data["status"] == "succeeded":
            tokens = data["usage"]["completion_tokens"]
            cost = (tokens / 1_000_000) * (2.4 if generate_audio else 1.2)
            return {
                "video_url": data["output"]["video_url"],
                "tokens_used": tokens,
                "estimated_cost": f"${cost:.2f}"
            }
        if data["status"] == "FAILED":
            raise RuntimeError("Generation failed")

    raise TimeoutError("Timed out after 10 minutes")

# Example usage
result = animate_image(
    "https://dtu1vvf8tvi89.cloudfront.net/4k.jpg",
    "Woman smiling and waving at camera",
    resolution="720p",
    duration=5,
    generate_audio=True
)
print(f"Video ready: {result['video_url']}")
print(f"Tokens used: {result['tokens_used']}")
print(f"Estimated cost: {result['estimated_cost']}")
```

### cURL Quick Start

```bash
# 1️⃣ Submit an image and prompt
curl -X POST \
  "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-1-5-pro/image-to-video-1-5-pro/run" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "input": {
      "prompt": "Woman smiling and waving at camera",
      "image_url": "https://dtu1vvf8tvi89.cloudfront.net/4k.jpg",
      "ratio": "16:9",
      "resolution": "720p",
      "duration": 5,
      "generate_audio": true
    }
  }'

# 2️⃣ Poll for completion (replace {id})
curl -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-1-5-pro/image-to-video-1-5-pro/status/{id}"

# 3️⃣ Example without audio (50% cheaper)
curl -X POST \
  "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-1-5-pro/image-to-video-1-5-pro/run" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "input": {
      "prompt": "Gentle camera pan across landscape",
      "image_url": "https://example.com/landscape.jpg",
      "resolution": "1080p",
      "duration": 8,
      "generate_audio": false
    }
  }'
```

### Performance Tips

* Use high‑resolution input images (at least 720p) for best results.
* Keep prompts focused on motion/action (e.g., "person waving", "clouds moving").
* Use 480p for ideation, upgrade to 720p/1080p for final deliverables.
* Set `generate_audio: false` if audio isn't needed to save 50% on costs.
* Fix `seed` to reproduce or iterate on a scene deterministically.
* Use `camerafixed: true` for static camera with subject motion only.

## FAQ

> **What image formats are supported?**
> JPEG, PNG, and WebP. Images must be publicly accessible via URL.

> **How long does generation take?**
> Typically 30-90 seconds depending on resolution and duration.

> **Can I use local images?**
> No—images must be hosted at a publicly accessible URL. Upload to a CDN or cloud storage first.

> **What's the difference between with and without audio?**
> Videos without audio cost 50% less. BytePlus charges 1.2 vs 2.4 USD per million tokens.

> **Can I control the type of motion?**
> Yes—use descriptive prompts like "gentle zoom in", "person walking forward", "camera panning left".

> **How long is the output link valid?**
> 24 hours after creation. Download and store if needed longer.

> **Can I generate vertical videos for Reels/Stories?**
> Yes—use `ratio: "9:16"` for vertical format.

> **Commercial usage?**
> Outputs are royalty‑free; ensure your input images and prompts are lawful.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to **hello@api.market**.


Animate static images into 4-12 second videos with AI. Supports up to 1080p. From $0.02/call. Try it free on API.market.