Seedance API

Run ByteDance Seedance 2.0 Mini via one REST API across text-to-video, image-to-video, reference-to-video, and start-end-frame-to-video. Generate 4 to 15 second MP4 clips starting at $0.045/s (480p) and $0.09/s default (720p).

Catalog scope note: E2X offers ByteDance Seedance 2.0 Mini (bytedance/seedance-2.0-mini/*) across four capabilities. Earlier Seedance 1.0 endpoints are not offered in the E2X catalog.

Endpoints Covered
4
Lowest Catalog Rate
$0.045/s
Capabilities
Text To Video, Image To Video, Start End Frame To Video, Reference To Video
Savings vs fal.ai
Up to 42%

01 / LIVE CATALOG PRICING

Real Catalog Pricing & Dynamic Tiers

Rates below are calculated dynamically from E2X micro-cent pricing rules and default resolution/quality multipliers.

Model & Endpoint SlugCapabilityDefault RateDynamic Pricing Tiers
Seedance 2.0 Mini Text-to-Video

bytedance/seedance-2.0-mini/text-to-video

Text To Video$0.09/s
480p:$0.045/s720p (default):$0.09/s
Seedance 2.0 Mini Image-to-Video

bytedance/seedance-2.0-mini/image-to-video

Image To Video$0.09/s
480p:$0.045/s720p (default):$0.09/s
Seedance 2.0 Mini Start-End Frame

bytedance/seedance-2.0-mini/start-end-frame-to-video

Start End Frame To Video$0.09/s
480p:$0.045/s720p (default):$0.09/s
Seedance 2.0 Mini Reference-to-Video

bytedance/seedance-2.0-mini/reference-to-video

Reference To Video$0.09/s
480p:$0.045/s720p (default):$0.09/s
Model job total with batch counts, resolution, and duration before spending credits.Estimate costs in the Pricing Calculator

02 / QUICKSTART CODE

SSR Code Samples (cURL, JavaScript, Python)

Submit requests directly against POST https://api.e2x.ai/v1/jobs/submit or use the official @e2x/sdk and Python e2x clients with "bytedance/seedance-2.0-mini/text-to-video".

cURLPOST bytedance/seedance-2.0-mini/text-to-video
curl -sS -X POST "https://api.e2x.ai/v1/jobs/submit" \
  -H "Authorization: Bearer $E2X_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.0-mini/text-to-video",
  "input": {
    "prompt": "Low tracking shot following a matte black street motorcycle along rain-slicked neon asphalt",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "5",
    "has_sound": true
  }
}'
JavaScriptNode.js / JavaScript (@e2x/sdk)
import { E2XClient } from '@e2x/sdk';

const e2x = new E2XClient({ apiKey: process.env.E2X_API_KEY });

const result = await e2x.jobs.run({
  model: 'bytedance/seedance-2.0-mini/text-to-video',
  input: {
    "prompt": "Low tracking shot following a matte black street motorcycle along rain-slicked neon asphalt",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "5",
    "has_sound": true
  },
});

console.log(result.output);
PythonPython (e2x SDK)
import os
from e2x import E2XClient

client = E2XClient(api_key=os.environ["E2X_API_KEY"])

job = client.jobs.run(
    model="bytedance/seedance-2.0-mini/text-to-video",
    input={
        "prompt": "Low tracking shot following a matte black street motorcycle along rain-slicked neon asphalt",
        "aspect_ratio": "16:9",
        "resolution": "720p",
        "duration": "5",
        "has_sound": True
    },
)

print(job.output)

03 / API RESPONSES & WEBHOOKS

Real API Response Payloads & Error Envelope

Submission, polling, HMAC-signed webhook callbacks, and error envelopes share one consistent JSON structure across all E2X endpoints.

POST /v1/jobs/submit (Queued Response)

JSON200 OK
{
  "success": true,
  "data": {
    "jobId": "job_01J9XK2M8N4P7Q3R5S6T8V0WXY",
    "status": "pending",
    "estimatedCompletionTime": 35,
    "costMicroCents": 120000
  },
  "requestId": "req_01J9XK2M8N4P7Q3R"
}

GET /v1/jobs/:jobId (Completed Output)

JSON200 OK
{
  "success": true,
  "data": {
    "jobId": "job_01J9XK2M8N4P7Q3R5S6T8V0WXY",
    "model": "bytedance/seedance-2.0-mini/text-to-video",
    "status": "completed",
    "progress": 100,
    "output": "https://assets.e2x.ai/generated/example.mp4",
    "outputs": [
      {
        "url": "https://assets.e2x.ai/generated/example.mp4",
        "type": "video"
      }
    ],
    "failedGenerations": [],
    "numberOfGenerations": 1,
    "requestedCount": 1,
    "successCount": 1,
    "failedCount": 0,
    "costMicroCents": 120000,
    "refundedMicroCents": 0,
    "error": null,
    "createdAt": "2026-11-13T10:00:00.000Z",
    "completedAt": "2026-11-13T10:00:18.000Z"
  },
  "requestId": "req_01J9XK2N1B2C3D4E"
}

Webhook Callback Body (X-E2X-Signature HMAC-SHA256)

JSONPOST webhookUrl
{
  "jobId": "job_01J9XK2M8N4P7Q3R5S6T8V0WXY",
  "requestId": "req_01J9XK2M8N4P7Q3R",
  "status": "completed",
  "output": "https://assets.e2x.ai/generated/example.mp4",
  "error": null,
  "completedAt": "2026-11-13T10:00:18.000Z"
}

Verify X-E2X-Signature (HMAC-SHA256 over <X-E2X-Timestamp>.<rawBody>). Read Webhook Signature & Retry docs →

Standard Error Envelope

JSON4xx / 5xx JSON Error
{
  "success": false,
  "error": {
    "code": "CONCURRENT_JOBS_EXCEEDED",
    "message": "Concurrent job limit reached for this model."
  },
  "requestId": "req_01J9XK2Q9W8E7R6T"
}

Every non-2xx response returns success: false with error.code and error.message. Browse API error codes →

04 / INPUT SCHEMA

Input Parameter Reference

Parameters and constraints extracted directly from the live endpoint JSON schemas for covered models.

ParameterTypeRequiredDefaultAllowed Values / ConstraintsEndpointsDescription
promptstringRequired—maxLength: 50000All 4 endpoints—
aspect_ratiostringOptional"16:9"enum: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16seedance-2.0-mini/text-to-video, seedance-2.0-mini/reference-to-video—
resolutionstringOptional"720p"enum: 480p, 720pAll 4 endpointsResolution
durationstringOptional"5"enum: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15All 4 endpointsDuration (seconds)
has_soundbooleanOptionaltrue—All 4 endpoints—
seedintegerOptional—range: 0..—All 4 endpoints—
image_urlstringRequired—format: uriseedance-2.0-mini/image-to-video, seedance-2.0-mini/start-end-frame-to-video—
end_frame_urlstringRequired—format: uriseedance-2.0-mini/start-end-frame-to-video—
reference_urlsstring[]Optional—items: 0..9seedance-2.0-mini/reference-to-videoReference images (max 9) — use @Image1..@Image9 in prompt
reference_video_urlsstring[]Optional—items: 0..3seedance-2.0-mini/reference-to-videoReference video clips (max 3) — use @Video1..@Video3 in prompt
reference_audio_urlsstring[]Optional—items: 0..3seedance-2.0-mini/reference-to-videoReference audio tracks (max 3) — use @Audio1..@Audio3 in prompt

05 / VERIFIED SAMPLE OUTPUTS

Catalog Sample Outputs

Example media served from assets.e2x.ai generated by endpoints in this family.

Seedance 2.0 Mini Text-to-Video (Text To Video) sample outputInspect →
Seedance 2.0 Mini Image-to-Video (Image To Video) sample outputInspect →
Seedance 2.0 Mini Reference-to-Video (Reference To Video) sample outputInspect →

06 / OPERATIONAL LIMITS

Rate Limits, Concurrency & Upload Constraints

Production enforcement limits enforced by the E2X gateway, worker dispatch, and Cloudflare R2 upload pipeline.

Account API rate tiers
Free: 10 req/min (100/hr, 1,000/day, 2 concurrent) · Pro: 100 req/min (5,000/hr, 50,000/day, 10 concurrent) · Enterprise: 1,000 req/min (50,000/hr, 500,000/day, 50 concurrent)
Default per-model concurrency
5 concurrent jobs per user/model unless overridden per model version (`CONCURRENT_JOBS_EXCEEDED` on overflow)
Gateway global burst protection
10,000 requests/minute gateway cap; fail-closed fallback limiter of 5 req/60s if Redis is unreachable
Batch generations per job
Maximum 16 outputs per POST /v1/jobs/submit request (`GENERATIONS_LIMIT_EXCEEDED` above 16)
Pre-flight estimate & R2 upload limits
POST /v1/jobs/estimate: 60 req/5 min · POST /v1/uploads/presign: 60 req/10 min, max 200 pending uploads, 10 MB images (JPEG/PNG/WEBP/GIF), 100 MB videos (MP4/WEBM)
Webhook delivery policy
HTTPS-only public endpoints (private/loopback SSRF blocked), 10s timeout per attempt, up to 5 attempts (0s, 1s, 4s, 16s, 64s), HMAC-SHA256 `X-E2X-Signature` header

Full per-tier quotas and retry guidance: Rate Limits & Concurrency Documentation →

07 / BENCHMARK COMPARISON

Unit-Normalized Pricing vs. fal.ai

Side-by-side comparison at default unit settings (pricing verified through 5 Nov 2026). Endpoints without a published competitor price render "—".

EndpointCapabilityE2X Default RateSourceCompetitor RateSavingsChecked
bytedance/seedance-2.0-mini/text-to-videoText To Video$0.09/sfal.ai$0.1547/s42%5 Nov 2026
bytedance/seedance-2.0-mini/image-to-videoImage To Video$0.09/sfal.ai$0.1547/s42%5 Nov 2026
bytedance/seedance-2.0-mini/start-end-frame-to-videoStart End Frame To Video$0.09/sfal.ai$0.1547/s42%5 Nov 2026
bytedance/seedance-2.0-mini/reference-to-videoReference To Video$0.09/sfal.ai$0.1547/s42%5 Nov 2026

08 / FAQ

Frequently Asked Questions — Seedance API

Verified answers reflecting live catalog models, pricing multipliers, and platform behavior.

Does E2X serve Seedance 1.0 or Seedance 2.0 Mini?
E2X offers ByteDance Seedance 2.0 Mini (bytedance/seedance-2.0-mini/*) across text-to-video, image-to-video, reference-to-video, and start-end-frame-to-video. Seedance 1.0 is not in the E2X catalog.
What are the per-second prices for Seedance 2.0 Mini?
480p renders cost $0.045/second (1x multiplier) and default 720p renders cost $0.09/second (2x multiplier). Total job cost multiplies the per-second rate by your chosen duration (4–15 seconds).
Does toggling sound change the Seedance 2.0 Mini price?
No. Although bytedance/seedance-2.0-mini accepts a boolean has_sound parameter (default true), pricing only scales by resolution (480p vs 720p) and duration (4 to 15 seconds).
Which aspect ratios and durations are supported?
All four Seedance 2.0 Mini endpoints support durations from 4 to 15 seconds (default 5) and aspect_ratio values 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, plus adaptive mode.
What multimodal references does Seedance 2.0 Mini reference-to-video accept?
reference-to-video accepts optional reference_images (up to 9), reference_videos (up to 3), and reference_audios (up to 3) using public HTTPS URLs or /v1/uploads/presign R2 uploads.
How does Seedance 2.0 Mini compare against fal.ai pricing?
At the default 720p tier, E2X charges $0.09/s compared to $0.1547/s checked on fal.ai, representing approximately 42% savings per second.