API NeedUsage-based
Uptime
Total Context
N/A
Max Output
N/A
Input
Usage-based/ 1M
Output
Usage-based/ 1M
Cache Read
Route priced
Cache Write
Route priced
BSeedance 2.0 (Real Face) API
seedance-2.0
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.
MODALITIES
PriceUsage-based pricing · final cost depends on request and usageCONTEXTN/A
Playground
Generate with Seedance 2.0 (Real Face), review the output, and use the same request shape in your application.
Generation controls are waiting for verified model capability metadata.
Output Ready
Request preview
{
"model": "seedance-2.0",
"workflow": "text_to_video",
"input": {
"prompt": "A cinematic product shot with deliberate camera movement, natural lighting, and a clear beginning and end."
},
"output": {
"duration_seconds": 1
}
}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
Compare the published baseline with APINEED pricing for Seedance 2.0 API. Final generation cost follows completed server usage. [3]
APINEEDUsage-based
Prepaid creditsInput Usage-based/ 1MOutput Usage-based/ 1M
Availability
APINEED monitors Seedance 2.0 API availability. Applications should preserve request and task IDs and handle upstream failures explicitly.
System statusLast 90 days
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/media/generations.
curl https://apineed.com/v1/media/generations \
-H "Authorization: Bearer $API_NEED_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0",
"workflow": "text_to_video",
"input": {
"prompt": "A cinematic product shot with deliberate camera movement, natural lighting, and a clear beginning and end."
},
"output": {
"duration_seconds": 1
}
}'Poll the task
Save id, then poll GET /v1/media/generations/{id} every few seconds until the task is succeeded or failed.
curl https://apineed.com/v1/media/generations/$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 direct object-storage output URLs.
POST
/v1/media/generations- Authorization
- Bearer $API_NEED_API_KEY
- Content-Type
- application/json
- HTTP-Referer
- optional - your site URL, for rankings
- Model
- seedance-2.0
GET
/v1/media/generations/{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. |
workflow | string | text_to_video, image_to_video, video_reference | Selects a workflow published by the APINEED model catalog. |
input.prompt | string | Required | Describe the scene, motion, camera, lighting, and ending state. |
input.assets | array | Up to 2 | Temporary media URLs with the verified first-frame, last-frame, or reference-video role. |
output.duration_seconds | integer | 1-3600 | Verified duration seconds control published by the APINEED model catalog. |
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/media/generations.
Track the task
Poll the returned task ID and store the completed video URL from outputs[].