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

> Generate cinematic video from one first-frame image or two first-and-last-frame images. Seedance 2.5 preserves visual consistency while creating natural motion and transitions.

## Overview

- **Endpoint**: `https://api.shortapi.ai/api/v1/job/create`
- **Model ID**: `bytedance/seedance-2.5/image-to-video`
- **Category**: image-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 motion and video content.
  - Examples: "An action shot of a black lab swimming..."

- **`image_urls`** (`list<string>`, _required_):
  Upload 1 image as the first frame, or 2 images as the first and last frames.

- **`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"

### 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": {
      "images": [{ "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/image-to-video",
  "args": {
    "prompt": "A sophisticated, cinematic 30-second 3D motion graphics sequence employs an exquisite steampunk and retro miniature landscape style, coupled with continuous, fluid, wraparound, and penetrating camera movements. [0-10 seconds]: A macro close-up of an antique brass clock face miraculously unfolds layer by layer into interlocking rotating gear rings and volumetric fog. The camera penetrates downwards through the gears, revealing a mechanical ornithopter spiraling and taking off from a miniature canyon constructed from stacked, aged books. [10-20 seconds]: The camera follows the ornithopter's trajectory forward, seamlessly penetrating into a high-speed rotating, ornate brass Zoetrope, inside which dynamic light and shadow of galloping mechanical horses are projected. The light and shadow leap out of the Zoetrope, and the scene instantly transforms into a brass-textured suspended cable car, traversing a forest of mechanical gears along luminous copper tracks, bathed in cinematic golden hour lighting. [20-30 seconds]: The camera gracefully pans downwards, revealing a beautifully crafted wind-up wooden mechanical sailboat beneath the cable car, cutting through the undulating waves made of deep blue glass. At the edge of the waves, a giant, luminous moon seamlessly emerges, with silhouettes of explorers carrying swaying lanterns trudging along a crystal-clear ridge under the starry sky. The camera smoothly spirals outwards, passing through ethereal clouds, returning to the ticking face of a grand brass clock. The logo appears in the final second, see @Image 1. Technical Specifications: Hyper-realistic mechanical textures, rich brass and gold tones, cinematic shallow depth of field. Smooth, seamless camera movement, creating a strong sense of epic grandeur and fantastical adventure.",
    "image_urls": ["https://shortapi-01.oss-cn-beijing.aliyuncs.com/assets/examples/bytedance/seedance-2.5/seedance2.5_30s_input.png"]
  },
  "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/image-to-video",
    "args": {
      "prompt": "A sophisticated, cinematic 30-second 3D motion graphics sequence employs an exquisite steampunk and retro miniature landscape style, coupled with continuous, fluid, wraparound, and penetrating camera movements. [0-10 seconds]: A macro close-up of an antique brass clock face miraculously unfolds layer by layer into interlocking rotating gear rings and volumetric fog. The camera penetrates downwards through the gears, revealing a mechanical ornithopter spiraling and taking off from a miniature canyon constructed from stacked, aged books. [10-20 seconds]: The camera follows the ornithopter's trajectory forward, seamlessly penetrating into a high-speed rotating, ornate brass Zoetrope, inside which dynamic light and shadow of galloping mechanical horses are projected. The light and shadow leap out of the Zoetrope, and the scene instantly transforms into a brass-textured suspended cable car, traversing a forest of mechanical gears along luminous copper tracks, bathed in cinematic golden hour lighting. [20-30 seconds]: The camera gracefully pans downwards, revealing a beautifully crafted wind-up wooden mechanical sailboat beneath the cable car, cutting through the undulating waves made of deep blue glass. At the edge of the waves, a giant, luminous moon seamlessly emerges, with silhouettes of explorers carrying swaying lanterns trudging along a crystal-clear ridge under the starry sky. The camera smoothly spirals outwards, passing through ethereal clouds, returning to the ticking face of a grand brass clock. The logo appears in the final second, see @Image 1. Technical Specifications: Hyper-realistic mechanical textures, rich brass and gold tones, cinematic shallow depth of field. Smooth, seamless camera movement, creating a strong sense of epic grandeur and fantastical adventure.",
      "image_urls": ["https://shortapi-01.oss-cn-beijing.aliyuncs.com/assets/examples/bytedance/seedance-2.5/seedance2.5_30s_input.png"]
    },
    "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/image-to-video",
  "args": {
    "prompt": "A sophisticated, cinematic 30-second 3D motion graphics sequence employs an exquisite steampunk and retro miniature landscape style, coupled with continuous, fluid, wraparound, and penetrating camera movements. [0-10 seconds]: A macro close-up of an antique brass clock face miraculously unfolds layer by layer into interlocking rotating gear rings and volumetric fog. The camera penetrates downwards through the gears, revealing a mechanical ornithopter spiraling and taking off from a miniature canyon constructed from stacked, aged books. [10-20 seconds]: The camera follows the ornithopter's trajectory forward, seamlessly penetrating into a high-speed rotating, ornate brass Zoetrope, inside which dynamic light and shadow of galloping mechanical horses are projected. The light and shadow leap out of the Zoetrope, and the scene instantly transforms into a brass-textured suspended cable car, traversing a forest of mechanical gears along luminous copper tracks, bathed in cinematic golden hour lighting. [20-30 seconds]: The camera gracefully pans downwards, revealing a beautifully crafted wind-up wooden mechanical sailboat beneath the cable car, cutting through the undulating waves made of deep blue glass. At the edge of the waves, a giant, luminous moon seamlessly emerges, with silhouettes of explorers carrying swaying lanterns trudging along a crystal-clear ridge under the starry sky. The camera smoothly spirals outwards, passing through ethereal clouds, returning to the ticking face of a grand brass clock. The logo appears in the final second, see @Image 1. Technical Specifications: Hyper-realistic mechanical textures, rich brass and gold tones, cinematic shallow depth of field. Smooth, seamless camera movement, creating a strong sense of epic grandeur and fantastical adventure.",
    "image_urls": ["https://shortapi-01.oss-cn-beijing.aliyuncs.com/assets/examples/bytedance/seedance-2.5/seedance2.5_30s_input.png"]
  },
  "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())
```