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

Pulkit

# BytePlus Seedance 1.0 Pro Fast - Image to Video API

## Overview

The BytePlus Seedance 1.0 Pro Fast Image-to-Video API generates short, high-quality videos from a single input image plus a motion prompt. You provide an image URL, prompt, and output parameters, and the API returns a job ID that you can poll until the final video URL is ready.

## Features

* **Image-to-Video Generation:** Animate a static image into a dynamic video clip.
* **Resolution Control:** Choose from 480p, 720p, or 1080p.
* **Aspect Ratio Options:** Support for 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, and adaptive.
* **Duration Control:** Set video duration from 2 to 12 seconds.
* **Watermark Option:** Enable or disable watermark.
* **Seed Control:** Use a fixed seed for reproducibility or `-1` for random.
* **Camera Control:** Option to keep camera fixed.
* **Async Workflow:** Submit once, poll status, and fetch output when complete.

## Use Cases

* **Wildlife & Nature Content:** Turn still wildlife photos into cinematic clips.
* **Marketing Creatives:** Animate product or campaign images for short-form ads.
* **Social Media:** Generate vertical or horizontal image-based motion content quickly.
* **Storyboarding:** Create motion previews from keyframes or concept art.
* **Education & Explainers:** Add lightweight motion to visual teaching assets.

## Visual Example

**Input image:**

