Seedance 2.5 API

Name: Seedance 2.5 API
Price: 0.0058 USD
Author: ByteDance

Latest cinematic video with audio, multi-reference input, and mp4/mov output in 10- or 8-bit. Up to 30s.

Seedance 2.5 API playground

Prompt

Reference inputs

Generate audio

Duration

Resolution

Aspect ratio

Billed at this model’s published rate.

Result

0:00 / 0:00

Your generations will appear here

Other models from ByteDance

Same vendor, same API call — the differences are below.

Model	Use case	Price	Resolution	Duration	Added
Seedream 5.5	Text → Image	from $0.02 / gen	1K · 1.5K · 2K	—	Nov 2026
ByteDance OmniHuman 2.0	Image → Video	from $0.077 / sec	—	—	Oct 2026
Seedream 5.0 Flash	Text → Image	from $0.0198 / gen	1K · 2K	—	Sep 2026
Seedance 2.5 Video Edit	Video → Video	from $0.0058 / 1K tok	480p · 720p · 1080p …	—	Aug 2026
Seedance 2.5 Video Extend	Video → Video	from $0.0058 / 1K tok	480p · 720p · 1080p …	4–30s	Aug 2026
Seedream 4.7	Text → Image	from $0.0225 / gen	1K · 2K · 4K	—	Aug 2026
ByteDance Video Enhance	Video → Video	from $0.0038 / sec	source · 720p · 1080p …	—	Jul 2026
Seed Audio Multilingual	Text → Speech	from $0.1875 / min	—	—	Jul 2026

Seedance 2.5 API in TypeScript, Python and REST

Install the SDK

TypeScript targets Node 20+ and ships with types; Python needs 3.10+ and is async. Over REST there is nothing to install: call https://api.picsart.com from any HTTP client.

bash

npm install @picsart/ai-sdk

Authenticate

Send your Picsart API key as a bearer token. The SDK does it for you once the client is created.

import { createClient } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY, // sent as: Authorization: Bearer <key>
  apiUrl: 'https://api.picsart.com',
});

python

import os

from picsart_ai_sdk import create_client

ai = create_client(
    api_key=os.environ["PICSART_API_KEY"],  # sent as: Authorization: Bearer <key>
    api_url="https://api.picsart.com",
)

Make a request

Call the model by its id. Over REST, one endpoint serves every model: POST /workflows/v1/models/execute with the model id and its input in the body. The outer params is the envelope every workflow takes; the inner one is this model's input, with the same names generate() takes.

import { createClient } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY,
  apiUrl: 'https://api.picsart.com',
});

const result = await ai.generate('seedance-2.5', {
  prompt: "A serene mountain lake at golden hour, ultra detailed",
  aspectRatio: "16:9",
  resolution: "1080p",
  duration: 5
});

console.log(result.url); // video URL

python

import asyncio
import os

from picsart_ai_sdk import create_client


async def main() -> None:
    async with create_client(
        api_key=os.environ["PICSART_API_KEY"],
        api_url="https://api.picsart.com",
    ) as ai:
        result = await ai.generate("seedance-2.5", {
            "prompt": "A serene mountain lake at golden hour, ultra detailed",
            "aspectRatio": "16:9",
            "resolution": "1080p",
            "duration": 5,
        })

        print(result.url)  # video URL


asyncio.run(main())

bash

curl -X POST 'https://api.picsart.com/workflows/v1/models/execute' \
  -H 'Authorization: Bearer $PICSART_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "params": {
    "model": "seedance-2.5",
    "params": {
      "prompt": "A serene mountain lake at golden hour, ultra detailed",
      "aspectRatio": "16:9",
      "resolution": "1080p",
      "duration": 5
    }
  }
}'

Async (submit & poll)

This model can run longer than the sync limit (~20s). generate() waits for you; to hold on to the job instead, submit it and poll. Over REST, send it to /workflows/v1/models/submit and poll /workflows/v1/models/{taskId}/result until response.status is COMPLETED or FAILED.

import { createClient } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY,
  apiUrl: 'https://api.picsart.com',
});

// Returns the generation id at once — store it to pick the job up later.
const generationId = await ai.submit('seedance-2.5', {
  prompt: "A serene mountain lake at golden hour, ultra detailed",
  aspectRatio: "16:9",
  resolution: "1080p",
  duration: 5
});

// Polls until the job completes; throws if it fails or is cancelled.
const result = await ai.result('seedance-2.5', generationId);

