# bytedance/seedance-2.5/text-to-video

> Seedance 2.5 is ByteDance's next-generation AI video model. It delivers cinematic visuals, stronger long-form storytelling, and stable motion generation for videos up to 30 seconds.

## Overview

- **Endpoint**: `https://api.shortapi.ai/api/v1/job/create`
- **Model ID**: `bytedance/seedance-2.5/text-to-video`
- **Category**: text-to-video
- **Kind**: inference

## Pricing

480p $0.16/s, 720p $0.36/s. Total Cost = Unit Price × Output Video Duration.

For more details, please check our pricing page.

## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.

### Input Schema

The API accepts the following input parameters:

- **`prompt`** (`string`, _required_):
  Text prompt used to describe the video content.
  - Examples: "An action shot of a black lab swimming..."

- **`duration`** (`int`, _optional_):
  Output video duration in seconds.
  - Default: `5`
  - Range: `4` to `30`

- **`resolution`** (`string`, _optional_):
  Output video resolution.
  - Default: `720p`
  - Options: "480p", "720p"

- **`aspect_ratio`** (`string`, _optional_):
  The aspect ratio of the generated video frame.
  - Default: `adaptive`
  - Options: "adaptive", "21:9", "16:9", "9:16", "4:3", "1:1", "3:4"

### Output Schema

The API returns a JSON response with a `job_id` for tracking the request status.

**Create Job Response:**
```json
{
  "code": 0,
  "data": {
    "amount": "0.02",
    "job_id": "<JOB_ID>"
  }
}
```

**Query Job Result (when status is 2, meaning succeeded):**
```json
{
  "code": 0,
  "data": {
    "status": 2,
    "result": {
      "videos": [{ "url": "https://..." }]
    }
  }
}
```

## Use Example

To use this model, make an HTTP POST request to the API endpoint, then poll for results using the returned `job_id`.

### Bash (cURL)
```bash
# Step 1: Create a job
response=$(curl --request POST \
  --url https://api.shortapi.ai/api/v1/job/create \
  --header "Authorization: Bearer $SHORTAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "bytedance/seedance-2.5/text-to-video",
  "args": {
    "prompt": "A realistic nature documentary style, with cinematic lighting and shadows, depicts a warm afternoon on a grassy slope in a forest. A chubby panda cub rolls down the slope.The panda's black and white fur is realistically fluffy, its small, plump body and clumsy movements are endearing. The scene is a green forest slope, the ground covered with grass, moss, clover, soil, pebbles, dead branches, and a few small yellow flowers. Tall tree trunks and trees are blurred in the background. The camera is low-angle, mid-range, with a slight handheld feel, and the shot is generally stable, keeping the panda in the frame at all times.0s-3s: A panda cub lies on the green grassy slope, its body round and chubby. It initially rolls slowly sideways down the slope, its movements clumsy, the grass blades gently bent by its body. A gentle breeze blows, and sunlight filters through the trees from the upper left, creating dappled light and shadow.3s-8s: The panda rolls to the lower right of the frame, its movements gradually stopping, changing from lying on its side to lying down. Its round face faces the camera, its front paws pressed into the grass. The panda lies in the foreground grass, its body adjusted to a comfortable position, its head slightly raised and lowered, emitting soft humming sounds.Low camera angle, slight handheld feel, gently following the panda's movement to the lower right. Natural depth of field, with the foreground grass slightly blurred, the panda in sharp focus, and the background trees softly blurred. Natural ambient sounds—the wind, the soft thud of the panda rolling—create an overall warm, realistic, and natural feel."
  },
  "callback_url": "CALLBACK_URL"
}')
JOB_ID=$(echo "$response" | grep -o '"job_id": *"[^"]*"' | sed 's/"job_id": *//; s/"//g')

# Step 2: Poll for results
curl --request GET \
  --url "https://api.shortapi.ai/api/v1/job/query?id=$JOB_ID" \
  --header "Authorization: Bearer $SHORTAPI_KEY"
```