![Tiger input image](https://blog.api.market/wp-content/uploads/2026/02/tiger.png)

**Prompt:**

The leopard slowly walks forward through the forest, muscles moving naturally, alert and focused expression, leaves gently moving in the wind, cinematic wildlife documentary style, ultra realistic motion, smooth camera tracking shot

**Parameters:** 720p, 16:9, 5 seconds

**Example output video:**

![Seedance 1.0 Pro Fast - tiger animated output](https://blog.api.market/wp-content/uploads/2026/02/tiger-api-market.mp4)

The API returns the result URL in `output.video_url` when status becomes `succeeded` or `COMPLETED`.

### Pricing 

#### 1. Pricing Table (at $0.01/unit)

| Resolution | Multiplier (Units/sec) | Cost per Second | Example (5s Video) |
| :--- | :--- | :--- | :--- |
| **480p** | **1.0** | $0.010 | **$0.05** |
| **720p** | **2.1** | $0.021 | **$0.105** |
| **1080p** | **5.0** | $0.050 | **$0.25** |

---

## API Documentation

### Base URL

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

### Authentication

Include your API key in request headers:

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

### Asynchronous Processing

**IMPORTANT:** Image-to-video generation is asynchronous. The standard flow:

1. Call `POST /image-to-video-pro-fast/run` with your input payload.
2. Receive `{ id, status: "submitted" }`.
3. Poll `GET /image-to-video-pro-fast/status/{job_id}` every 2-3 seconds.
4. Stop when status is `succeeded` or `COMPLETED`, then use `output.video_url`.

Recommended polling behavior:

* Poll interval: **2-3 seconds**
* Max timeout: **600 seconds (10 minutes)**
* Continue polling while status is `submitted`, `IN_QUEUE`, or `IN_PROGRESS`
* Fail fast if status is `failed` or `FAILED`

## Endpoints

### 1. Submit Image-to-Video Job

`POST /image-to-video-pro-fast/run`

**Description:** Submits an image-to-video generation request.

**Request Body:**

```json
{
  "input": {
    "prompt": "The leopard slowly walks forward through the forest, muscles moving naturally, alert and focused expression, leaves gently moving in the wind, cinematic wildlife documentary style, ultra realistic motion, smooth camera tracking shot",
    "image_url": "https://blog.api.market/wp-content/uploads/2026/02/tiger.png",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false,
    "seed": -1,
    "camerafixed": false
  }
}
```

**Parameters:**

| Parameter      | Type    | Required | Description |
|----------------|---------|----------|-------------|
| `prompt`       | string  | Yes      | Motion/style instruction for animation. |
| `image_url`    | string  | Yes      | Public URL of source image (PNG/JPG/WebP). |
| `resolution`   | string  | Yes      | `480p`, `720p`, `1080p`. |
| `ratio`        | string  | Yes      | `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `9:21`, `adaptive`. |
| `duration`     | integer | Yes      | Video length in seconds (2-12). |
| `watermark`    | boolean | No       | Whether to include watermark. Default: `false`. |
| `seed`         | integer | No       | Random seed (`-1` for random). |
| `camerafixed`  | boolean | No       | Keep camera fixed. Default: `false`. |

**Request Headers:**

* `Content-Type: application/json`
* `x-api-market-key: YOUR_API_MARKET_KEY`

**Response (Success - Job Submitted):**

```json
{
  "id": "cgt-20260217214410-plvml",
  "status": "submitted"
}
```

**cURL Example:**

```bash
curl -X POST "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-pro-fast/image-to-video-pro-fast/run" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "input": {
      "prompt": "The leopard slowly walks forward through the forest, muscles moving naturally, alert and focused expression, leaves gently moving in the wind, cinematic wildlife documentary style, ultra realistic motion, smooth camera tracking shot",
      "image_url": "https://blog.api.market/wp-content/uploads/2026/02/tiger.png",
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false,
      "seed": -1,
      "camerafixed": false
    }
  }'
```

### 2. Get Image-to-Video Job Status

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

**Description:** Returns the latest status and, when completed, the generated video URL.

**Path Parameters:**

* `job_id` (string, required): Job identifier returned by the run endpoint.

**Request Headers:**

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

**Response (Job In Progress):**

```json
{
  "id": "cgt-20260217214410-plvml",
  "status": "submitted"
}
```

**Response (Job Succeeded):**

```json
{
  "id": "cgt-20260217214410-plvml",
  "model": "seedance-1-0-pro-fast-251015",
  "status": "succeeded",
  "output": {
    "video_url": "https://blog.api.market/wp-content/uploads/2026/02/tiger-api-market.mp4",
    "seed": 80428
  },
  "usage": {
    "completion_tokens": 103818,
    "total_tokens": 103818
  },
  "created_at": 1771335851,
  "updated_at": 1771335875,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24
}
```

**cURL Example:**

```bash
curl -X GET "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-pro-fast/image-to-video-pro-fast/status/cgt-20260217214410-plvml" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

## Status Codes

* **200 OK:** Request successful.
* **400 Bad Request:** Invalid input or malformed request.
* **401 Unauthorized:** Missing or invalid API key.
* **403 Forbidden:** Key is valid but lacks access permissions.
* **404 Not Found:** Unknown `job_id` or route.
* **429 Too Many Requests:** Rate limit exceeded.
* **500 Internal Server Error:** Server-side processing issue.
* **503 Service Unavailable:** Temporary upstream issue.

## Rate Limits

See your API.market subscription for exact rate limits and quotas. If you receive 429 or 503, retry with exponential backoff (e.g. 2s, 4s, 8s).

## Error Handling

Errors are returned as JSON:

```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid image_url: Must be a non-empty string URL",
    "status": 400
  }
}
```

Common error cases:

* Invalid `image_url` (not public or malformed)
* Unsupported `resolution`, `ratio`, or `duration`
* Missing required fields
* Invalid API key or permission scope

## Implementation Guide

### JavaScript

```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-pro-fast";

function delay(ms) {
  return new Promise((resolve) => setTimeout(resolve, ms));
}

async function createImageToVideoAndWait(inputData) {
  const runResponse = await fetch(`${baseUrl}/image-to-video-pro-fast/run`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-market-key": apiKey,
    },
    body: JSON.stringify({ input: inputData }),
  });

  if (!runResponse.ok) {
    throw new Error(`Run request failed: ${runResponse.status} ${runResponse.statusText}`);
  }

  const runData = await runResponse.json();
  const jobId = runData.id;
  const maxTimeoutMs = 600000;
  const pollIntervalMs = 2000;
  const startedAt = Date.now();

  while (Date.now() - startedAt < maxTimeoutMs) {
    const statusResponse = await fetch(
      `${baseUrl}/image-to-video-pro-fast/status/${jobId}`,
      { headers: { "x-api-market-key": apiKey } },
    );

    if (!statusResponse.ok) {
      throw new Error(`Status request failed: ${statusResponse.status} ${statusResponse.statusText}`);
    }

    const statusData = await statusResponse.json();

    if (statusData.status === "succeeded" || statusData.status === "COMPLETED") {
      return statusData.output;
    }

    if (statusData.status === "failed" || statusData.status === "FAILED") {
      throw new Error(`Generation failed: ${statusData.error || "Unknown error"}`);
    }

    await delay(pollIntervalMs);
  }

  throw new Error("Generation timed out after 10 minutes");
}

const inputData = {
  prompt: "The leopard slowly walks forward through the forest, muscles moving naturally, alert and focused expression, leaves gently moving in the wind, cinematic wildlife documentary style, ultra realistic motion, smooth camera tracking shot",
  image_url: "https://blog.api.market/wp-content/uploads/2026/02/tiger.png",
  resolution: "720p",
  ratio: "16:9",
  duration: 5,
  watermark: false,
  seed: -1,
  camerafixed: false,
};

createImageToVideoAndWait(inputData)
  .then((output) => console.log("Video URL:", output.video_url))
  .catch((error) => console.error("Error:", error));
```

### Python

```python
import requests
import time

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-pro-fast"

def create_image_to_video_and_wait(input_data):
    run_resp = requests.post(
        f"{BASE_URL}/image-to-video-pro-fast/run",
        headers={
            "Content-Type": "application/json",
            "x-api-market-key": API_KEY,
        },
        json={"input": input_data},
    )
    run_resp.raise_for_status()
    job_id = run_resp.json()["id"]

    timeout_seconds = 600
    poll_interval_seconds = 2
    start = time.time()

    while time.time() - start < timeout_seconds:
        status_resp = requests.get(
            f"{BASE_URL}/image-to-video-pro-fast/status/{job_id}",
            headers={"x-api-market-key": API_KEY},
        )
        status_resp.raise_for_status()
        data = status_resp.json()

        if data.get("status") in ("succeeded", "COMPLETED"):
            return data.get("output", {})

        if data.get("status") in ("failed", "FAILED"):
            raise RuntimeError(f"Generation failed: {data.get('error', 'Unknown error')}")

        time.sleep(poll_interval_seconds)

    raise TimeoutError("Generation timed out after 10 minutes")

input_data = {
    "prompt": "The leopard slowly walks forward through the forest, muscles moving naturally, alert and focused expression, leaves gently moving in the wind, cinematic wildlife documentary style, ultra realistic motion, smooth camera tracking shot",
    "image_url": "https://blog.api.market/wp-content/uploads/2026/02/tiger.png",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "watermark": False,
    "seed": -1,
    "camerafixed": False,
}

output = create_image_to_video_and_wait(input_data)
print("Video URL:", output.get("video_url"))
```

### cURL

```bash
# Step 1: Submit generation request
curl -X POST "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-pro-fast/image-to-video-pro-fast/run" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "input": {
      "prompt": "The leopard slowly walks forward through the forest, muscles moving naturally, alert and focused expression, leaves gently moving in the wind, cinematic wildlife documentary style, ultra realistic motion, smooth camera tracking shot",
      "image_url": "https://blog.api.market/wp-content/uploads/2026/02/tiger.png",
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false,
      "seed": -1,
      "camerafixed": false
    }
  }'

# Response example:
# {"id":"cgt-20260217214410-plvml","status":"submitted"}

# Step 2: Poll status
curl -X GET "https://prod.api.market/api/v1/byteplus/seedance-image-to-video-pro-fast/image-to-video-pro-fast/status/cgt-20260217214410-plvml" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

### Performance Tips

* Use clean, high-quality source images with a clear subject.
* Keep prompts focused on motion and camera behavior.
* Use 480p for quick iteration; move to 720p/1080p for final output.
* Keep duration short (2-5s) for faster turnaround and lower cost.
* Use fixed `seed` values for deterministic iteration.

## FAQ

**Q: Do I need both prompt and image_url?**  
A: Yes. `image_url` is required, and the prompt is required in this API implementation.

**Q: How long does generation usually take?**  
A: Usually within a few minutes. Use polling and allow up to 10 minutes timeout.

**Q: Is status polling billable?**  
A: No. Status checks are free.

**Q: What image formats are recommended?**  
A: Publicly accessible PNG/JPG/WebP URLs with good source quality.

## Contact Us

For support, use the in-page chat or email **hello@api.market**.


Generate dynamic videos from a static image and a text prompt. Create clips up to 1080p and 12 seconds long. From $0.01/call. Try it free on API.market.