Seedance 2.5 API Specifications on PiAPI

The Seedance 2.5 API is live on PiAPI through POST /api/v1/task using model seedance and task type seedance-2.5. It supports text-to-video, first/last-frame, and omni-reference modes, 1–30-second videos, 480p or 720p output, multimodal references, and optional audio generation.
Use the table below for the confirmed PiAPI contract, or test the same request fields in the live Seedance 2.5 playground.
Seedance 2.5 API Specifications at a Glance
PiAPI exposes one Seedance 2.5 task type. The table summarizes its confirmed request fields, output controls, and reference limits as verified on July 31, 2026.
| Specification | Seedance 2.5 on PiAPI |
|---|---|
| Endpoint | POST https://api.piapi.ai/api/v1/task |
| Authentication | X-API-Key header |
| Model | seedance |
| Task type | seedance-2.5 |
| Prompt | Up to 4,000 characters |
| Modes | text_to_video, first_last_frames, omni_reference |
| Duration | Any integer from 1 to 30 seconds |
| Resolution | 480p or 720p; default 720p |
| Aspect ratios | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
| Audio generation | Boolean audio switch |
| Image references | Up to 9 |
| Video references | Up to 3 |
| Audio references | Up to 3 |
| Total references | Up to 12 across all reference types |
Supported Seedance 2.5 Generation Modes
text_to_video
Generate a video from a prompt without supplying reference media. Set the duration, resolution, aspect ratio, and audio preference directly in the request.
first_last_frames
Use image URLs to control the first and/or last frame of the generated video. In the PiAPI playground, the supplied frames determine the output shape, so it does not send a separate aspect ratio for this mode.
omni_reference
Combine image, video, and audio URLs to guide the subject, motion, scene, or sound. A request can contain up to 12 references in total, subject to the individual caps of 9 images, 3 videos, and 3 audio files.
Seedance 2.5 API Request Example
This cURL request creates a 10-second, 720p text-to-video task with audio enabled. Keep the API key on your server and replace the example prompt with the scene your application needs.
curl --request POST "https://api.piapi.ai/api/v1/task" \
--header "X-API-Key: $PIAPI_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "seedance",
"task_type": "seedance-2.5",
"input": {
"prompt": "A cinematic tracking shot through a futuristic city at night",
"mode": "text_to_video",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": true
}
}'Seedance 2.5 Pricing and Current Limits
Seedance 2.5 API pricing on PiAPI is $0.30 per output second at 480p and $0.60 per output second at 720p. A 10-second output therefore costs $3.00 at 480p or $6.00 at 720p. If a request includes input video, its duration is billed at half the selected output rate; this additional charge applies only when video references are supplied. See PiAPI pricing for broader platform information.
The current PiAPI contract does not expose 1080p or 4K output. It also has no fast, mini, or less-restriction variants. Because there is no less-restriction task type, private asset:// references are not supported by Seedance 2.5.
How to Access Seedance 2.5 on PiAPI
- Open the Seedance 2.5 page.
- Sign in to PiAPI.
- Run a prompt in the live playground.
For a backend integration, send an authenticated task request with model: "seedance" and task_type: "seedance-2.5" using the request shape above.
Seedance 2.5 API FAQ
How do I access the Seedance 2.5 API on PiAPI?
Use either PiAPI's live Seedance 2.5 playground or the task API. For API access, send POST /api/v1/task from your backend with an X-API-Key header, model seedance, and task type seedance-2.5.
Can Seedance 2.5 generate a 30-second video?
Yes. The PiAPI implementation accepts any integer duration from 1 to 30 seconds, with 30 seconds as the maximum. You are not limited to preset values such as 5, 10, or 15 seconds. The final price depends on the selected resolution and any input-video duration.
Does the Seedance 2.5 API support 4K video?
No. Seedance 2.5 on PiAPI currently supports 480p and 720p output, with 720p as the default. The confirmed API contract does not expose 1080p or 4K, so applications should submit only 480p or 720p.
Try Seedance 2.5 on PiAPI
On PiAPI, the Seedance 2.5 API supports three generation modes, 1–30-second output, multimodal references, audio control, and per-second pricing. Try Seedance 2.5 on PiAPI, then reuse the same request contract in your application.
Source and verification: PiAPI's live Seedance 2.5 product page and playground contract, verified July 31, 2026.

