ByteDance logo

Seedance 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
PriceFrom $3.97 / 1M output tokensCONTEXTN/A

Playground

Generate with Seedance 2.0 (Real Face), review the output, and use the same request shape in your application.

Standard route with real-face support

Choose Seedance 2.0 when a prompt or reference requires a real person. Save variants exclude real human faces. Compare Seedance 2.0 Save

Workflow
From $3.97 / 1M output tokensSign in required. Final cost uses completed usage.
Output Ready
Sample output
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.

API Need5% off
Uptime
Total Context
N/A
Max Output
N/A
Input
Free/ 1M
Output
$3.97/ 1M
Cache Read
Route priced
Cache Write
Route priced

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]

Seedance 2.0 videoUSD / 1M output tokens
ResolutionInput conditionOfficial priceAPINEED price
480pIncludes video input$4.18$3.975% off
Excludes video input$6.87$6.525% off
720pIncludes video input$4.18$3.975% off
Excludes video input$6.87$6.525% off
1080pIncludes 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.

System statusLast 90 days
APINEED GATEWAY99.19% uptime

Seedance 2.0 API capabilities

Seedance 2.0 is ByteDance's full-quality route for complex motion and mixed-media direction. The official model is broader than the controls currently exposed by APINEED. [1][2][3]

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.

1

Create an API key

Store your APINEED key server-side as API_NEED_API_KEY.

export API_NEED_API_KEY=sk-apineed-v1-...
2

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
  }
}'
3

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.

POST/v1/videos
Authorization
Bearer $API_NEED_API_KEY
Content-Type
application/json
HTTP-Referer
optional - your site URL, for rankings
Model
seedance-2.0
GET/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.

NameTypeValuesDescription
modelstringRequiredUse seedance-2.0.
promptstringRequiredDescribe the scene, motion, camera, and constraints for Seedance 2.0.
secondsstring4-15Duration for the Seedance task. The page does not send top-level duration.
imagesstring[]OptionalReference image URLs or data URLs for API integrations.
metadata.resolutionstring480p, 720p, 1080pResolution sent in Seedance metadata.
metadata.ratiostring16:9, 9:16, 1:1, 4:3, 3:4, 21:9Aspect ratio sent as ratio.
metadata.content[].video_urlobjectOptionalRequired API structure for video-reference billing and routing.
metadata.generate_audiobooleanOptionalControls native audio generation.
metadata.watermarkbooleanOptionalControls 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.

1

Add credits

Add APINEED credits before submitting a billable generation.

2

Create an API key

Create and securely store an APINEED API key.

3

Configure the endpoint

Send seedance-2.0 requests to /v1/videos.

4

Track the task

Poll the returned task ID and store the completed video URL.

More live models