### JavaScript (Fetch API)
```javascript
// Step 1: Create a job
const response = await fetch(`https://api.shortapi.ai/api/v1/job/create`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${SHORTAPI_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "model": "bytedance/seedance-2.5/text-to-video",
    "args": {
      "prompt": "A realistic nature documentary style, with cinematic lighting and shadows, depicts a warm afternoon on a grassy slope in a forest. A chubby panda cub rolls down the slope.The panda's black and white fur is realistically fluffy, its small, plump body and clumsy movements are endearing. The scene is a green forest slope, the ground covered with grass, moss, clover, soil, pebbles, dead branches, and a few small yellow flowers. Tall tree trunks and trees are blurred in the background. The camera is low-angle, mid-range, with a slight handheld feel, and the shot is generally stable, keeping the panda in the frame at all times.0s-3s: A panda cub lies on the green grassy slope, its body round and chubby. It initially rolls slowly sideways down the slope, its movements clumsy, the grass blades gently bent by its body. A gentle breeze blows, and sunlight filters through the trees from the upper left, creating dappled light and shadow.3s-8s: The panda rolls to the lower right of the frame, its movements gradually stopping, changing from lying on its side to lying down. Its round face faces the camera, its front paws pressed into the grass. The panda lies in the foreground grass, its body adjusted to a comfortable position, its head slightly raised and lowered, emitting soft humming sounds.Low camera angle, slight handheld feel, gently following the panda's movement to the lower right. Natural depth of field, with the foreground grass slightly blurred, the panda in sharp focus, and the background trees softly blurred. Natural ambient sounds—the wind, the soft thud of the panda rolling—create an overall warm, realistic, and natural feel."
    },
    "callback_url": "CALLBACK_URL"
})
});
const data = await response.json();
const JOB_ID = data.job_id;

// Step 2: Poll for results
const result = await fetch(`https://api.shortapi.ai/api/v1/job/query?id=${JOB_ID}`, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${SHORTAPI_KEY}`
  }
});
const resultData = await result.json();
console.log(resultData);
```

### Python (Requests)
```python
import requests

# Step 1: Create a job
url = "https://api.shortapi.ai/api/v1/job/create"
payload = {
  "model": "bytedance/seedance-2.5/text-to-video",
  "args": {
    "prompt": "A realistic nature documentary style, with cinematic lighting and shadows, depicts a warm afternoon on a grassy slope in a forest. A chubby panda cub rolls down the slope.The panda's black and white fur is realistically fluffy, its small, plump body and clumsy movements are endearing. The scene is a green forest slope, the ground covered with grass, moss, clover, soil, pebbles, dead branches, and a few small yellow flowers. Tall tree trunks and trees are blurred in the background. The camera is low-angle, mid-range, with a slight handheld feel, and the shot is generally stable, keeping the panda in the frame at all times.0s-3s: A panda cub lies on the green grassy slope, its body round and chubby. It initially rolls slowly sideways down the slope, its movements clumsy, the grass blades gently bent by its body. A gentle breeze blows, and sunlight filters through the trees from the upper left, creating dappled light and shadow.3s-8s: The panda rolls to the lower right of the frame, its movements gradually stopping, changing from lying on its side to lying down. Its round face faces the camera, its front paws pressed into the grass. The panda lies in the foreground grass, its body adjusted to a comfortable position, its head slightly raised and lowered, emitting soft humming sounds.Low camera angle, slight handheld feel, gently following the panda's movement to the lower right. Natural depth of field, with the foreground grass slightly blurred, the panda in sharp focus, and the background trees softly blurred. Natural ambient sounds—the wind, the soft thud of the panda rolling—create an overall warm, realistic, and natural feel."
  },
  "callback_url": "CALLBACK_URL"
}
headers = {
    "Authorization": f"Bearer {SHORTAPI_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()
JOB_ID = data.get("job_id")

# Step 2: Poll for results
result_url = f"https://api.shortapi.ai/api/v1/job/query?id={JOB_ID}"
result = requests.get(result_url, headers={"Authorization": f"Bearer {SHORTAPI_KEY}"})
print(result.json())
```