doubao-seedance-2.0

Quick example

curl https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer rk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-face",
    "prompt": "A kitten yawning at the camera, cinematic warm tones",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5
  }'

import requests

resp = requests.post(
    "https://reapi.ai/api/v1/videos/generations",
    headers={
        "Authorization": "Bearer rk_live_xxx",
        "Content-Type": "application/json",
    },
    json={
        "model": "doubao-seedance-2.0-face",
        "prompt": "A kitten yawning at the camera, cinematic warm tones",
        "resolution": "720p",
        "size": "16:9",
        "duration": 5,
    },
    timeout=30,
)
print(resp.json())

const r = await fetch("https://reapi.ai/api/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer rk_live_xxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "doubao-seedance-2.0",
    prompt: "A kitten yawning at the camera, cinematic warm tones",
    resolution: "720p",
    size: "16:9",
    duration: 5,
  }),
});
console.log(await r.json());

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    body, _ := json.Marshal(map[string]any{
        "model":      "doubao-seedance-2.0-face",
        "prompt":     "A kitten yawning at the camera, cinematic warm tones",
        "resolution": "720p",
        "size":       "16:9",
        "duration":   5,
    })
    req, _ := http.NewRequest("POST",
        "https://reapi.ai/api/v1/videos/generations", bytes.NewReader(body))
    req.Header.Set("Authorization", "Bearer rk_live_xxx")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    out, _ := io.ReadAll(resp.Body)
    fmt.Println(string(out))
}

Submit response

{
  "id": "task_018f5a3a1b6e7d9f8c2b4d6e8f0a2c4e",
  "model": "doubao-seedance-2.0-face",
  "status": "processing",
  "created_at": 1735000000
}

Poll GET /api/v1/tasks/{id} (see the Tasks reference) until status === "completed". The completed payload's output.video_urls holds the generated MP4 URL, valid for 7 days. output.last_frame_url is present when the request set return_last_frame: true.

Authentication

Every call needs a Bearer token. Generate keys at reapi.ai/settings/apikeys.

Authorization: Bearer YOUR_API_KEY

Keys carry the active workspace's billing scope — there is no separate project header.

Endpoint

POST /api/v1/videos/generations
GET  /api/v1/tasks/{id}

Submission is async. The POST returns immediately with a task_id; the task endpoint returns the same envelope until completion. Polling does not consume credits.

Variants

doubao-seedance-2.0 is a family of two variants sharing one parameter shape. Pick via model:

reAPI never silently substitutes one variant for another. Sending resolution: "1080p" to the Fast variant returns 400, never an auto-downgraded clip.

Channels

The variants above ship across two channels — same async endpoint, selected by the model id you send:

Standard and Official share the parameter shape documented below.

Mode routing

doubao-seedance-2.0 picks its mode from which media fields you set — there is no mode parameter:

Request body

model — required

string. One of the four variants in the table above.

prompt — string, required

Required on every request, min 3 characters, up to 20,000 (≤ 500 recommended — quality drops past ~500 chars on the upstream model). Applies to all modes — T2V, I2V, FRAMES, REF.

Best results come from naming, in order, the subject, the action, the camera move, and the style. e.g. "A kitten, yawning into the camera, slow push-in, cinematic warm tones".

duration — integer, default 5

Output length in seconds: 4–15.

doubao-seedance-2.0, doubao-seedance-2.0-face and doubao-seedance-2.0-official additionally accept -1, which lets the model choose the length. -1 reserves credits at the 15 s cap and settles to the delivered length once the video is ready — the difference is refunded automatically. The -fast and mini tiers do not support -1, and with the content filter on, -1 is not available at 4k — pick an explicit duration for 4k output (the request is rejected with 400, code 20003, before anything is charged).

Output length in seconds. Any integer in [4, 15]. Out-of-range → 400.

size — string, default "adaptive"

Output ratio. One of:

Invalid values → 400 (no silent fallback).

