# Seedance 2.5 Flash API Documentation

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

## Overview

**Model ID:** `seedance-2-5-flash`
**Type:** Video Generation
**Credit Cost:** 4 credits per second (per-second by resolution: 480p: 2, 720p: 4)

Seedance 2.5 Flash: the faster, lower-cost Seedance 2.5. Text-to-video, first/last frame, and reference-to-video, up to 30 seconds at 480p or 720p with native audio.

## Endpoint

```
POST https://pixeldojo.ai/api/v1/models/seedance-2-5-flash/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 | No | - | Text description of the video. Tag reference assets as @Image1, @Video1, @Audio1 and say what each one contributes. Required. |
| `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 10 reference images. Cannot be combined with first/last frames. |
| `reference_videos` | array | No | - | Up to 5 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 5 reference audio tracks, 30s combined. |
| `resolution` | enum | No | 720p | Output resolution. Seedance 2.5 Flash supports 480p and 720p. For 1080p, use seedance-2-5. (Options: 480p, 720p) |
| `aspect_ratio` | enum | No | 16:9 | Output aspect ratio. Ignored (forced to "adaptive") when a first frame or a reference video is supplied, because the model matches that input. (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

## Quick Start

### 1. Submit a Job

```bash
curl -X POST "https://pixeldojo.ai/api/v1/models/seedance-2-5-flash/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": 20,
  "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": 20
}
```

## 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-flash/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-flash/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);
```

## Use Saved Characters (@Name)

Write `@Name` in the prompt to use a character, product, outfit, location, prop or style saved in the account's Character Studio, for example `"@Mara on a beach at sunset"`. Its photos are added to `reference_images` automatically, after any images you send yourself, so your own image numbering is unchanged. List saved names with `GET /api/v1/characters` and save new ones with `POST /api/v1/characters`. An `@word` that names nothing saved stays plain text.

## 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 |
| `internal_error` | 500 | Server error |

## Links

- **Full Documentation:** https://pixeldojo.ai/api-platform/seedance-2-5-flash
- **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