Seedance 2.0 Mini-API-Dokumentation
Alles, was Sie benötigen, um Seedance 2.0 Mini aus Ihrem Code aufzurufen. Basis-URL: https://cheapergen.com/api/v1. Probieren Sie es zuerst in Playground aus.
Verwenden Sie einen Coding-Agenten?
Fügen Sie dies in Claude Code, Cursor, Codex oder einen beliebigen Coding-Agenten ein. Er bindet die API in Ihr Projekt ein, speichert den Schlüssel in CHEAPERGEN_API_KEY und prüft den Preis kostenlos, bevor Kosten entstehen.
Add Seedance 2.0 Mini (CheaperGen endpoint bytedance/ seedance-2.0-mini/ text-to-video) to this project by following https:/ / cheapergen.com/ agents/ integrate.mdAuthentifizierung
Erstellen Sie in Dashboard → API keys einen Schlüssel und senden Sie ihn als Bearer-Token mit. Bewahren Sie Schlüssel ausschließlich auf Ihrem Server auf.
export CHEAPERGEN_API_KEY="cg_live_…"
# every request
Authorization: Bearer $CHEAPERGEN_API_KEYSeedance 2.0 Mini Text zu Video-API
/api/v1/run/bytedance/seedance-2.0-mini/text-to-videoÜbermittelt einen asynchronen Auftrag und gibt 202 mit einer Generierungs-ID zurück. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url. Siehe Ablauf eines Auftrags.
Eingabeparameter
| Name | Typ | Beschreibung | Beeinflusst den Preis |
|---|---|---|---|
prompterforderlich | string | Beschreiben Sie Motiv, Handlung, Kamerabewegung, Beleuchtung und Stil. | Kein |
aspect_ratio | string (enum) | Format des Ausgabebilds. Werte: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Standard: 16:9 | Ja |
resolution | string (enum) | Ausgabeauflösung. Höhere Auflösungen kosten pro Sekunde mehr. Werte: 480p · 720p Standard: 720p | Ja |
duration | integer | Länge des generierten Clips in Sekunden (4–15 s). Abrechnung pro Sekunde. Bereich: 4–15s Standard: 5 | Ja |
generate_audio | boolean | Generieren Sie synchronisierten Ton, Atmosphäre und Dialog. Ohne Aufpreis. Standard: true | Kein |
seed | integer | Verwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte. | Kein |
webhook_url | Zeichenfolge (URL) | Optional. Wir senden die abgeschlossene Generierung per POST an diese URL und signieren die Anfrage mit Ihrem Webhook-Schlüssel. Webhooks | Kein |
Anfrage
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/bytedance/seedance-2.0-mini/text-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Langsame Kamerafahrt auf einen Keramiker, der zur goldenen Stunde eine Vase formt, Staub im Licht, geringe Tiefenschärfe",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);Antwort
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "bytedance/seedance-2.0-mini",
"endpoint": "bytedance/seedance-2.0-mini/text-to-video",
"mode": "text-to-video",
"status": "queued",
"input": {
"prompt": "Langsame Kamerafahrt auf einen Keramiker, der zur goldenen Stunde eine Vase formt, Staub im Licht, geringe Tiefenschärfe",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Seedance 2.0 Mini Bild zu Video-API
/api/v1/run/bytedance/seedance-2.0-mini/image-to-videoÜbermittelt einen asynchronen Auftrag und gibt 202 mit einer Generierungs-ID zurück. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url. Siehe Ablauf eines Auftrags.
Eingabeparameter
| Name | Typ | Beschreibung | Beeinflusst den Preis |
|---|---|---|---|
prompterforderlich | string | Beschreiben Sie Motiv, Handlung, Kamerabewegung, Beleuchtung und Stil. | Kein |
image_urlerforderlich | string (URL) | Bild für das erste Einzelbild. JPG/PNG/WebP, URL oder Upload. | Kein |
end_image_url | string (URL) | Optionales Schlussbild – das Modell animiert den Übergang zwischen beiden. | Kein |
aspect_ratio | string (enum) | Format des Ausgabebilds. Werte: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Standard: 16:9 | Ja |
resolution | string (enum) | Ausgabeauflösung. Höhere Auflösungen kosten pro Sekunde mehr. Werte: 480p · 720p Standard: 720p | Ja |
duration | integer | Länge des generierten Clips in Sekunden (4–15 s). Abrechnung pro Sekunde. Bereich: 4–15s Standard: 5 | Ja |
generate_audio | boolean | Generieren Sie synchronisierten Ton, Atmosphäre und Dialog. Ohne Aufpreis. Standard: true | Kein |
seed | integer | Verwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte. | Kein |
webhook_url | Zeichenfolge (URL) | Optional. Wir senden die abgeschlossene Generierung per POST an diese URL und signieren die Anfrage mit Ihrem Webhook-Schlüssel. Webhooks | Kein |
Anfrage
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/bytedance/seedance-2.0-mini/image-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Die Kamera fährt näher heran, während sie sich umdreht und lächelt; ihr Haar bewegt sich im Wind",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);Antwort
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "bytedance/seedance-2.0-mini",
"endpoint": "bytedance/seedance-2.0-mini/image-to-video",
"mode": "image-to-video",
"status": "queued",
"input": {
"prompt": "Die Kamera fährt näher heran, während sie sich umdreht und lächelt; ihr Haar bewegt sich im Wind",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Seedance 2.0 Mini Referenz zu Video-API
/api/v1/run/bytedance/seedance-2.0-mini/reference-to-videoÜbermittelt einen asynchronen Auftrag und gibt 202 mit einer Generierungs-ID zurück. Fragen Sie GET /api/v1/generations/{id} ab oder übergeben Sie webhook_url. Siehe Ablauf eines Auftrags.
Eingabeparameter
| Name | Typ | Beschreibung | Beeinflusst den Preis |
|---|---|---|---|
prompterforderlich | string | Beschreiben Sie Motiv, Handlung, Kamerabewegung, Beleuchtung und Stil. | Kein |
reference_image_urls | string[] (URLs) | Bis zu 9 Bilder für Figuren, Produkte, Stil oder Szene. Verweisen Sie im Prompt mit @Image1, @Image2 usw. darauf. Maximale Anzahl: 9 | Kein |
reference_video_urls | string[] (video URLs) | Bis zu 3 MP4/MOV-Clips für Bewegung, Kamerafahrten oder Effekte (2–15 Sek. je, 15 s insgesamt, ≤ 50 MB insgesamt). Verweisen Sie mit @Video1, @Video2 usw. darauf. Referenzvideosekunden werden zusammen mit der Ausgabe zum niedrigeren Token-Tarif für Videoeingaben abgerechnet. Maximale Anzahl: 3 | Ja |
reference_audio_urls | string[] (audio URLs) | Bis zu 3 MP3/WAV-Clips für Stimme, Musik oder Ton (2–15 Sek. je, 15 s insgesamt, ≤ 15 MB je Datei). Verweisen Sie im Prompt mit @Audio1, @Audio2 usw. darauf. Es wird mindestens ein Referenzbild oder -video benötigt. Maximale Anzahl: 3 | Kein |
aspect_ratio | string (enum) | Format des Ausgabebilds. Werte: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Standard: 16:9 | Ja |
resolution | string (enum) | Ausgabeauflösung. Höhere Auflösungen kosten pro Sekunde mehr. Werte: 480p · 720p Standard: 720p | Ja |
duration | integer | Länge des generierten Clips in Sekunden (4–15 s). Abrechnung pro Sekunde. Bereich: 4–15s Standard: 5 | Ja |
generate_audio | boolean | Generieren Sie synchronisierten Ton, Atmosphäre und Dialog. Ohne Aufpreis. Standard: true | Kein |
seed | integer | Verwenden Sie denselben Seed und dieselben Einstellungen, um ein Ergebnis zu reproduzieren. Leer lassen für Zufallswerte. | Kein |
webhook_url | Zeichenfolge (URL) | Optional. Wir senden die abgeschlossene Generierung per POST an diese URL und signieren die Anfrage mit Ihrem Webhook-Schlüssel. Webhooks | Kein |
Anfrage
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/bytedance/seedance-2.0-mini/reference-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "@Image1 packt das Produkt aus @Image2 auf einem Marmortisch aus und übernimmt die Kamerabewegung von @Video1",
"reference_image_urls": [
"https://cdn.cheapergen.com/samples/reference-1.jpg",
"https://cdn.cheapergen.com/samples/reference-2.jpg"
],
"reference_video_urls": [
"https://cdn.cheapergen.com/samples/reference-1.mp4"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);Antwort
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "bytedance/seedance-2.0-mini",
"endpoint": "bytedance/seedance-2.0-mini/reference-to-video",
"mode": "reference-to-video",
"status": "queued",
"input": {
"prompt": "@Image1 packt das Produkt aus @Image2 auf einem Marmortisch aus und übernimmt die Kamerabewegung von @Video1",
"reference_image_urls": [
"https://cdn.cheapergen.com/samples/reference-1.jpg",
"https://cdn.cheapergen.com/samples/reference-2.jpg"
],
"reference_video_urls": [
"https://cdn.cheapergen.com/samples/reference-1.mp4"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}Ergebnis abrufen
Generierungen laufen asynchron. Fragen Sie den Status ab, bis status den Status succeeded, failed oder canceled erreicht – oder übergeben Sie webhook_url bereits beim Absenden. Fehlgeschlagene Generierungen werden automatisch erstattet.
curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY"Mehr: Ablauf eines Auftrags · Webhooks · Fehler
Preise für Seedance 2.0 Mini
Zahlen Sie pro Videosekunde nutzungsbasiert, ohne Abo. Fehlgeschlagene Generierungen werden automatisch erstattet.
| Tarifstufe | Offizieller Preis | CheaperGen | Sie sparen |
|---|---|---|---|
480p 16:9 · 24 fps | $0,0292/s Mit einem Monatstarif: Pro $0,0283Max $0,0274 | −17% | |
720p 16:9 · 24 fps | $0,0627/s Mit einem Monatstarif: Pro $0,0607Max $0,0588 | −17% |
Monatstarife niedrigere Preise für die meisten Modelle (unter jedem Preis angezeigt); Sie können weiterhin nach Verbrauch zahlen. Pro $499/Monat · Max $4.999/Monat.
- Offizieller Preis: Listenpreis von BytePlus ModelArk international für dreamina-seedance-2-0-mini ($3.5 / 1 Mio. Video-Tokens; $2.1 mit Videoeingabe). Preise geprüft am 18. Oktober 2026.
- Preise pro Sekunde gelten für 16:9 ohne Videoeingabe.
- Bei Referenzvideos werden Referenz- und Ausgabesekunden zusammen zum niedrigeren Tarif für Videoeingaben abgerechnet.