resolution — string, default "720p"

480p / 720p / 1080p / 4k — lowercase only. Drives pricing. Uppercase forms like 1080P are rejected with 400.

generate_audio — boolean, default true

When true (the default), the model synthesizes an audio track that plays alongside the generated video; pass false to get a silent clip. Independent of audio_urls (which is a reference for the model to align with — not a synthesis toggle).

bitrate_mode — enum, default "default"

Available across Seedance 2.0, Fast, Mini, and 2.5, including all channels. This is reAPI output processing after generation.

• "default" or omitted: return the original file without processing or re-encoding. This is the default setting.
• "standard": compress for smaller files and faster downloads.
• "high": apply lighter compression to retain more detail than standard, usually producing a larger file. It does not enhance the original video.

Processing preserves resolution, frame timing, audio, and the MP4/MOV container. If encoding would increase file size, the original file is kept. The generation charge is unchanged. Processing adds time and supports source files up to 1 GiB; savings vary by video.

Legacy booleans remain accepted: false maps to "default", and true maps to "standard". Other values return 400 before charging. Processing or storage failures follow the existing task failure/refund policy; an unprocessed source URL is not silently substituted after a processing failure.

{ "bitrate_mode": "default" }

Response envelope

Submit and poll share the same shape — only status and output fill in over time.

{
  "id": "task_018f5a3a1b6e7d9f8c2b4d6e8f0a2c4e",
  "model": "doubao-seedance-2.0-face",
  "status": "completed",
  "created_at": 1735000000,
  "output": {
    "video_urls": ["https://cdn.reapi.ai/media/tasks/018f5a3a1b6e7d9f8c2b4d6e8f0a2c4e/0.mp4"],
    "last_frame_url": "https://cdn.reapi.ai/media/tasks/018f5a3a1b6e7d9f8c2b4d6e8f0a2c4e/0.png"
  },
  "error": null
}

Validation errors

All cases below return HTTP 400 with the noted code. Pattern-match on code, not message — message strings carry request-specific context (field names, observed values) and are not a stable contract.

The full envelope is { "error": { "code", "message", "request_id" } } — see Errors catalog for wire format and request_id correlation.

Recipes

T2V — text-to-video

{
  "model": "doubao-seedance-2.0-face",
  "prompt": "A kitten yawning at the camera, slow push-in, warm tones",
  "resolution": "720p",
  "size": "16:9",
  "duration": 5,
  "fallback": { "enabled": false }
}

I2V — single reference image

{
  "model": "doubao-seedance-2.0-face",
  "prompt": "The kitten stands up and walks toward the camera",
  "image_urls": ["https://your-cdn.com/cat.jpg"],
  "duration": 5
}

FRAMES — first / last frame transition

{
  "model": "doubao-seedance-2.0-face",
  "prompt": "Smooth transition from day to night",
  "image_with_roles": [
    { "url": "https://your-cdn.com/day.jpg",   "role": "first_frame" },
    { "url": "https://your-cdn.com/night.jpg", "role": "last_frame"  }
  ],
  "duration": 5
}

REF — reference video (style transfer)

{
  "model": "doubao-seedance-2.0-face",
  "prompt": "Restylize the reference clip into anime aesthetics",
  "video_urls": ["https://your-cdn.com/reference.mp4"]
}

REF — reference video + reference audio

{
  "model": "doubao-seedance-2.0-face",
  "prompt": "A scene of a person speaking",
  "video_urls": ["https://your-cdn.com/reference.mp4"],
  "audio_urls": ["https://your-cdn.com/speech.wav"],
  "size": "16:9",
  "duration": 11
}

Voiced video (synthesized audio)

{
  "model": "doubao-seedance-2.0-face",
  "prompt": "A man calls out to a woman: \"Remember — never point at the moon with your finger.\"",
  "generate_audio": true
}

Continuous video chain

Step 1 — produce a 5s clip and ask for the last-frame URL:

