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

Pulkit

# 📝 🎬 Seedance 1.5 Pro Text to Video – Enhanced AI Video Generation

The Seedance 1.5 Pro Text-to-Video Model creates professional-grade, high-quality videos from text descriptions with enhanced features including 720p support, extended duration (4-12s), and optional audio generation.
Behind the scenes, it uses BytePlus Seedance 1.5 Pro weights exposed through API.market's fully managed infrastructure, so you get enterprise-grade reliability without running heavy video-generation GPUs yourself.

Typical flow:

1. **POST** your text prompt to start a job.
2. The response immediately returns a **`job_id`**.
3. **GET** the job status until `status` becomes **`succeeded`** and the `output.video_url` is ready.

## Features

* **Text-to-Video in seconds** – describe any scene and get a 4-12 second MP4 back.
* **Enhanced resolutions**: 480p, **720p** (new!), and 1080p for crystal-clear output.
* **Extended duration** – generate videos from 4 to 12 seconds (vs. 5-10s in older models).
* **Audio generation** – optional audio synthesis that brings videos to life.
* **Multiple aspect ratios** – 16:9, 9:16, 1:1, 4:3, 21:9, 9:21, 3:4, and adaptive mode for any use case.
* **Consistent generation** – deterministic seeds and `camerafixed` flag for rock-solid A/B testing.
* **Async job management** – fire-and-forget submission with cheap polling for status.
* **Token usage returned** – every response includes `completion_tokens` so you can track cost precisely.

## Use Cases

* **Marketing & Advertising** – create eye-catching video ads from product descriptions.
* **Social Media Content** – generate engaging videos for Instagram, TikTok, and YouTube.
* **E-learning & Training** – visualize concepts and scenarios for educational content.
* **Creative Storytelling** – bring scripts and ideas to life without expensive production.
* **Product Demonstrations** – showcase features and benefits through AI-generated videos.
* **Real Estate** – create property tour videos from listing descriptions.

## Visual Examples

**Prompt:** "A serene mountain landscape at sunset with golden light"

**Generated output (720p, 5s, with audio)**

![Seedance 1.5 Pro Example](https://blog.api.market/wp-content/uploads/2026/02/seedream-text-to-video.mp4)

## Pricing

* **Per-second pricing** based on video resolution, duration, and audio generation
* `GET` requests to check prediction status are **free** and don't count toward API unit usage

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

**Cost per second of video generated:**
* **480p**: $0.024/second (5s video = 5 units × $0.024 = **$0.12**)
* **720p**: $0.0528/second (5s video = 11 units × $0.024 = **$0.26**)
* **1080p**: $0.1152/second (5s video = 24 units × $0.024 = **$0.58**)
* **1080p (21:9)**: $0.12/second (5s video = 25 units × $0.024 = **$0.60**)

**Examples:**
* 480p, 5 seconds = **$0.12**
* 720p, 5 seconds = **$0.26**
* 1080p, 5 seconds = **$0.58**
* 1080p (21:9), 5 seconds = **$0.60**

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

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

**Cost per second of video generated:**
* **480p**: $0.012/second (5s video = 2.5 units × $0.024 = **$0.06**)
* **720p**: $0.0264/second (5s video = 5.5 units × $0.024 = **$0.13**)
* **1080p**: $0.0576/second (5s video = 12 units × $0.024 = **$0.29**)

**Examples:**
* 480p, 5 seconds = **$0.06**
* 720p, 5 seconds = **$0.13**
* 1080p, 5 seconds = **$0.29**

## API Documentation

### Base URL

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

### Authentication

Add your API key to every request header:

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

**Important:** Make sure you're using a valid API key from your API.market account.

### Asynchronous Processing

1. **POST** `/text-to-video-1-5-pro/run` – returns `{ id, status: "submitted" }`.
2. **Poll** `/text-to-video-1-5-pro/status/{id}` every 2-5 seconds.
3. Stop when `status` is **`succeeded`** (grab `output.video_url`) or **`failed`**.
4. Timeout after 600 seconds (10 minutes).

### Endpoints

#### 1. Start a job

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

```bash
curl -X POST \
  "https://prod.api.market/api/v1/byteplus/seedance-text-to-video-1-5-pro/text-to-video-1-5-pro/run" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "input": {
      "prompt": "A serene mountain landscape at sunset with golden light",
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false,
      "seed": -1,
      "camerafixed": false,
      "generate_audio": true
    }
  }'
```

**Request Parameters**

| Parameter | Type | Required | Description | Default |
|-----------|------|----------|-------------|---------|
| `prompt` | string | ✅ Yes | Text description of the video to generate | - |
| `resolution` | string | ✅ Yes | Video resolution: `480p`, `720p`, or `1080p` | `720p` |
| `ratio` | string | ✅ Yes | Aspect ratio: `16:9`, `9:16`, `1:1`, `4:3`, `21:9`, `9:21`, `3:4`, or `adaptive` | `16:9` |
| `duration` | integer | ✅ Yes | Video duration in seconds (4-12) | `5` |
| `watermark` | boolean | No | Add watermark to video | `false` |
| `seed` | integer | No | Random seed for reproducibility (-1 for random) | `-1` |
| `camerafixed` | boolean | No | Fix camera position | `false` |
| `generate_audio` | boolean | No | Generate audio for the video | `true` |

**Successful response**

```json
{
  "id": "cgt-20260216144149-zjfct",
  "status": "submitted"
}
```

#### 2. Check job status

`GET /text-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-text-to-video-1-5-pro/text-to-video-1-5-pro/status/cgt-20260216144149-zjfct"
```

**When complete**

```json
{
  "id": "cgt-20260216144149-zjfct",
  "status": "succeeded",
  "output": {
    "video_url": "https://ark-content-generation-ap-southeast-1.tos-ap-southeast-1.volces.com/seedance-1-5-pro/example.mp4"
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1771224109,
  "updated_at": 1771224158
}
```

### Status Codes

* **200 OK** – Request succeeded.
* **400 Bad Request** – Invalid parameters (e.g., invalid resolution or duration out of range).
* **401 Unauthorized** – API key missing/invalid.
* **403 Forbidden** – Key valid but lacks permission.
* **404 Not Found** – Job ID does not exist.
* **429 Too Many Requests** – Slow down; respect rate limits.
* **500 Internal Server Error** – Unexpected server issue.
* **503 Service Unavailable** – Temporary outage; retry with back-off.

### Rate Limits

* **Run endpoint**: 10 new jobs per minute per key.
* **Status endpoint**: 60 polls per minute per job.
  Handle HTTP 429 by exponential back-off starting at 2 seconds.

### Error Handling

```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid duration: Must be between 4 and 12 seconds",
    "status": 400
  }
}
```

Best practices:

* Validate inputs client-side first.
* Catch non-200 responses and surface `error.message` to users.
* Retry 500/503 with incremental delays (up to 3 attempts).

## Implementation Guide

### JavaScript (ES Modules)

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

async function generateVideo({ prompt, resolution = "720p", duration = 5, generateAudio = true }) {
  const start = await fetch(`${BASE}/text-to-video-1-5-pro/run`, {
    method: "POST",
    headers: { "Content-Type": "application/json", "x-api-market-key": API_KEY },
    body: JSON.stringify({ 
      input: { 
        prompt, 
        resolution, 
        ratio: "16:9",
        duration,
        watermark: false,
        seed: -1,
        camerafixed: false,
        generate_audio: generateAudio
      } 
    })
  });

  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}/text-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 data.output.video_url;
    if (data.status === "failed") throw new Error("Generation failed");
  }
  throw new Error("Timed out after 10 minutes");
}