console.log(result.url); // video URL

python

import asyncio
import os

from picsart_ai_sdk import create_client


async def main() -> None:
    async with create_client(
        api_key=os.environ["PICSART_API_KEY"],
        api_url="https://api.picsart.com",
    ) as ai:
        # Returns the generation id at once — store it to pick the job up later.
        generation_id = await ai.submit("seedance-2.5", {
            "prompt": "A serene mountain lake at golden hour, ultra detailed",
            "aspectRatio": "16:9",
            "resolution": "1080p",
            "duration": 5,
        })

        # Polls until the job completes; raises ApiError if it fails or is cancelled.
        result = await ai.result("seedance-2.5", generation_id)

        print(result.url)  # video URL


asyncio.run(main())

bash

# 1. Submit the job
curl -X POST 'https://api.picsart.com/workflows/v1/models/submit' \
  -H 'Authorization: Bearer $PICSART_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "params": {
    "model": "seedance-2.5",
    "params": {
      "prompt": "A serene mountain lake at golden hour, ultra detailed",
      "aspectRatio": "16:9",
      "resolution": "1080p",
      "duration": 5
    }
  }
}'
# → { "status": "success", "response": { "id": "task_abc123" } }

# 2. Poll until response.status is COMPLETED
curl 'https://api.picsart.com/workflows/v1/models/task_abc123/result' \
  -H 'Authorization: Bearer $PICSART_API_KEY'

Parameters

16 parameters, the same for the SDK and for the inner params over REST. Required ones must be supplied; the rest fall back to their defaults.

Parameter	Type	Required	Default	Details
`prompt` What to make, in plain language: the subject, style, composition and motion. With an input image or video, what to change.	`text`	no	`—`	—
`aspectRatio` Shape of the output as width:height. An auto or adaptive option follows the input image.	`enum`	no	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive (follows the input)
`resolution` Output size. Higher costs more and takes longer.	`enum`	no	`1080p`	480p, 720p, 1080p, 4k
`duration` Length of the output, in seconds.	`enum`	no	`5`	-1 (auto: the model picks the length), 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
`generateAudio` Whether the video gets a generated soundtrack. Audio can cost more.	`boolean`	no	`true`	—
`returnLastFrame` Also return the last frame as an image, to extend the video from.	`boolean`	no	`false`	—
`outputFormat` File format of the result.	`enum`	no	`mp4`	mp4, mov
`colorDepth` Color depth of the video file.	`enum`	no	`10bit`	10bit, 8bit
`draft` A quick low-quality preview, to check the idea before a full render.	`boolean`	no	`false`	—
`draftTask` A draft to render in full, by its task id.	`object`	no	`—`	{ id }
`omniReferenceTaskType` Task Type	`enum`	no	`auto`	auto, reference, edit, extend
`imageUrls` Input images, as URLs: frames to animate, or references for subject, style or composition.	`file (image[])`	no	`—`	—
`videoUrls` Input videos, as URLs.	`file (video[])`	no	`—`	max 30.2s
`audioUrls` Input audio files, as URLs.	`file (audio[])`	no	`—`	max 30.2s
`startFrame` The first frame, as an image URL. The video starts on this image.	`file (image)`	no	`—`	—
`endFrame` The last frame, as an image URL. The video ends on this image.	`file (image)`	no	`—`	—

Response

generate() resolves once the job completes. A video URL. Over REST the output is at response.result, inside the gateway's status envelope with the task id, its status and the amount charged.

json

{
  "items": [
    {
      "url": "https://cdn.picsart.com/…/result"
    }
  ],
  "model": "seedance-2.5"
}

json

{
  "status": "success",
  "response": {
    "id": "task_abc123",
    "status": "COMPLETED",
    "result": {
      "url": "https://cdn.picsart.com/…/result",
      "items": [
        {
          "url": "https://cdn.picsart.com/…/result"
        }
      ],
      "model": "seedance-2.5"
    }
  }
}

Seedance 2.5 API advanced usage

Overview

Alongside the unified model APIs, we expose compatibility APIs that take each vendor's original parameters exactly as the vendor defines them — nothing renamed, nothing reshaped on the way through.

That makes them the shortest path onto Picsart if you already work with the vendor directly: the request bodies you've already written keep working as they are. You keep their parameter names and defaults, and you get the vendor's full parameter set rather than the subset that is shared across every model.

The cost is that a request is written for one vendor — switching models later means rewriting it, and results come back in the vendor's own shape. When you'd rather write once and change models freely, use the unified API.