{
  "model": "doubao-seedance-2.0-face",
  "prompt": "The kitten approaches the camera",
  "image_urls": ["https://your-cdn.com/kitten-start.png"],
  "return_last_frame": true
}

Step 2 — feed output.last_frame_url as image_urls of the next call:

{
  "model": "doubao-seedance-2.0-face",
  "prompt": "The kitten turns and walks away",
  "image_urls": ["<paste output.last_frame_url from step 1>"]
}

Fast variant — quick timelapse

{
  "model": "doubao-seedance-2.0-fast-face",
  "prompt": "City nightscape timelapse",
  "size": "21:9",
  "duration": 8
}

Multi-modal — images + reference video + reference audio

The full REF surface — combine all three reference types for tightly directed product / brand spots.

{
  "model": "doubao-seedance-2.0-face",
  "prompt": "First-person POV product ad with dynamic camera moves",
  "image_urls": [
    "https://your-cdn.com/product-1.jpg",
    "https://your-cdn.com/product-2.jpg"
  ],
  "video_urls": ["https://your-cdn.com/style-ref.mp4"],
  "audio_urls": ["https://your-cdn.com/bgm.mp3"],
  "generate_audio": true,
  "size": "16:9",
  "duration": 11
}

Choosing a variant

Variants are independent products — reAPI never rewrites your selected model on the primary attempt. Standard variants can still use the fallback policy above after an eligible generation-side failure.

Polling pattern

The task endpoint behaves identically to image tasks — only the completed output shape differs (video_urls / last_frame_url instead of image_urls). A pragmatic schedule:

0–5 minutes:    poll every 5s
5 min – 1 h:    back off gradually toward 1 min
≥ 1 h:          cap at 3 min between polls

A typical task completes in a few minutes. A single generation attempt can run for up to 48 hours; when fallback is enabled, the overall task window can cover two generation attempts.

Pricing

Per-second × billable seconds, where:

billable_seconds = sum(video_urls clip lengths, server-probed)
                 + duration

video_urls clip lengths are measured server-side via ffmpeg metadata — client-stated values are never trusted for billing. Image and audio references don't add to billable time. T2V / I2V / FRAMES requests (no video_urls) bill on duration alone.

The per-second rate depends on three axes:

• Variant (2 options)
• Resolution (480p / 720p / 1080p / 4k)
• Mode — text (no media references) vs. ref (any of image_urls, image_with_roles, video_urls, audio_urls is set)

REF rates are lower than text rates at every cell. See live numbers on the model page — that table is dynamic and always reflects the current rate.

Bill formula (1 credit = $0.001):

credits = ceil(per_second_usd × billable_seconds × 1000)

Charge on submit; refund automatically on failed. Probe failures (unreachable / unreadable video_urls) return 400 PRICING_UNAVAILABLE with no charge.

When fallback is enabled, reAPI reserves the larger of the primary and fallback attempt prices. The final successful task is settled to the winning attempt's price and the difference is refunded automatically. If both attempts fail, the full reserve is refunded.

Tips

• Prompt motion, not just scene. "Slow push-in, warm tones, shallow depth of field" outperforms a noun-list of what's on screen.
• Sweet-spot duration: 5–10 seconds. Below 5s motion looks choppy; above 10s generation time grows fast.
• Trim reference clips before upload. Both their actual length AND your duration count toward the bill. A 2-second style snippet is usually enough to convey style — there's no quality bonus for uploading a 15s reference.
• Pick doubao-seedance-2.0-fast for iteration. Fast variants cost noticeably less and miss only the 1080p tier — perfect for prompt-tuning loops where final quality comes later.
• Real people → Face variants. The non-Face variants reject identifiable real-person assets during generation; switching is a one-character change to model.
• Chain continuous video with return_last_frame. Pass the returned URL as image_urls of the next request. No prompt drift between segments.

Related

• Errors catalog
• Authentication
• Quickstart
• Pricing — Seedance 2.0