// Example usage
generateVideo({ 
  prompt: "A futuristic cityscape at night", 
  resolution: "720p",
  duration: 5 
}).then(url => console.log("Video URL:", url));
```

### Python (3.9+)

```python
import requests
import time

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

def generate_video(prompt, resolution="720p", duration=5, generate_audio=True):
    start = requests.post(
        f"{BASE}/text-to-video-1-5-pro/run",
        headers={"x-api-market-key": API_KEY, "Content-Type": "application/json"},
        json={
            "input": {
                "prompt": prompt,
                "resolution": resolution,
                "ratio": "16:9",
                "duration": duration,
                "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}/text-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":
            return data["output"]["video_url"]
        if data["status"] == "failed":
            raise RuntimeError("Generation failed")
    raise TimeoutError("Timed out after 10 minutes")

# Example usage
video_url = generate_video("A futuristic cityscape at night", resolution="720p", duration=5)
print("Video URL:", video_url)
```

### cURL Quick Start

```bash
# 1️⃣ Kick off a job
curl -X POST \
  "https://prod.api.market/api/v1/byteplus/seedance-text-to-video-1-5-pro/text-to-video-1-5-pro/run" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "input": {
      "prompt": "A futuristic cityscape at night",
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false,
      "seed": -1,
      "camerafixed": false,
      "generate_audio": true
    }
  }'

# 2️⃣ Poll status (replace {id} with the job ID from step 1)
curl -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  "https://prod.api.market/api/v1/byteplus/seedance-text-to-video-1-5-pro/text-to-video-1-5-pro/status/{id}"
```

### Performance Tips

* Start with 480p while prototyping; use 720p or 1080p for final renders.
* Use `generate_audio: false` when audio isn't needed.
* Re-use deterministic `seed` for consistent comparisons.
* Parallelize polling across multiple job IDs to stay within rate limits.
* Use shorter durations (4-6s) for faster generation and lower costs.

## FAQ

> **What's new in Seedance 1.5 Pro?**
> Enhanced video quality, 720p resolution support, extended duration range (4-12s vs 5-10s), and optional audio generation.

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

> **Can I generate videos without audio?**
> Yes! Set `generate_audio: false` in your request.

> **What aspect ratios are supported?**
> 16:9, 9:16 (vertical), 1:1 (square), 4:3, 21:9 (ultrawide), 9:21, 3:4, and adaptive.

> **Can I download the video multiple times?**
> Yes. Once a job succeeds the `video_url` is valid for 24 hours.

> **Is commercial usage allowed?**
> All videos are generated under a royalty-free license. Ensure your prompts respect third-party rights.

## 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[at]api.market**.


Generate high-quality 720p-1080p videos from text prompts. Get a 4-12 second MP4 with optional audio. From $0.02/call. Try it free on API.market.