# Dreamina Seedance 2.5 API

> Seedance 2.5 is a new generation multimodal video creation model, which has entered a new industrial stage of "long narrative, multiple materials, strong editing, and multiple languages".Dreamina-Seedance-2.5 is ByteDance's next-generation video generation model, now in an industrial-grade phase: long-form narrative × multi-asset reference × powerful editing × multi-language.

- Model ID: `dreamina-seedance-2-5-260628`
- Provider: BytePlus
- Tasks: Image to Video, Text to Video, Video to Video
- Price: Provider cost USD / 1M completion tokens; varies by resolution and video input
- Web page: https://scalingtensor.com/models/dreamina-seedance-2-5-260628

## How to call it

Authenticate with the `apiKey` request header. Submit a job, then poll for the result:

1. `POST https://restapi.scalingtensor.com/api/media/generate` with JSON `{ "model": "<model ID>", "params": { ... } }`. The response `data.jobId` identifies the job.
2. `GET https://restapi.scalingtensor.com/api/media/result?jobId=<jobId>` until the status is `completed` or `failed`.
3. A response `code` of 0 means success; otherwise read `msg`.

```bash
curl --request POST 'https://restapi.scalingtensor.com/api/media/generate' \
  --header 'apiKey: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "model": "dreamina-seedance-2-5-260628",
  "params": {
    "ratio": "16:9",
    "content": [
      {
        "text": "Use the first-person POV framing from Video 1 throughout, and use Audio 1 as the background music throughout. First-person POV fruit tea promotional ad, Seedance brand limited-edition apple fruit tea; opening frame is Image 1, your hand picks a dew-covered Aksu red apple, a light, crisp apple tapping sound; 2–4 seconds: fast cuts, your hand drops apple chunks into a shaker, adds ice and tea base, shakes forcefully, ice clinking and shaking sounds sync with upbeat rhythmic beats, background audio: {Fresh-cut, shaken fresh}; 4–6 seconds: first-person close-up of the finished drink, layered fruit tea is poured into a clear cup, your hand gently squeezes milk foam to spread across the top, a pink brand sticker is applied to the cup, the camera moves closer to show the layered textures of the foam and fruit tea; 6–8 seconds: first-person hand-held toast shot, you raise the fruit tea from Image 2 toward the camera (simulating handing it to the viewer), the cup label is clearly visible, background audio {Take a sip of fresh refreshment}, the final frame freezes on Image 2. All background voice audio uses a female voice.",
        "type": "text"
      },
      {
        "role": "reference_image",
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/your-image.jpg"
        }
      },
      {
        "role": "reference_image",
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/your-image.jpg"
        }
      },
      {
        "role": "reference_video",
        "type": "video_url",
        "video_url": {
          "url": "https://example.com/your-video.mp4"
        }
      },
      {
        "role": "reference_audio",
        "type": "audio_url",
        "audio_url": {
          "url": "https://example.com/your-audio.mp3"
        }
      }
    ],
    "duration": 11,
    "watermark": false,
    "generate_audio": true
  }
}'
```

## Input parameters

Parameters go inside the `params` object.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `model` | string | true | Model ID |
| `content` | object[] | true | Input content list. References provided to the model for video generation, supporting text, image, audio, video, and sample task ID. |
| `content.type` | string | true | Content type. For text input set to text; for image input set to image_url; for video input set to video_url; for audio input set to audio_url; for draft task input set to draft_task. |
| `content.text` | string | true | Text prompt input to the model, describing the expected generated video. |
| `content.image_url` | object | true | The input image object for the model. |
| `content.image_url.url` | string | true | Image source. Accepts image URL, Base64-encoded image, or asset ID. |
| `content.role` | string | conditional | Role/purpose of the image, video, or audio. Image roles include first_frame, last_frame, and reference_image; video role is reference_video; audio role is reference_audio. |
| `content.video_url` | object | true | The video object provided to the model. |
| `content.video_url.url` | string | true | Video source. Accepts video URL or asset ID. |
| `content.audio_url` | object | true | Audio object provided to the model. |
| `content.audio_url.url` | string | true | Audio source. Accepts URL, Base64-encoded string, or asset ID. |
| `content.draft_task` | object | true | Draft task input to the model. |
| `content.draft_task.id` | string | true | Draft task ID. |
| `omni_reference_task_type` | string | false | Task type hint. Default value: auto. |
| `resolution` | string | false | Video resolution. |
| `ratio` | string | false | Video aspect ratio. |
| `duration` | integer | false | Video duration. |
| `frames` | integer | false | Video frame count. |
| `generate_audio` | boolean | false | Controls whether the generated video includes sound synchronized with the footage. Default: true. |
| `watermark` | boolean | false | Video watermark. Default value: false. |
| `output_format` | string | false | Output format. Default value: mp4. |
| `seed` | integer | false | Random seed used to control the randomness of generated content. Default value: -1. Value range: [-1, 2147483647]. |
| `camera_fixed` | boolean | false | Fix camera. Default value: false. |
| `return_last_frame` | boolean | false | Return last frame. Default value: false. |
| `draft` | boolean | false | Draft mode. Default: false. |
| `service_tier` | string | false | Service tier. Default value: default. Valid values include default and flex. |
| `callback_url` | string | false | Callback URL. |
| `execution_expires_after` | integer | false | Task expiration threshold. Default value: 172800. |
| `priority` | integer | false | Execution priority. Default: 0. |
| `safety_identifier` | string | false | End-user identifier. |

## FAQ

### How much does the Dreamina Seedance 2.5 API cost?

Dreamina Seedance 2.5 is billed at the provider's actual cost for each job (USD / 1M completion tokens; varies by resolution and video input). The charge is deducted from your prepaid ScalingTensor wallet.

### How do I call the Dreamina Seedance 2.5 API?

Send POST /api/media/generate with "model": "dreamina-seedance-2-5-260628" and the parameters in a params object, using your apiKey header. The call returns a jobId. Poll GET /api/media/result?jobId=... until the status is completed, then read the output URL from the result.

### Which parameters does Dreamina Seedance 2.5 accept?

Required: model and content. Optional: omni_reference_task_type, resolution, ratio, duration, frames, generate_audio, watermark, output_format, seed and camera_fixed and 7 more. The parameter table on this page describes each one.

### Do I need a BytePlus account to use Dreamina Seedance 2.5?

No. You call Dreamina Seedance 2.5 with your ScalingTensor API key and pay from your ScalingTensor wallet. The same key works for every other model in the catalog.