Seedance 2.0 (Real Face) API
Seedance 2.0 API is APINEED's standard video route for text-to-video and reference-guided workflows, including projects that require real human faces.
ByteDance describes Seedance 2.0 as a unified audio-video model for text, image, audio, and video inputs, with stronger complex motion, multimodal references, editing, extension, and synchronized sound. APINEED V1 exposes text, image, and video-reference workflows through one asynchronous task API and publishes local references with short-lived object-storage URLs.
Playground
Generate with Seedance 2.0 (Real Face), review the output, and use the same request shape in your application.
Choose Seedance 2.0 when a prompt or reference requires a real person. Save variants exclude real human faces. Compare Seedance 2.0 Save
Request preview
{
"model": "seedance-2.0",
"prompt": "A cinematic 5-second shot of a designer desk at sunrise. The camera slowly pushes in, dust moves through the light, realistic reflections, no text overlay.",
"seconds": "5",
"metadata": {
"resolution": "720p",
"ratio": "16:9",
"generate_audio": false,
"watermark": false
}
}Providers
ByteDance documents the broader model capability. APINEED separately defines the model ID, endpoint, parameter whitelist, authentication, and billing behavior shown on this page.
Discount
Official Seedance 2.0 API pricing varies by resolution and whether the request includes video input. All rates are shown in USD, with the APINEED prepaid price calculated at 5% off. [3]
| Resolution | Input condition | Official price | APINEED price |
|---|---|---|---|
| 480p | Includes video input | $4.18 | $3.975% off |
| Excludes video input | $6.87 | $6.525% off | |
| 720p | Includes video input | $4.18 | $3.975% off |
| Excludes video input | $6.87 | $6.525% off | |
| 1080p | Includes video input | $4.63 | $4.405% off |
| Excludes video input | $7.61 | $7.235% off |
Availability
APINEED monitors Seedance 2.0 API availability. Applications should preserve request and task IDs and handle upstream failures explicitly.
Complex motion and interaction
ByteDance reports improved physical plausibility and stability for multi-subject interaction, sports, and precisely timed action. [1]
Multimodal reference
The official model accepts text plus as many as nine images, three video clips, and three audio clips to guide composition, identity, motion, camera language, effects, and sound. [1][2]
Editing and continuation
Official workflows include targeted changes to clips, characters, actions, and storylines as well as extending an existing scene. [1]
Synchronized audiovisual output
ByteDance documents multi-shot output up to 15 seconds with dual-channel audio and aligned dialogue, ambience, music, and effects. [1]
APINEED V1 boundary
APINEED creates one task at a time. Local image and video references are uploaded directly to temporary private object storage before their short-lived URLs are submitted. [3]
Seedance 2.0 prompting tips
Block the action. Describe subjects, action order, camera movement, lighting, environment, and timing in concrete terms.
Quote dialogue. Place spoken lines in double quotes and identify the speaker to reduce ambiguity.
Assign each reference. Explain which asset provides the subject, scene, motion, camera style, or sound.
Separate edits from preservation. State what should change and what motion, identity, framing, or style must remain.
Quick Start
Call Seedance 2.0 with the verified APINEED endpoint and model-specific request shape.
Create an API key
Store your APINEED key server-side as API_NEED_API_KEY.
export API_NEED_API_KEY=sk-apineed-v1-...Send the request
Use seedance-2.0 with POST /v1/videos.
curl https://apineed.com/v1/videos \
-H "Authorization: Bearer $API_NEED_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0",
"prompt": "A cinematic 5-second shot of a designer desk at sunrise. The camera slowly pushes in, dust moves through the light, realistic reflections, no text overlay.",
"seconds": "5",
"metadata": {
"resolution": "720p",
"ratio": "16:9",
"generate_audio": false,
"watermark": false
}
}'Poll the task
Save task_id, then poll GET /v1/videos/{task_id} every few seconds until the task is completed or failed.
curl https://apineed.com/v1/videos/$TASK_ID -H "Authorization: Bearer $API_NEED_API_KEY"Seedance 2.0 API Endpoint
Create an asynchronous video task, then use its task ID to retrieve status and the completed video URL.
/v1/videos- Authorization
- Bearer $API_NEED_API_KEY
- Content-Type
- application/json
- HTTP-Referer
- optional - your site URL, for rankings
- Model
- seedance-2.0
/v1/videos/{task_id}- Authorization
- Bearer $API_NEED_API_KEY
- Content-Type
- application/json
- HTTP-Referer
- optional - your site URL, for rankings
- Model
- seedance-2.0
Parameters
These controls follow APINEED's current DTO and adapter behavior. Unsupported upstream-only fields are intentionally omitted.
| Name | Type | Values | Description |
|---|---|---|---|
model | string | Required | Use seedance-2.0. |
prompt | string | Required | Describe the scene, motion, camera, and constraints for Seedance 2.0. |
seconds | string | 4-15 | Duration for the Seedance task. The page does not send top-level duration. |
images | string[] | Optional | Reference image URLs or data URLs for API integrations. |
metadata.resolution | string | 480p, 720p, 1080p | Resolution sent in Seedance metadata. |
metadata.ratio | string | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 | Aspect ratio sent as ratio. |
metadata.content[].video_url | object | Optional | Required API structure for video-reference billing and routing. |
metadata.generate_audio | boolean | Optional | Controls native audio generation. |
metadata.watermark | boolean | Optional | Controls watermark forwarding. |
Seedance 2.0 (Real Face) API questions
Practical answers for choosing, integrating, pricing, and operating the Seedance 2.0 API on APINEED.
What work is Seedance 2.0 API suited to?
It is suited to cinematic text-to-video, complex multi-subject action, reference-directed commercials, scene editing, continuation, and audiovisual sequences where motion and sound must remain coordinated. [1][2]
How does standard Seedance 2.0 differ from Fast and Save?
Standard is the full-quality APINEED route and permits real-person workflows. Fast is the accelerated variant; Save routes are APINEED variants that exclude real human faces. [2][3]
Which official Seedance inputs exist, and which are live here?
The official model supports text, image, audio, and video references. This APINEED playground currently exposes text, image references, and one video reference; local files are converted to short-lived URLs before submission. [1][2][3]
Which endpoint does Seedance 2.0 use?
Submit seedance-2.0 to POST /v1/videos, save the returned task_id, and poll GET /v1/videos/{task_id}. [3]
Why does the request use seconds instead of duration?
The Seedance adapter reads top-level seconds. A top-level duration value passes general validation but does not enter the current Seedance payload. [3]
How are API video references represented?
Place each video reference in metadata.content as a video_url item. That structure is also used to recognize video-input pricing. [3]
How should an application handle completion and failure?
Poll every few seconds until completed or failed. Read the completed URL from metadata.url and preserve error.message plus error.code when the task fails. [3]
How to deploy Seedance 2.0 (Real Face)
Connect Seedance 2.0 (Real Face) to your application through the APINEED media API.
Add credits
Add APINEED credits before submitting a billable generation.
Create an API key
Create and securely store an APINEED API key.
Configure the endpoint
Send seedance-2.0 requests to /v1/videos.
Track the task
Poll the returned task ID and store the completed video URL.
