ByteDance: Seedance 2.0
ByteDance Seedance 2.0 verbindet native Audio-Video-Generierung mit Bild-, Video- und Klangreferenzen. Inszenieren Sie neue Szenen, bearbeiten Sie vorhandenes Material oder erweitern Sie eine Abfolge; die Standardversion umfasst dokumentierte 1080p- und 10-Bit-4K-Ausgabe.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Seedance 2.0 ist das Standardmodell von ByteDance Seed für multimodale Audio-Video-Gestaltung. Es verbindet Text, Bilder, Videos und Audio in einer Architektur zur gemeinsamen Generierung mit separaten kreativen Workflows für referenzgestützte Szenen, Videobearbeitung und Videoerweiterung. Es ist nützlich, wenn das Briefing sowohl eine zusammenhängende Darbietung als auch bestimmte visuelle oder klangliche Informationen aus vorbereitetem Material verlangt.
Multimodale Referenz und Regiesteuerung
Bilder können das Aussehen des Motivs, den visuellen Stil und die Komposition definieren. Videoreferenzen können Handlung, Kamerabewegung und Effekte steuern. Audio kann Stimmtimbre, Musik oder Dialog steuern. Definieren Sie die Rolle jedes Materials und beschreiben Sie anschließend die gewünschte Szene. Der Hersteller betont die Kontrolle über Darbietung, Beleuchtung, Schatten und Kamerasprache.
Bereiten Sie für eine Produktgeschichte ein Produktbild, eine Referenz für die Kamerabewegung und einen Audiohinweis vor. Ein Briefing könnte lauten: „Bewahre die blaue Glasvase aus Image 1. Verwende die langsame seitliche Kamerafahrt aus Video 1. Die Vase steht auf einem sonnigen Regal, mit leiser Instrumentalmusik auf Basis von Audio 1.“ Die vorgesehene Ausgabe ist eine neu inszenierte Szene, die ausgewählte Referenzinformationen verbindet.
Referenzeingaben können Bild und Audio, Bild und Video, Video und Audio oder alle drei kombinieren. Reine Audioeingabe und Text plus Audio ohne Bild oder Video werden nicht unterstützt. Traditionelles Text-zu-Video, Generierung mit erstem Bild und Generierung mit erstem und letztem Bild sind ebenfalls dokumentiert. Verwenden Sie bei wichtigen festen Anfangs- und Abschlusskompositionen den dafür vorgesehenen Endpunktworkflow: Ein Referenzbild in einem Omni-Referenz-Prompt als Endpunkt zu benennen, ist lediglich indirekte Steuerung.
Filmmaterial bearbeiten
Das Modell kann ein Motiv ersetzen, Gegenstände hinzufügen oder entfernen, Elemente verändern und Teile eines Videos neu zeichnen oder reparieren. Beschreiben Sie die konkrete Änderung und benennen Sie das Quellmaterial. Geben Sie bei einer Ergänzung Erscheinungszeitpunkt und Position an; benennen Sie bei Entfernung oder Ersetzung das Objekt genau und die zu bewahrenden Elemente.
Zum Beispiel: „Ersetze die Schreibtischlampe in Video 1 durch die Messinglampe aus Image 1. Bewahre Kamerabewegung, Schreibtischanordnung und Lichtrichtung.“ Das gewünschte Ergebnis ist eine bearbeitete Fassung der Szene mit dem vorgesehenen Austausch. Prüfen Sie die unveränderten Bereiche ebenso wie das neue Objekt, insbesondere bei Verdeckungen, Bewegung und Einstellungswechseln.
Eine Abfolge erweitern und verbinden
Seedance 2.0 kann ein Video vorwärts oder rückwärts erweitern und bis zu drei bereitgestellte Clips durch erzeugte Übergänge verbinden. Geben Sie die zeitliche Richtung und das neue Ereignis an. Ordnen Sie für eine Verbindung die Clips und beschreiben Sie den Übergang zwischen jedem Paar, etwa eine Kamera, die in einer Einstellung durch eine Tür geht und in der nächsten Umgebung ankommt.
Eine einfache Erweiterung liefert gewöhnlich die rund um das Quellmaterial entwickelte Fortsetzung; geben Sie eine klare Anweisung, wenn das Endergebnis auch das ursprüngliche Segment wiederholen soll. Beim Vervollständigen einer Verbindung zwischen zwei oder drei Clips kann der dokumentierte Workflow ursprüngliches Material und neue Übergangsinhalte enthalten. Das ist nützlich, um einen Anfang oder Abschluss zu entwickeln oder vorbereitete Szenen zu verbinden, ohne die verbindende Handlung offenzulassen.
Ausgabe der Standardversion und 4K
Die Standardversion dokumentiert MP4 mit 24 fps und Dauern von 4 bis 15 Sekunden. Die Ausgabestufen sind 480p, 720p und 1080p mit 8-Bit-Farbtiefe sowie 4K mit 10-Bit-Farbtiefe. Unterstützte Seitenverhältnisse sind 21:9, 16:9, 4:3, 1:1, 3:4 und 9:16. Adaptive Bildausschnitte und automatische Dauerauswahl sind ebenfalls dokumentiert. Die Fast-Version hat eine eigene engere Ausgabespezifikation von 480p/720p.
Die 4K-Ausgabe verwendet H.265/HEVC-Kodierung. Zehn-Bit-Kodierung bewahrt zusätzliche Tonwertabstufungen und weichere Farbübergänge, was bei Material mit feinen Licht- oder Farbverläufen wichtig ist. Prüfen Sie, ob die vorgesehene Wiedergabe- und Bearbeitungsumgebung dieses Format dekodieren kann; manche Browser und Geräte spielen es nicht direkt ab. Ein kompatibler Container gewährleistet für sich genommen keine kompatible Videodekodierung.
Das Modell kann synchronisierten Ton oder ein stummes Video erzeugen und das letzte generierte Bild für eine folgende Szene zurückgeben. Erzeugtes Audio ist mono. Die 2.0-Familie unterstützt den separaten zweistufigen Draft-Vorschaumodus nicht; diese Vorschaufunktion sollte deshalb nicht aus einer anderen Seedance-Modellversion abgeleitet werden.
Referenzvorbereitung und inhaltliche Grenzen
Die dokumentierte Referenzkapazität beträgt bis zu neun Bilder, drei Videos und drei Audioclips. Direkte Referenzbild- oder Videouploads mit echten menschlichen Gesichtern werden in diesem dokumentierten Herstellerprofil nicht akzeptiert; Porträtarbeit verwendet dessen unterstützten Workflow für Porträtmaterial. Jeder Video- und Audioclip muss 2–15 Sekunden lang sein. Alle Videoreferenzen zusammen müssen innerhalb von 15 Sekunden liegen; alle Audioreferenzen zusammen haben eine eigene Gesamtdauer von 15 Sekunden. Videodateien verwenden MP4 oder MOV mit 24–60 fps und bis zu 200 MB pro Datei; Audiodateien verwenden WAV oder MP3 mit bis zu 15 MB pro Datei. Die aufgeführten Bildformate sind JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC und HEIF. Bilder müssen jeweils kleiner als 30 MB sein, und der Request-Body darf 64 MB nicht überschreiten. Im dokumentierten Referenzeingabeprofil müssen Bildbreite und -höhe jeweils strikt zwischen 300 und 6.000 Pixeln liegen, mit einem Breiten-Höhen-Verhältnis strikt zwischen 0,4 und 2,5. Referenzvideos erlauben 300–6.000 Pixel in jeder Dimension und Seitenverhältnisse von 0,4–2,5 einschließlich der Grenzen, mit insgesamt 407.696–8.295.044 Pixeln. MP4- oder MOV-Videos verwenden H.264/AVC- oder H.265/HEVC-Video und AAC- oder MP3-Audio.
Ordnen Sie die Dateien bewusst und verweisen Sie auf jede mit Medientyp und Nummer: Image 1, Video 1 und Audio 1. Die Nummer folgt der Reihenfolge innerhalb dieses Dateityps. Erklären Sie, welche Eigenschaften übernommen werden sollen und welche Quellinhalte die neue Szene nicht bestimmen sollen. Zu den dokumentierten Promptsprachen gehören Englisch, Spanisch, Indonesisch, Portugiesisch und Japanisch. Halten Sie die gesprochene Sprache innerhalb eines Dialogs konsistent; der Leitfaden rät mit Ausnahme von Eigennamen vom Mischen von Sprachen ab. Trennen Sie bei stimmgeführter Arbeit Sprecher, genaue Zeile und Sprechregie.
Bereiten Sie Anfangs- und Endbilder mit kompatiblen Bildausschnitten vor. Eine Abweichung zwischen Eingabebild und Ausgabeabmessungen kann einen Beschnitt oder abrupten visuellen Wechsel verursachen; übereinstimmende Abmessungen und adaptive Bildausschnitte sind dokumentierte Gegenmaßnahmen. Konzentrieren Sie die Beschreibung auf das Ereignis und die Referenzrollen. Der Hersteller warnt, dass lange Prompts Informationen zerstreuen können, wodurch Details ignoriert werden. Prüfen Sie entstehende Bewegung, Referenzkontinuität, Audiodarbietung und Szenenübergänge als getrennte Teile des kreativen Ergebnisses.
Einstellungsplanung und Textregie
Gliedern Sie für eine komplexe Szene das Briefing als Shot 1, Shot 2 und Shot 3 und geben Sie Kamera, Motivhandlung, Position und Ton in Reihenfolge an. Der Leitfaden empfiehlt eine Kamerabewegung pro Einstellung und Vorrang für langsame, zusammenhängende Handlungen. Genaue Zeitstempel je Einstellung sind instabil; eine Ereignisfolge ist deshalb eine bessere Steuerung, als mehrere exakte Zeitfenster zu erzwingen.
Das Modell erzeugt außerdem gängige Texte wie Slogans, Untertitel und Sprechblasen. Sie können Farbe, visuelle Gestaltung, Platzierung und Einblendung des Textes steuern. Verwenden Sie gängige Zeichen statt seltener Zeichen oder Sonderzeichen und prüfen Sie den Wortlaut in Bewegung. Ordnen Sie bei Motivreferenzen jede Datei eindeutig der vorgesehenen Figur oder dem Objekt zu. Produktansichten können unterschiedliche visuelle Informationen liefern; Collagen mit mehreren Figurenansichten können die Gesichtsidentität verwirren. Eine separate klare Kopfaufnahme und ein Ganzkörperbild sind die dokumentierte Empfehlung für Figurenreferenzen.
Vor dem Schnitt zu prüfendes Verhalten
Der Leitfaden dokumentiert unerwünschte Untertitel, Logos, doppelte Figuren und Stilabweichungen. Sauberes Quellmaterial, konsistente Bezeichnungen und ausdrückliche Vorgaben reduzieren diese Risiken, garantieren aber nicht das Verschwinden unerwünschten Textes oder doppelter Figuren. Mehr als vier Referenzpersonen werden als Stabilitätsrisiko genannt, getrennt von der Zahl der Dateien, die das Modell akzeptiert.
Videoerweiterung kann am Übergang einen Sprung oder Rücksprung erzeugen; wiederholte Fortsetzungen können Bildqualitätsverluste verstärken. Prüfen Sie die Grenzbilder und begrenzen Sie gestapelte Erweiterungen. Eine Referenzstimme kann vom Quelltimbre abweichen; eine Sprecheraufnahme kann mit einem Klick oder abrupten Abbruch enden, wofür eine Audioblende als Gegenmaßnahme dokumentiert ist. Chinesische Zeichen mit mehreren Lesungen, ungewöhnliche oder ähnlich aussehende Zeichen können falsch ausgesprochen werden. Für einen präzisen Animationseffekt wie einen Countdown ist eine Bewegungsreferenz informativer als eine rein verbale Aufforderung. Dies sind konkrete Gründe, bei der Clipauswahl Identität, Text, Bewegung und Ton getrennt zu prüfen.
Ailoot Ultra · Video POST /v1/videos bytedance/seedance-2.0
bytedance/seedance-2.0Start
ByteDance Seedance 2.0 verbindet native Audio-Video-Generierung mit Bild-, Video- und Klangreferenzen. Inszenieren Sie neue Szenen, bearbeiten Sie vorhandenes Material oder erweitern Sie eine Abfolge; die Standardversion umfasst dokumentierte 1080p- und 10-Bit-4K-Ausgabe.
- Zulässige Eingaben
- Text · Bilder · Audio
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Video POST /v1/videos
- Eingabetypen
text,image,audio- Ausgabetypen
video- Ausgabeformat
- Originale MP4-Bytes; keine Normalisierung/Transkodierung
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits bytedance/seedance-2.0 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldduration | Typinteger | AnforderungErforderlich | Werte und Limits 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 480p, 720p, 1080p, 4K | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Standard— |
Feldgenerate_audio | Typboolean | AnforderungOptional | Werte und Limits false, true Bedingungen: Bei 480p und 720p wählt das Weglassen von generate_audio den Preis mit Audio; false wählt den Preis ohne Audio. Bei 1080p und 4K gilt für beide Einstellungen der Auflösungspreis. Prüfen Sie has_audio im Ergebnis auf die zurückgegebene Audiospur. | Standard— |
Feldframe_images | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 2 Eingabeinhalt: Array von Frame-Objekten. Jedes enthält type=image_url, image_url mit url und frame_type=first_frame oder last_frame. Jede Rolle darf höchstens einmal vorkommen. Verwenden Sie öffentliche HTTPS-URLs. Exakte Schlüssel: type, image_url, frame_type Bedingungen: Diese Schlüssel gelten für jedes Frame-Objekt. Lassen Sie frame_images bei einer reinen Textanfrage weg. | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Eingabeinhalt: Array von Bild- oder Audioreferenzobjekten. Setzen Sie type auf image_url oder audio_url und geben Sie das passende URL-Objekt mit url an. Für Videoreferenzen lässt sich weiterhin kein Preis bestimmen. Bedingungen: Lassen Sie frame_images weg, um den Referenzmodus zu verwenden. Verwenden Sie öffentliche HTTPS-URLs. | Standard— |
Feldsize | Typstring | AnforderungOptional | Werte und Limits 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 Muster: ^[1-9][0-9]*x[1-9][0-9]*$ | Standard— |
Feldseed | Typinteger | AnforderungOptional | Werte und Limits Minimum: -9.223.372.036.854.775.808 Maximum: 9.223.372.036.854.775.807 | Standard— |
Feldcallback_url | Typstring | AnforderungOptional | Werte und Limits Muster: ^https:// | Standard— |
Feldsession_id | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldtrace | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Felduser | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Kombinationen von Eingabematerialien
Text zu Video · Ein schriftlicher Prompt. · Erforderlich: model, prompt, duration
Geben Sie einen Textprompt und eine unterstützte Dauer in ganzen Sekunden an. Verwenden Sie eine exakt aufgeführte Größe oder eine Auflösung und ein Seitenverhältnis, die zu aufgeführten Abmessungen führen.
model: Typ: string · bytedance/seedance-2.0
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja
Bild zu Video · Ein schriftlicher Prompt und ein Frame-Bild. · Erforderlich: model, prompt, duration, frame_images
frame_images ist ein Array von Objekten mit type=image_url, image_url mit url und frame_type. Verwenden Sie eine öffentliche HTTPS-Bild-URL; first_frame und last_frame dürfen jeweils einmal vorkommen. Verwenden Sie eine aufgeführte Ausgabegröße oder kompatible Abmessungen. Fügen Sie keine Videoreferenzen hinzu.
Exakte Schlüssel: type, image_url, frame_type
model: Typ: string · bytedance/seedance-2.0
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja
Reference to video · Ein schriftlicher Prompt und Bild- oder Audioreferenzen. · Erforderlich: model, prompt, duration, input_references
input_references ist ein Array. Jedes Objekt enthält type=image_url oder type=audio_url und ein passendes URL-Objekt mit url. Verwenden Sie öffentliche HTTPS-Links. Lassen Sie frame_images weg, um den Referenzmodus auszuwählen. Für Videoreferenzen lässt sich kein Preis bestimmen.
model: Typ: string · bytedance/seedance-2.0
prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt, duration |
Parametermaterial_types | Vertragtext, image, audio |
Parameteradditional_properties | Vertragfalse |
Parameteroptional_controls | Vertragresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Lebenszyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungseinheit | Abrechnungsbedingungen | Gebühr |
|---|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationVideotokenpreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro 1K Video-Token | AbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben. | Gebühr Ausgabe · Videotokenpreis · Schätzung nur zum Vergleich $0.014 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro 1K Video-Token | Abrechnungsbedingungenresolution: 1080p | Gebühr Ausgabe · Videotokenpreis · Schätzung nur zum Vergleich $0.0154 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro 1K Video-Token | AbrechnungsbedingungenEingabe: with_video_input; Auflösung: 1080p | Gebühr reference · Videotokenpreis · Schätzung nur zum Vergleich $0.0094 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro 1K Video-Token | Abrechnungsbedingungenresolution: 4k | Gebühr Ausgabe · Videotokenpreis · Schätzung nur zum Vergleich $0.008 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro 1K Video-Token | AbrechnungsbedingungenEingabe: with_video_input; Auflösung: 4k | Gebühr reference · Videotokenpreis · Schätzung nur zum Vergleich $0.0048 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro 1K Video-Token | AbrechnungsbedingungenEingabe: with_video_input | Gebühr reference · Videotokenpreis · Schätzung nur zum Vergleich $0.0086 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro 1K Video-Token | AbrechnungsbedingungenAudio: without_audio | Gebühr Ausgabe · Videotokenpreis · Schätzung nur zum Vergleich $0.014 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.3024 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Details zum Referenztarif
Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.
Preisreferenzen für Videokonfigurationen
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationVideotokenpreis | AbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben. | Gebühr Ausgabe · Videotokenpreis $0.014 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | Abrechnungsbedingungenresolution: 4k | Gebühr Ausgabe · Videotokenpreis $0.008 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | Abrechnungsbedingungenresolution: 1080p | Gebühr Ausgabe · Videotokenpreis $0.0154 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | AbrechnungsbedingungenAudio: without_audio | Gebühr Ausgabe · Videotokenpreis $0.014 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | AbrechnungsbedingungenEingabe: with_video_input | Gebühr reference · Videotokenpreis $0.0086 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | AbrechnungsbedingungenEingabe: with_video_input; Auflösung: 4k | Gebühr reference · Videotokenpreis $0.0048 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
| KonfigurationVideotokenpreis | AbrechnungsbedingungenEingabe: with_video_input; Auflösung: 1080p | Gebühr reference · Videotokenpreis $0.0094 pro 1K Video-Token Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr. |
Beispielanfragen
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Video
Signierte Inhalts-URLs der Ihnen zugeordneten Assets
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Auftragsstatus prüfen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.
Wenn die ursprüngliche Antwort geprüft werden muss
503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen
Antwortfelder
| Feld | Typ | Bedeutung |
|---|---|---|
Feldindex | Typinteger | BedeutungBei null beginnende Position dieses Videos in der Ausgabeliste. |
Feldcontent_url | Typstring | BedeutungSignierte HTTPS-Download-URL für dieses fertiggestellte Video. |
Feldsha256 | Typstring | null | BedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar. |
Feldsize_bytes | Typinteger | null | BedeutungGröße der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar. |
Feldduration_ms | Typinteger | null | BedeutungGemessene Videodauer in Millisekunden; null, falls nicht verfügbar. |
Feldwidth | Typinteger | null | BedeutungVideobreite in Pixeln; null, falls nicht verfügbar. |
Feldheight | Typinteger | null | BedeutungVideohöhe in Pixeln; null, falls nicht verfügbar. |
Feldvideo_codec | Typstring | null | BedeutungVideocodec-Kennung; null, falls nicht aufgezeichnet. |
Feldhas_audio | Typboolean | null | BedeutungGibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen. |
Feldaudio_codec | Typstring | null | BedeutungAudiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde. |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort404 · not_found_error | BedingungDer Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden. | Nächster SchrittPrüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel. |
Antwort401 · authentication_error | BedingungDer API-Schlüssel passt nicht zum authentifizierten Konto. | Nächster SchrittPrüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff. |
Antwort400 · invalid_request_error | BedingungDie Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig. | Nächster SchrittKorrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat. |
Antwort422 · price_unavailable | BedingungFür die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen. | Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden. |
Antwort422 · invalid_request_error | BedingungEine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig. | Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel. |
Antwort402 · billing_error | BedingungDas verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu. | Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden. |
Antwort503 · server_error | BedingungVideoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar. | Nächster SchrittWarten Sie, bis der Dienst verfügbar ist. Wenn Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung zu erstellen. |
Antwort503 · result_pending_check | BedingungDas ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden. | Nächster SchrittBewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage. |
Antwort503 · owned_result_unavailable | BedingungDer Download des vorhandenen Videos ist vorübergehend nicht verfügbar. | Nächster SchrittPrüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang. |
Antwort409 · video_not_ready | BedingungDer Videoinhalt wurde nicht veröffentlicht. | Nächster SchrittPrüfen Sie den Status der ursprünglichen Aufgabe. Laden Sie das Ergebnis herunter, sobald completed gemeldet wird; bei failed folgen Sie dem Hinweis zur Abrechnungsprüfung. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra bytedance/seedance-2.0
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · ByteDance: Seedance 2.0
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·bytedance/seedance-2.0:text,image,audio→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·bytedance/seedance-2.0:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Welche Grenzen gelten?
POST /v1/videos·bytedance/seedance-2.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807