doubao-seedance-2.0-fast-face

Quick example

curl https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-fast-face",
    "prompt": "A street dancer spins under neon signs at night, handheld tracking shot",
    "resolution": "720p",
    "size": "9:16",
    "duration": 5
  }'

import requests

resp = requests.post(
    "https://reapi.ai/api/v1/videos/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "doubao-seedance-2.0-fast-face",
        "prompt": "A street dancer spins under neon signs at night, handheld tracking shot",
        "resolution": "720p",
        "size": "9:16",
        "duration": 5,
    },
    timeout=30,
)
print(resp.json())

const r = await fetch("https://reapi.ai/api/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "doubao-seedance-2.0-fast-face",
    prompt: "A street dancer spins under neon signs at night, handheld tracking shot",
    resolution: "720p",
    size: "9:16",
    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-fast-face",
        "prompt":     "A street dancer spins under neon signs at night, handheld tracking shot",
        "resolution": "720p",
        "size":       "9:16",
        "duration":   5,
    })
    req, _ := http.NewRequest("POST",
        "https://reapi.ai/api/v1/videos/generations", bytes.NewReader(body))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    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))
}

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 the task id; poll GET /api/v1/tasks/{id} with it until the task completes. Polling does not consume credits.

Variants

Two variants, one parameter shape. Pick via model:

Both accept real-person reference images and clips, and both carry the content_filter switch. Neither accepts duration: -1 — set an explicit length. For 1080p, 4k or automatic duration, use Seedance 2.0.

seedance-2.0-fast-pr is the official Fast model at reseller pricing, on its own per-second rates. Same request body, except tools (web search): a request carrying it is accepted, then its task fails with code 80007 and the credits are refunded in full.

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

Request body

Mode is implicit — which media fields you set decides text-to-video, image-to-video, first/last-frame, or reference-driven generation (see Task types).

Checked before anything is submitted or charged:

• prompt is present on every request (3–20000 chars)
• resolution is 480p or 720p, and duration is a whole number from 4 to 15
• image_urls and image_with_roles are mutually exclusive (both carry reference images — pick one)
• at most one first_frame and one last_frame, and a last_frame always needs a first_frame (there is no last-frame-only task type)
• frame roles and reference_image cannot share one image_with_roles array, and frame roles cannot be combined with video_urls / audio_urls
• audio_urls needs a visual reference (an image or a clip) alongside it
• reference clips: 3 max, 15 s combined; reference audio: each 2–15 s, 3 max, 15 s combined

There is no seed on Seedance 2.0 Fast — the upstream model does not support one, so the field is rejected rather than silently ignored.

bitrate_mode — enum, default "default"

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.

{ "bitrate_mode": "default" }

content_filter — boolean, default true

With the default (true) the request runs on the moderated route: prompts, reference material and output are checked, and a rejection fails the task with a refund.

Set content_filter: false to run the same request on the unmoderated route instead. What changes:

• API keys only. A non-admin website session that sends content_filter: false is rejected with 400 before anything is charged; the playground runs moderated for normal users.
• Same parameters, same price. Every field, tier gate and rate in this document applies unchanged — which channel served the request is internal. The route still caps at 720p.
• Output storage. On doubao-seedance-2.0-fast-face the output lands in an isolated bucket and its URLs stay valid for 30 days. On seedance-2.0-fast-pr the result URLs are returned as delivered (unless you set bitrate_mode) and carry no retention guarantee. Either way, mirror the files you want to keep.

Platform terms apply to everything you generate on either route.

{
  "model": "doubao-seedance-2.0-fast-face",
  "prompt": "A street dancer spins under neon signs at night",
  "resolution": "720p",
  "duration": 5,
  "content_filter": false
}

Task types and constraints

Seedance 2.0 Fast picks its job from the media fields you send — there is no mode parameter:

Troubleshooting

Response envelope

The submit call returns { "id", "model", "status": "processing", "created_at" }. Polling GET /api/v1/tasks/{id} returns the full envelope below; output and error fill in when the task finishes.

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

Poll GET /api/v1/tasks/{id} (see the Tasks reference) until status === "completed". Generated URLs expire — mirror them to your own storage if you need long-term retention.

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.

reAPI then reads each reference file before charging. These checks also return 400 with code 20003:

A reference video whose length cannot be read fails with code 30002; the message contains Could not determine source video duration for billing:. Nothing is charged.

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

Pricing

Seedance 2.0 Fast bills per second of video, at a rate that depends on three axes:

• Variant — doubao-seedance-2.0-fast-face or seedance-2.0-fast-pr, each on its own rates
• Resolution — 480p / 720p
• Mode — ref when the request uploads a reference video (video_urls), text otherwise. Reference images, frames and audio do not change the mode. ref rates are lower than text rates at every cell

credits = ceil(per_second_rate × billable_seconds × 1000)     1 credit = $0.001

Live per-second rates are on the model page — that table is generated from the current price, so it is always the authoritative number. Failed jobs are always refunded in full.

A reference video is billed too, on top of the output

Send video_urls and you pay for the source footage plus the generated clip:

billable_seconds = min(30, ceil(total_length_of_video_urls) + duration)

reAPI measures every reference clip server-side, so this is the real length of the file, not a value you declare. Reference images and audio are free — they add no seconds. A 5-second source clip with duration: 6 bills 11 seconds at the ref rate; the same request without video_urls bills 6 seconds at the (higher) text rate.

Recipes

Text-to-video, vertical:

{
  "model": "doubao-seedance-2.0-fast-face",
  "prompt": "A street dancer spins under neon signs at night, quick handheld tracking shot",
  "resolution": "720p",
  "size": "9:16",
  "duration": 5
}

First / last frame transition:

{
  "model": "doubao-seedance-2.0-fast-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
}

Reference clip plus reference audio (the clip's length is billed on top of duration; the audio adds no seconds):

{
  "model": "seedance-2.0-fast-pr",
  "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": 6
}

Continuous chain — request the last frame, then pass output.last_frame_url to the next call in image_with_roles with role first_frame:

{
  "model": "doubao-seedance-2.0-fast-face",
  "prompt": "The dancer turns toward the camera",
  "image_with_roles": [
    { "url": "https://your-cdn.com/dancer-start.png", "role": "first_frame" }
  ],
  "return_last_frame": true
}

Related

• Seedance 2.0
• Seedance 2.0 Mini
• Seedance 2.5
• Errors catalog
• Authentication
• Quickstart