Make a request

Call the workflow with ai.apis.run() in TypeScript or Python, or hit /workflows/{workflow}/execute directly — params is passed through untouched either way.

These endpoints are addressed by workflow name rather than model id: the one in this model's header, since one model runs as one workflow. Authentication is unchanged — your Picsart API key as a bearer token (see Authentication).

import { createClient, ApiRunMode } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY,
  apiUrl: 'https://api.picsart.com',
});

// Calls the 'seedance' workflow directly — params are sent as-is.
const { result, usage } = await ai.apis.run('seedance', {
  content: [
    {
      type: "text"
    }
  ]
}, {
  mode: ApiRunMode.SYNC,
});

console.log(result); // workflow-specific output
console.log(usage?.credits); // amount charged, in $

python

import asyncio
import os

from picsart_ai_sdk import ApiRunMode, create_client


async def main() -> None:
    async with create_client(
        api_key=os.environ["PICSART_API_KEY"],
        api_url="https://api.picsart.com",
    ) as ai:
        # Calls the 'seedance' workflow directly — params are sent as-is.
        response = await ai.apis.run("seedance", {
            "content": [
                {
                    "type": "text",
                },
            ],
        }, mode=ApiRunMode.SYNC)

        print(response["result"])  # workflow-specific output
        print((response.get("usage") or {}).get("credits"))  # amount charged, in $


asyncio.run(main())

bash

curl -X POST 'https://api.picsart.com/workflows/seedance/execute' \
  -H 'Authorization: Bearer $PICSART_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "params": {
    "content": [
      {
        "type": "text"
      }
    ]
  }
}'

Async (submit & poll)

This model can run longer than the sync limit (~20s). In the SDK, ai.apis.run() with ApiRunMode.ASYNC polls for you; over HTTP, submit and poll yourself.

import { createClient, ApiRunMode } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY,
  apiUrl: 'https://api.picsart.com',
});

// mode: ASYNC submits the job and polls under the hood — you just await.
const { result } = await ai.apis.run('seedance', {
  content: [
    {
      type: "text"
    }
  ]
}, {
  mode: ApiRunMode.ASYNC,
});

console.log(result);

python

import asyncio
import os

from picsart_ai_sdk import ApiRunMode, create_client


async def main() -> None:
    async with create_client(
        api_key=os.environ["PICSART_API_KEY"],
        api_url="https://api.picsart.com",
    ) as ai:
        # mode=ASYNC submits the job and polls under the hood — you just await.
        response = await ai.apis.run("seedance", {
            "content": [
                {
                    "type": "text",
                },
            ],
        }, mode=ApiRunMode.ASYNC)

        print(response["result"])


asyncio.run(main())

bash

# 1. Submit the job
curl -X POST 'https://api.picsart.com/workflows/seedance/submit' \
  -H 'Authorization: Bearer $PICSART_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "params": {
    "content": [
      {
        "type": "text"
      }
    ]
  }
}'
# → { "status": "success", "response": { "id": "wf_abc123" } }

# 2. Poll until response.status is COMPLETED
curl 'https://api.picsart.com/workflows/seedance/wf_abc123/result' \
  -H 'Authorization: Bearer $PICSART_API_KEY'

Parameters

13 parameters, sent inside params. These are the vendor's own names, so they line up one-for-one with the vendor's documentation. Required ones must be supplied; the rest fall back to their defaults.

