# Seedance 2.5 API Documentation

> LLM-optimized documentation for Seedance 2.5. Copy into your AI assistant for integration help.

## Overview

**Model ID:** `seedance-2-5`
**Type:** Video Generation
**Credit Cost:** 30 credits per video

Seedance 2.5 — text-to-video, first/last frame, and multimodal reference-to-video. Up to 30 seconds in one request with native audio in 11 languages.

## Endpoint

```
POST https://pixeldojo.ai/api/v1/models/seedance-2-5/run
```

## Authentication

All requests require an API key in the Authorization header:

```
Authorization: Bearer YOUR_API_KEY
```

Get your API key: https://pixeldojo.ai/api-platform/api-keys

## Input Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `prompt` | string | Yes | - | Text description of the video. Tag reference assets as @Image1, @Video1, @Audio1 and say what each one contributes. |
| `first_frame_url` | url | No | - | Starting frame. Forces the output aspect ratio to match this image. Cannot be combined with reference assets. |
| `last_frame_url` | url | No | - | Ending frame. Requires first_frame_url. |
| `reference_images` | array | No | - | Up to 30 reference images. Cannot be combined with first/last frames. |
| `reference_videos` | array | No | - | Up to 10 reference videos, 30s combined. |
| `reference_video_seconds` | number | No | - | Combined length of reference_videos, in seconds. Seedance meters input video as well as output, so this is billed on top of duration. An ESTIMATE only — it is refined from the provider's own meter at settlement and the difference is refunded. Omit it and reference-video runs reserve the full 30s budget. (min: 1, max: 30) |
| `reference_audios` | array | No | - | Up to 10 reference audio tracks, 30s combined. Seedance 2.5 accepts audio-only references. |
| `resolution` | enum | No | 720p | Output resolution. Seedance 2.5 supports 480p and 720p only. (Options: 480p, 720p) |
| `aspect_ratio` | enum | No | 16:9 | Output aspect ratio. Ignored (forced to "adaptive") when a first frame is supplied, because the model matches the frame. (Options: 16:9, 4:3, 1:1, 3:4, 9:16...) |
| `duration` | integer | No | 5 | Clip length in seconds (4-30), or -1 to let the model choose. -1 is billed at 30s and refunded down on settle. (min: -1, max: 30) |
| `generate_audio` | boolean | No | true | Generate a native audio track (11 languages supported). |
| `thinking` | boolean | No | false | Let the model reason about the prompt before generating. Most useful on long multi-beat prompts. Costs no extra credits. Off by default. |

## Supported Aspect Ratios

- `16:9`
- `4:3`
- `1:1`
- `3:4`
- `9:16`
- `21:9`
- `adaptive`

## Capabilities

- Text to Video
- Image to Video
- Audio Generation
- NSFW Content

## Quick Start

### 1. Submit a Job

```bash
curl -X POST "https://pixeldojo.ai/api/v1/models/seedance-2-5/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A slow dolly through a rain-soaked neon alley",
    "duration": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'
```

**Response:**
```json
{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123",
  "creditCost": 30,
  "creditsRemaining": 95
}
```

### 2. Poll for Results

```bash
curl "https://pixeldojo.ai/api/v1/jobs/job_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Completed Response:**
```json
{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "video": "https://temp.pixeldojo.ai/..."
  },
  "creditCost": 30
}
```

## Python Example

```python
import requests
import time

API_KEY = "YOUR_API_KEY"

# Submit job
response = requests.post(
    "https://pixeldojo.ai/api/v1/models/seedance-2-5/run",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "A slow dolly through a rain-soaked neon alley",
        "duration": 10,
        "resolution": "720p",
        "aspect_ratio": "16:9"
    }
)

job = response.json()
job_id = job["jobId"]

# Poll for completion
while True:
    status_response = requests.get(
        f"https://pixeldojo.ai/api/v1/jobs/{'{job_id}'}",
        headers={"Authorization": f"Bearer {API_KEY}"}
    )
    status = status_response.json()
    
    if status["status"] == "completed":
        print("Output:", status["output"])
        break
    elif status["status"] == "failed":
        print("Error:", status.get("error"))
        break
    
    time.sleep(2)
```

## JavaScript Example

```javascript
const API_KEY = 'YOUR_API_KEY';

// Submit job
const submitResponse = await fetch('https://pixeldojo.ai/api/v1/models/seedance-2-5/run', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "prompt": "A slow dolly through a rain-soaked neon alley",
    "duration": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  })
});

const job = await submitResponse.json();

// Poll for completion
const pollForResult = async (jobId) => {
  while (true) {
    const statusResponse = await fetch(`https://pixeldojo.ai/api/v1/jobs/${jobId}`, {
      headers: { 'Authorization': `Bearer ${API_KEY}` }
    });
    const status = await statusResponse.json();
    
    if (status.status === 'completed') return status.output;
    if (status.status === 'failed') throw new Error(status.error);
    
    await new Promise(r => setTimeout(r, 2000));
  }
};

const output = await pollForResult(job.jobId);
console.log('Output:', output);
```

## Error Codes

| Code | Status | Description |
|------|--------|-------------|
| `unauthorized` | 401 | Invalid or missing API key |
| `insufficient_credits` | 402 | Not enough credits |
| `invalid_request` | 400 | Invalid parameters |
| `model_not_found` | 404 | Model ID not found |
| `rate_limited` | 429 | Too many requests |
| `internal_error` | 500 | Server error |

## Links

- **Full Documentation:** https://pixeldojo.ai/api-platform/seedance-2-5
- **API Keys:** https://pixeldojo.ai/api-platform/api-keys
- **Buy Credits:** https://pixeldojo.ai/api-platform/buy-credits
- **All Models:** https://pixeldojo.ai/api/v1/models
- **OpenAPI Spec:** https://pixeldojo.ai/api/openapi