Parameter	Type	Required	Default	Details
`model` Model name that will be resolved to the actual endpoint	`string`	no	`seedance_1_0_pro`	`seedance_1_0_proseedance_1_0_pro_fastseedance_1_5_proseedance_2_0seedance_2_0_fastseedance_2_0_miniseedance_2_5`
`content` Input content items. All models support text and image_url. v2 models also support video_url and audio_url, enabling edit-video and extend-video flows via reference_video role. Limits for v2 (2.0): max 9 images, 3 videos, 3 audios; audio cannot be the only modality. Limits for 2.5: max 30 images, 10 videos, 10 audios; audio-only input is allowed. Roles: first_frame, last_frame (v1+v2), reference_image/reference_video/reference_audio (v2 only). Asset references (asset://<id>) are accepted as URL values for v2.	`ContentItem[]`	no	`—`	—
└`type` Type of content item	`string`	yes	`—`	`textimage_urlvideo_urlaudio_urldraft_task`
└`text` Text content (only when type is text)	`string`	no	`—`	—
└`image_url` Image URL object (only when type is image_url)	`object`	no	`—`	—
└`url` URL of the image	`string`	yes	`—`	—
└`video_url` Video URL object (only when type is video_url). Only supported by v2 models.	`object`	no	`—`	—
└`url` URL of the video	`string`	yes	`—`	—
└`audio_url` Audio URL object (only when type is audio_url). Only supported by v2 models.	`object`	no	`—`	—
└`url` URL of the audio	`string`	yes	`—`	—
└`draft_task` Draft task object (only when type is draft_task). seedance_2_5 only: renders the final 1080p video from a previously generated 480p draft, referenced by draft_task.id. The final reuses the draft's prompt, inputs, ratio, duration and audio; anything else sent with it is passed to the vendor as-is, which rejects what a final does not take (other content items, ratio, duration, generate_audio, draft: true, a resolution other than 1080p). resolution defaults to 1080p.	`object`	no	`—`	—
└`id` The id of a succeeded Seedance 2.5 draft, as returned by the draft: true request in its draft_task. Valid for 7 days. Pass the draft_task object back unchanged.	`string`	yes	`—`	—
└`role` Role of the content item (first_frame, last_frame, reference_image, reference_video, reference_audio)	`string`	no	`—`	`first_framelast_framereference_imagereference_videoreference_audio`
`draft` Draft mode, step 1 (seedance_2_5 only): generate a cheap 480p preview to check scene structure, shots and motion. resolution defaults to 480p (the vendor rejects any other). Requires options.drive — the draft is saved there (the file backs the reference, with its expiry on the seedance~draftExpiresAt attribute) and a draft without it is rejected. The result carries a draft_task object — pass it back unchanged within 7 days as a single { type: "draft_task", draft_task } content item (step 2) to render the final video with the same model, at 1080p. Billed as a regular 480p generation, and the final at 1080p for the draft's input (if any) plus output seconds.	`boolean`	no	`—`	—
`resolution` Video resolution (480p, 720p, 1080p, 4k). 1080p supported by seedance_1_0_pro, seedance_1_0_pro_fast, seedance_2_0 and seedance_2_5 (NOT seedance_2_0_fast, NOT seedance_2_0_mini). 4k supported by seedance_2_0 and seedance_2_5 (H.265/HEVC, 10-bit; NOT seedance_2_0_fast, NOT seedance_2_0_mini). Affects billing.	`string`	no	`—`	`480p720p1080p4k`
`ratio` Video aspect ratio. "adaptive" lets the model choose based on input. For seedance_2_5, first/last-frame generation and video-to-video editing/extension tasks (a video input) require "adaptive" — the worker forces it for those (output proportions follow the input), so any explicit ratio is ignored there — unless omni_reference_task_type is set to anything but "auto", in which case the ratio is sent as-is. Text-to-video and reference-to-video keep the provided ratio.	`string`	no	`—`	`16:94:31:13:49:1621:9adaptive`
`output_format` Output video container format. seedance_2_5 only. "mp4" (default) is the general-purpose H.264/AAC container; "mov" is a professional H.264 4:4:4 / PCM container with higher color fidelity and larger files. "mp4_8bit" is an mp4 guaranteed to be 8-bit H.264: only 1080p comes back from the vendor as 10-bit H.265/HEVC (which most browsers and editors cannot decode), so at 1080p the video is re-encoded — adding processing time to the request — and at every other resolution the value changes nothing, the vendor already delivers 8-bit.	`string`	no	`—`	`mp4movmp4_8bit`
`omni_reference_task_type` Task type hint, seedance_2_5 only. Omni-reference tasks are one of three subtasks: reference-to-video, video editing and video extension, each with its own parameter constraints. "auto" (vendor default) lets the model infer the subtask from the inputs and prompt; a request incompatible with the inferred one fails asynchronously, after the task was created (InvalidParameter.TaskTypeConstraint). An explicit value makes the vendor validate that subtask's constraints at submit, rejecting a non-conforming request immediately; with an explicit value the worker also stops forcing ratio to "adaptive", so the provided ratio goes out as-is and an incompatible one fails at submit. "reference": generate a new video from reference images / videos / audio — no ratio or duration constraint. "edit": edit an original video's visuals or audio — content needs at least one reference_video of 4–30 seconds, ratio must be "adaptive" and duration -1. "extend": extend an original video forward or backward — content needs at least one reference_video and ratio must be "adaptive".	`string`	no	`—`	`autoreferenceeditextend`
`duration` Duration in seconds: 3-12 (v1), 4-15 (v2 / 2.0), 4-30 (2.5), or -1 for auto (seedance_1_5_pro and v2 only). Sent to the vendor as-is and billed as-is (charged per second). Input videos are billed too: the usage amount is the total input video duration plus the output duration. When omitted or -1, the vendor picks the length (following the source video for a video input); the output is charged up front at the model's max (an edit's at its source videos' length) and settled to the served length after generation. For seedance_2_5 editing tasks the vendor may require -1.	`object \| object`	no	`—`	—
`generate_audio` Include synchronized audio. Supported by seedance_1_5_pro and v2 models. v2 defaults to true when omitted; pass false to disable. Affects billing.	`boolean`	no	`—`	—
`return_last_frame` Return the last frame of the generated video as a separate image (populates last_frame_url). Supported by all models, including v2 (seedance_2_0 / seedance_2_0_fast / seedance_2_0_mini) — used for last-frame / face-chaining flows.	`boolean`	no	`—`	—
`watermark` Whether to add AI generated watermark	`boolean`	no	`false`	—
`camerafixed` Fix the camera during generation. v1 models only, ignored for v2.	`boolean`	no	`—`	—
`options` Options controlling safety checks and drive integration	`object`	no	`—`	—
└`safety_checks` Safety check settings	`object`	no	`—`	—
└`enabled` Whether to run content moderation. Defaults to true.	`boolean`	no	`—`	—
└`drive` Save result to Picsart Drive	`object`	no	`—`	—
└`name` File name in Picsart Drive	`string`	yes	`—`	—
└`attributes` Custom attributes to attach to the file	`object`	no	`—`	—
└`folder` Target folder in Picsart Drive	`object`	no	`—`	—
└`inputs_transformation` Input transformation settings	`object`	no	`—`	—
└`downscale_oversized_images` Whether to downscale oversized input images. Defaults to false.	`boolean`	no	`—`	—

Response

Over HTTP the output arrives inside a status envelope, at response.result. ai.apis.run() unwraps that envelope for you and resolves to { result, usage } instead. Either way the result itself is the vendor's own shape.

json

{
  "result": {
    "video_url": "https://cdn.picsart.com/…/result.mp4",
    "last_frame_url": "https://cdn.picsart.com/…/result.jpg",
    "output_format": "…",
    "draft_task": {},
    "mimeType": "video/mp4",
    "driveFile": {
      "id": "wf_abc123"
    }
  }
}

json

{
  "status": "success",
  "response": {
    "result": {
      "video_url": "https://cdn.picsart.com/…/result.mp4",
      "last_frame_url": "https://cdn.picsart.com/…/result.jpg",
      "output_format": "…",
      "draft_task": {},
      "mimeType": "video/mp4",
      "driveFile": {
        "id": "wf_abc123"
      }
    }
  }
}

Seedance 2.5 API pricing

Rates

What this model costs, in USD. Every row is an exact rate — the columns are the settings that change it.

Charged after the request finishes, on what it actually used.

Tier	Use case	Rate
4K	Video → video	$0.0058 / 1K tokens
4K	Image → video	$0.0094 / 1K tokens
480p, 720p	Video → video	$0.0129 / 1K tokens
1080p	Video → video	$0.0141 / 1K tokens
480p, 720p	Image → video	$0.0214 / 1K tokens
1080p	Image → video	$0.0234 / 1K tokens

Estimated pricing

What a request is estimated at when it starts, before its usage is known. The final charge follows the usage rates above.

Tier	Use case	Rate
480p	Video → video	$0.1234 / sec
480p	Image → video	$0.2056 / sec
720p	Video → video	$0.2774 / sec
720p	Image → video	$0.4623 / sec
1080p	Video → video	$0.6824 / sec
4K	Video → video	$0.9332 / sec
1080p	Image → video	$1.138 / sec
4K	Image → video	$1.556 / sec

Seedance 2.5 API

Seedance 2.5 API playground

Params

Result

Other models from ByteDance

Seedance 2.5 API in TypeScript, Python and REST

Install the SDK

Authenticate

Make a request

Async (submit & poll)

Parameters

Response

Seedance 2.5 API advanced usage

Overview

Make a request

Async (submit & poll)

Parameters

Response

Seedance 2.5 API pricing

Rates

Estimated pricing

Seedance 2.5 API usage