{ "aboutHtml": "

Seedance 2.0 Fast ist die geschwindigkeitsorientierte Modellversion der Seedance-2.0-Familie von ByteDance Seed. Es unterstützt gemeinsame Video- und Audiogenerierung sowie ein multimodales Briefing aus Text, Bildern, Video und Klang. Zu seinen kreativen Fähigkeiten gehören neue referenzgestützte Szenen, Bearbeitungen vorhandenen Materials und Erweiterungen einer Szene; seine dokumentierten Ausgabestufen sind 480p und 720p.

Multimodale Referenz: dem Material Rollen zuweisen

Ein Bild kann eine Figur, ein Produkt, eine Komposition oder visuelle Gestaltung liefern. Ein Referenzvideo kann Handlung, Kamerabewegung oder einen Effekt liefern. Referenzaudio kann Stimmtimbre, musikalische Melodie oder Dialoginhalt liefern. Erklären Sie, welchen Teil jeder Quelle Sie in die neue Szene übernehmen möchten; eine Referenz ist nützlicher, wenn sie eine bestimmte kreative Rolle hat.

Zum Beispiel: „Verwende die Keramiklampe in Image 1 als Produkt. Folge der langsamen Kameraumrundung aus Video 1, platziere die Lampe aber in einer ruhigen Leseecke. Verwende Audio 1 für die musikalische Stimmung.“ Die vorgesehene Ausgabe ist eine neue Szene, die gewähltes Aussehen, Bewegung und Klanggestaltung verbindet, statt jedes Referenzdetail unspezifisch nachzuahmen.

Zu den dokumentierten Kombinationen gehören Bilder mit Audio, Bilder mit Video, Video mit Audio sowie alle drei gemeinsam. Text mit Audio allein und reine Audioeingabe werden nicht unterstützt. Das Modell unterstützt außerdem Text-zu-Video und bildgestützte Generierung mit einem Anfangsbild oder einem Paar aus erstem und letztem Bild. Wenn ein genauer Endpunkt im Mittelpunkt des Briefings steht, verwenden Sie den dafür vorgesehenen Endpunktworkflow; ein Referenzbild in einem Omni-Referenz-Prompt als Endpunkt zu beschreiben, ist indirekte Steuerung.

Ein vorhandenes Video bearbeiten

Das Modell kann Elemente hinzufügen, entfernen oder verändern, ein Motiv ersetzen und Teile einer Szene neu zeichnen oder reparieren. Benennen Sie das Quellvideo, das zu ändernde Objekt und die Elemente, die erhalten bleiben sollen. Beschreiben Sie bei einer Ergänzung, wo und wann sie erscheint. Identifizieren Sie bei einer Entfernung das Objekt im gesamten Clip konsistent.

Ein praktisches Bearbeitungsbriefing könnte eine schlichte Flasche in einer Demonstration durch die Flasche aus Image 1 ersetzen und dabei Handbewegung, Hintergrund und Kamerapfad von Video 1 bewahren lassen. Prüfen Sie sowohl die Ersetzung als auch die Bereiche, die stabil bleiben sollen. Klare Erhaltungsanweisungen machen die vorgesehene Bearbeitung leichter bewertbar als eine allgemeine Aufforderung, das Material zu „verbessern“.

Clips erweitern und verbinden

Seedance 2.0 Fast unterstützt Vorwärts- oder Rückwärtserweiterung und die Verbindung von zwei oder drei Clips durch erzeugte Übergänge. Geben Sie für eine Erweiterung an, ob die neue Handlung vor oder nach dem bereitgestellten Video stattfindet, und beschreiben Sie diese Handlung. Stellen Sie für eine Verbindung die Clips in der vorgesehenen Reihenfolge bereit und erklären Sie das visuelle Ereignis, das sie verbindet.

Eine einfache Erweiterung liefert gewöhnlich die neu entwickelte Fortsetzung rund um das ursprüngliche Material, statt von einer Wiederholung des gesamten Quellclips auszugehen. Wenn die Ausgabe das ursprüngliche Segment enthalten soll, sagen Sie dies im Briefing. Beim Füllen eines Übergangs zwischen zwei oder drei Videos kann der dokumentierte Workflow ursprüngliche und neu erzeugte Inhalte kombinieren. Das ist nützlich, um eine weite Produktansicht durch eine gezielte Kamerabewegung mit einer Detailaufnahme zu verbinden.

Ausgabe und Unterschiede zwischen Modellversionen

Die dokumentierte Fast-Ausgabe ist MP4 mit 24 fps, 480p oder 720p, 8-Bit-Farbtiefe und Clips von 4–15 Sekunden. Unterstützte Seitenverhältnisse sind 21:9, 16:9, 4:3, 1:1, 3:4 und 9:16. Die Standardversion von Seedance 2.0 nennt separat 1080p- und 4K-Ausgabe; diese Stufen gehören nicht zur Fast-Spezifikation. Die 2.0-Familie unterstützt die Rückgabe des letzten erzeugten Bildes, aber nicht den separaten Draft-Vorschaumodus.

Audio kann mit dem Material erzeugt oder für einen stummen Clip weggelassen werden. Erzeugtes Audio ist mono. 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. Benennen Sie für eine gesprochene Szene den Sprecher und setzen Sie seine Zeile in Anführungszeichen; geben Sie anschließend Sprechweise und zugehörige Klangeffekte an. Stimmen Sie die gewünschte Darbietung auf die gewählte Cliplänge ab.

Referenzen vorbereiten und Eingabegrenzen beachten

Die dokumentierten Referenzgrenzen sind 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- oder Audioclip muss 2–15 Sekunden lang sein; die gesamte Videodauer beträgt höchstens 15 Sekunden, und die gesamte Audiodauer beträgt separat höchstens 15 Sekunden. Videoreferenzen verwenden MP4 oder MOV mit 24–60 fps und dürfen jeweils 200 MB nicht überschreiten. Audioreferenzen verwenden WAV oder MP3 und dürfen jeweils 15 MB nicht überschreiten. Die aufgeführten Bildformate sind JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC und HEIF. Bilder müssen jeweils kleiner als 30 MB sein; die gesamte Anfragegröße ist auf 64 MB begrenzt. 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 und verweisen Sie konsistent auf sie als Image 1, Video 1 oder Audio 1. Verwenden Sie neben der Dateinummer den Namen oder ein unterscheidbares Merkmal des sichtbaren Motivs. Stimmen Sie den Bildausschnitt der Endpunktbilder auf das vorgesehene Videoseitenverhältnis ab, da eine Abweichung das Bild beschneiden oder einen störenden Wechsel des Bildausschnitts verursachen kann. Konzentrieren Sie das Briefing auf zu übertragende Merkmale, das zu erzeugende Ereignis und die unverändert zu bewahrenden Elemente; ein langer Prompt kann Anweisungen zerstreuen und Nebendetails ungeklärt lassen.

Einstellungsplanung, Text und bekanntes Verhalten

Gliedern Sie ein komplexes Briefing als Shot 1, Shot 2 und Shot 3 mit klarem Motiv, Handlung, Position und Ton je Einstellung. Der Leitfaden empfiehlt eine Kamerabewegung pro Einstellung und nennt genaue Zeitstempel je Einstellung als instabil. Geben Sie jeder Figur eine stabile Bezeichnung und einige unterscheidbare Merkmale; verwenden Sie bei wichtiger Gesichtsidentität eine separate klare Kopfaufnahme und Ganzkörperreferenz statt eines kombinierten Blatts mit mehreren Figurenansichten.

Das Modell kann gängige Texte wie Slogans, Untertitel und Sprechblasen erzeugen, mit Anweisungen zu Farbe, Stil, Position und Einblendung. Gängige Zeichen werden gegenüber seltenen Zeichen oder Sonderzeichen bevorzugt. Prüfen Sie die Buchstaben in Bewegung. Unerwünschte Untertitel, Logos und doppelte Figuren sind dokumentiertes Verhalten; ausdrückliche Vorgaben und saubere Referenzen können sie reduzieren, garantieren aber nicht ihre Abwesenheit. Mehr als vier Referenzpersonen werden als Stabilitätsrisiko genannt, nicht als harte Grenze für die Dateizahl.

Wiederholte Erweiterungen können Bildqualitätsverluste verstärken; ein Erweiterungsübergang kann springen oder zurückspringen. Begrenzen Sie gestapelte Fortsetzungen und prüfen Sie den Übergang im Schnitt. Das Timbre einer Referenzstimme kann abweichen, eine Sprecheraufnahme kann mit einem Klick enden, und chinesische Zeichen mit mehreren Lesungen oder ungewöhnliche Zeichen können falsch ausgesprochen werden. Prüfen Sie die gesprochene Zeile und das abschließende Audio; eine kurze Audioblende kann bei einem abrupten Abbruch helfen. Diese Prüfungen gehören zur Vorbereitung des kreativen Ergebnisses, insbesondere wenn Sprache oder Figurenkontinuität die Geschichte trägt.

", "aboutText": "Seedance 2.0 Fast ist die geschwindigkeitsorientierte Modellversion der Seedance-2.0-Familie von ByteDance Seed. Es unterstützt gemeinsame Video- und Audiogenerierung sowie ein multimodales Briefing aus Text, Bildern, Video und Klang. Zu seinen kreativen Fähigkeiten gehören neue referenzgestützte Szenen, Bearbeitungen vorhandenen Materials und Erweiterungen einer Szene; seine dokumentierten Ausgabestufen sind 480p und 720p.\n\n### Multimodale Referenz: dem Material Rollen zuweisen\n\nEin Bild kann eine Figur, ein Produkt, eine Komposition oder visuelle Gestaltung liefern. Ein Referenzvideo kann Handlung, Kamerabewegung oder einen Effekt liefern. Referenzaudio kann Stimmtimbre, musikalische Melodie oder Dialoginhalt liefern. Erklären Sie, welchen Teil jeder Quelle Sie in die neue Szene übernehmen möchten; eine Referenz ist nützlicher, wenn sie eine bestimmte kreative Rolle hat.\n\nZum Beispiel: „Verwende die Keramiklampe in Image 1 als Produkt. Folge der langsamen Kameraumrundung aus Video 1, platziere die Lampe aber in einer ruhigen Leseecke. Verwende Audio 1 für die musikalische Stimmung.“ Die vorgesehene Ausgabe ist eine neue Szene, die gewähltes Aussehen, Bewegung und Klanggestaltung verbindet, statt jedes Referenzdetail unspezifisch nachzuahmen.\n\nZu den dokumentierten Kombinationen gehören Bilder mit Audio, Bilder mit Video, Video mit Audio sowie alle drei gemeinsam. Text mit Audio allein und reine Audioeingabe werden nicht unterstützt. Das Modell unterstützt außerdem Text-zu-Video und bildgestützte Generierung mit einem Anfangsbild oder einem Paar aus erstem und letztem Bild. Wenn ein genauer Endpunkt im Mittelpunkt des Briefings steht, verwenden Sie den dafür vorgesehenen Endpunktworkflow; ein Referenzbild in einem Omni-Referenz-Prompt als Endpunkt zu beschreiben, ist indirekte Steuerung.\n\n### Ein vorhandenes Video bearbeiten\n\nDas Modell kann Elemente hinzufügen, entfernen oder verändern, ein Motiv ersetzen und Teile einer Szene neu zeichnen oder reparieren. Benennen Sie das Quellvideo, das zu ändernde Objekt und die Elemente, die erhalten bleiben sollen. Beschreiben Sie bei einer Ergänzung, wo und wann sie erscheint. Identifizieren Sie bei einer Entfernung das Objekt im gesamten Clip konsistent.\n\nEin praktisches Bearbeitungsbriefing könnte eine schlichte Flasche in einer Demonstration durch die Flasche aus Image 1 ersetzen und dabei Handbewegung, Hintergrund und Kamerapfad von Video 1 bewahren lassen. Prüfen Sie sowohl die Ersetzung als auch die Bereiche, die stabil bleiben sollen. Klare Erhaltungsanweisungen machen die vorgesehene Bearbeitung leichter bewertbar als eine allgemeine Aufforderung, das Material zu „verbessern“.\n\n### Clips erweitern und verbinden\n\nSeedance 2.0 Fast unterstützt Vorwärts- oder Rückwärtserweiterung und die Verbindung von zwei oder drei Clips durch erzeugte Übergänge. Geben Sie für eine Erweiterung an, ob die neue Handlung vor oder nach dem bereitgestellten Video stattfindet, und beschreiben Sie diese Handlung. Stellen Sie für eine Verbindung die Clips in der vorgesehenen Reihenfolge bereit und erklären Sie das visuelle Ereignis, das sie verbindet.\n\nEine einfache Erweiterung liefert gewöhnlich die neu entwickelte Fortsetzung rund um das ursprüngliche Material, statt von einer Wiederholung des gesamten Quellclips auszugehen. Wenn die Ausgabe das ursprüngliche Segment enthalten soll, sagen Sie dies im Briefing. Beim Füllen eines Übergangs zwischen zwei oder drei Videos kann der dokumentierte Workflow ursprüngliche und neu erzeugte Inhalte kombinieren. Das ist nützlich, um eine weite Produktansicht durch eine gezielte Kamerabewegung mit einer Detailaufnahme zu verbinden.\n\n### Ausgabe und Unterschiede zwischen Modellversionen\n\nDie dokumentierte Fast-Ausgabe ist MP4 mit 24 fps, 480p oder 720p, 8-Bit-Farbtiefe und Clips von 4–15 Sekunden. Unterstützte Seitenverhältnisse sind 21:9, 16:9, 4:3, 1:1, 3:4 und 9:16. Die Standardversion von Seedance 2.0 nennt separat 1080p- und 4K-Ausgabe; diese Stufen gehören nicht zur Fast-Spezifikation. Die 2.0-Familie unterstützt die Rückgabe des letzten erzeugten Bildes, aber nicht den separaten Draft-Vorschaumodus.\n\nAudio kann mit dem Material erzeugt oder für einen stummen Clip weggelassen werden. Erzeugtes Audio ist mono. 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. Benennen Sie für eine gesprochene Szene den Sprecher und setzen Sie seine Zeile in Anführungszeichen; geben Sie anschließend Sprechweise und zugehörige Klangeffekte an. Stimmen Sie die gewünschte Darbietung auf die gewählte Cliplänge ab.\n\n### Referenzen vorbereiten und Eingabegrenzen beachten\n\nDie dokumentierten Referenzgrenzen sind 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- oder Audioclip muss 2–15 Sekunden lang sein; die gesamte Videodauer beträgt höchstens 15 Sekunden, und die gesamte Audiodauer beträgt separat höchstens 15 Sekunden. Videoreferenzen verwenden MP4 oder MOV mit 24–60 fps und dürfen jeweils 200 MB nicht überschreiten. Audioreferenzen verwenden WAV oder MP3 und dürfen jeweils 15 MB nicht überschreiten. Die aufgeführten Bildformate sind JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC und HEIF. Bilder müssen jeweils kleiner als 30 MB sein; die gesamte Anfragegröße ist auf 64 MB begrenzt. 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.\n\nOrdnen Sie die Dateien und verweisen Sie konsistent auf sie als Image 1, Video 1 oder Audio 1. Verwenden Sie neben der Dateinummer den Namen oder ein unterscheidbares Merkmal des sichtbaren Motivs. Stimmen Sie den Bildausschnitt der Endpunktbilder auf das vorgesehene Videoseitenverhältnis ab, da eine Abweichung das Bild beschneiden oder einen störenden Wechsel des Bildausschnitts verursachen kann. Konzentrieren Sie das Briefing auf zu übertragende Merkmale, das zu erzeugende Ereignis und die unverändert zu bewahrenden Elemente; ein langer Prompt kann Anweisungen zerstreuen und Nebendetails ungeklärt lassen.\n\n### Einstellungsplanung, Text und bekanntes Verhalten\n\nGliedern Sie ein komplexes Briefing als Shot 1, Shot 2 und Shot 3 mit klarem Motiv, Handlung, Position und Ton je Einstellung. Der Leitfaden empfiehlt eine Kamerabewegung pro Einstellung und nennt genaue Zeitstempel je Einstellung als instabil. Geben Sie jeder Figur eine stabile Bezeichnung und einige unterscheidbare Merkmale; verwenden Sie bei wichtiger Gesichtsidentität eine separate klare Kopfaufnahme und Ganzkörperreferenz statt eines kombinierten Blatts mit mehreren Figurenansichten.\n\nDas Modell kann gängige Texte wie Slogans, Untertitel und Sprechblasen erzeugen, mit Anweisungen zu Farbe, Stil, Position und Einblendung. Gängige Zeichen werden gegenüber seltenen Zeichen oder Sonderzeichen bevorzugt. Prüfen Sie die Buchstaben in Bewegung. Unerwünschte Untertitel, Logos und doppelte Figuren sind dokumentiertes Verhalten; ausdrückliche Vorgaben und saubere Referenzen können sie reduzieren, garantieren aber nicht ihre Abwesenheit. Mehr als vier Referenzpersonen werden als Stabilitätsrisiko genannt, nicht als harte Grenze für die Dateizahl.\n\nWiederholte Erweiterungen können Bildqualitätsverluste verstärken; ein Erweiterungsübergang kann springen oder zurückspringen. Begrenzen Sie gestapelte Fortsetzungen und prüfen Sie den Übergang im Schnitt. Das Timbre einer Referenzstimme kann abweichen, eine Sprecheraufnahme kann mit einem Klick enden, und chinesische Zeichen mit mehreren Lesungen oder ungewöhnliche Zeichen können falsch ausgesprochen werden. Prüfen Sie die gesprochene Zeile und das abschließende Audio; eine kurze Audioblende kann bei einem abrupten Abbruch helfen. Diese Prüfungen gehören zur Vorbereitung des kreativen Ergebnisses, insbesondere wenn Sprache oder Figurenkontinuität die Geschichte trägt.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "eadbde87c6619bf761045eafafe17ceff812d5d609306acdfafd18bb5cc0d574", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de", "methods": [ { "html": "
•

ByteDance: Seedance 2.0 Fast

ByteDance /bytedance/seedance-2.0-fast

Start

ByteDance Seedance 2.0 Fast erzeugt Audio-Video-Szenen aus Text-, Bild-, Video- und Klangreferenzen. Seine geschwindigkeitsorientierte Modellversion unterstützt Bewegungs- und Stilübertragung, Videobearbeitung sowie Vorwärts- oder Rückwärtserweiterung mit dokumentierter 480p- und 720p-Ausgabe.

Zulässige Eingaben
Text · Bilder · Audio
Ergebnisse
Video
Ü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 Fast ist die geschwindigkeitsorientierte Modellversion der Seedance-2.0-Familie von ByteDance Seed. Es unterstützt gemeinsame Video- und Audiogenerierung sowie ein multimodales Briefing aus Text, Bildern, Video und Klang. Zu seinen kreativen Fähigkeiten gehören neue referenzgestützte Szenen, Bearbeitungen vorhandenen Materials und Erweiterungen einer Szene; seine dokumentierten Ausgabestufen sind 480p und 720p.

Multimodale Referenz: dem Material Rollen zuweisen

Ein Bild kann eine Figur, ein Produkt, eine Komposition oder visuelle Gestaltung liefern. Ein Referenzvideo kann Handlung, Kamerabewegung oder einen Effekt liefern. Referenzaudio kann Stimmtimbre, musikalische Melodie oder Dialoginhalt liefern. Erklären Sie, welchen Teil jeder Quelle Sie in die neue Szene übernehmen möchten; eine Referenz ist nützlicher, wenn sie eine bestimmte kreative Rolle hat.

Zum Beispiel: „Verwende die Keramiklampe in Image 1 als Produkt. Folge der langsamen Kameraumrundung aus Video 1, platziere die Lampe aber in einer ruhigen Leseecke. Verwende Audio 1 für die musikalische Stimmung.“ Die vorgesehene Ausgabe ist eine neue Szene, die gewähltes Aussehen, Bewegung und Klanggestaltung verbindet, statt jedes Referenzdetail unspezifisch nachzuahmen.

Zu den dokumentierten Kombinationen gehören Bilder mit Audio, Bilder mit Video, Video mit Audio sowie alle drei gemeinsam. Text mit Audio allein und reine Audioeingabe werden nicht unterstützt. Das Modell unterstützt außerdem Text-zu-Video und bildgestützte Generierung mit einem Anfangsbild oder einem Paar aus erstem und letztem Bild. Wenn ein genauer Endpunkt im Mittelpunkt des Briefings steht, verwenden Sie den dafür vorgesehenen Endpunktworkflow; ein Referenzbild in einem Omni-Referenz-Prompt als Endpunkt zu beschreiben, ist indirekte Steuerung.

Ein vorhandenes Video bearbeiten

Das Modell kann Elemente hinzufügen, entfernen oder verändern, ein Motiv ersetzen und Teile einer Szene neu zeichnen oder reparieren. Benennen Sie das Quellvideo, das zu ändernde Objekt und die Elemente, die erhalten bleiben sollen. Beschreiben Sie bei einer Ergänzung, wo und wann sie erscheint. Identifizieren Sie bei einer Entfernung das Objekt im gesamten Clip konsistent.

Ein praktisches Bearbeitungsbriefing könnte eine schlichte Flasche in einer Demonstration durch die Flasche aus Image 1 ersetzen und dabei Handbewegung, Hintergrund und Kamerapfad von Video 1 bewahren lassen. Prüfen Sie sowohl die Ersetzung als auch die Bereiche, die stabil bleiben sollen. Klare Erhaltungsanweisungen machen die vorgesehene Bearbeitung leichter bewertbar als eine allgemeine Aufforderung, das Material zu „verbessern“.

Clips erweitern und verbinden

Seedance 2.0 Fast unterstützt Vorwärts- oder Rückwärtserweiterung und die Verbindung von zwei oder drei Clips durch erzeugte Übergänge. Geben Sie für eine Erweiterung an, ob die neue Handlung vor oder nach dem bereitgestellten Video stattfindet, und beschreiben Sie diese Handlung. Stellen Sie für eine Verbindung die Clips in der vorgesehenen Reihenfolge bereit und erklären Sie das visuelle Ereignis, das sie verbindet.

Eine einfache Erweiterung liefert gewöhnlich die neu entwickelte Fortsetzung rund um das ursprüngliche Material, statt von einer Wiederholung des gesamten Quellclips auszugehen. Wenn die Ausgabe das ursprüngliche Segment enthalten soll, sagen Sie dies im Briefing. Beim Füllen eines Übergangs zwischen zwei oder drei Videos kann der dokumentierte Workflow ursprüngliche und neu erzeugte Inhalte kombinieren. Das ist nützlich, um eine weite Produktansicht durch eine gezielte Kamerabewegung mit einer Detailaufnahme zu verbinden.

Ausgabe und Unterschiede zwischen Modellversionen

Die dokumentierte Fast-Ausgabe ist MP4 mit 24 fps, 480p oder 720p, 8-Bit-Farbtiefe und Clips von 4–15 Sekunden. Unterstützte Seitenverhältnisse sind 21:9, 16:9, 4:3, 1:1, 3:4 und 9:16. Die Standardversion von Seedance 2.0 nennt separat 1080p- und 4K-Ausgabe; diese Stufen gehören nicht zur Fast-Spezifikation. Die 2.0-Familie unterstützt die Rückgabe des letzten erzeugten Bildes, aber nicht den separaten Draft-Vorschaumodus.

Audio kann mit dem Material erzeugt oder für einen stummen Clip weggelassen werden. Erzeugtes Audio ist mono. 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. Benennen Sie für eine gesprochene Szene den Sprecher und setzen Sie seine Zeile in Anführungszeichen; geben Sie anschließend Sprechweise und zugehörige Klangeffekte an. Stimmen Sie die gewünschte Darbietung auf die gewählte Cliplänge ab.

Referenzen vorbereiten und Eingabegrenzen beachten

Die dokumentierten Referenzgrenzen sind 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- oder Audioclip muss 2–15 Sekunden lang sein; die gesamte Videodauer beträgt höchstens 15 Sekunden, und die gesamte Audiodauer beträgt separat höchstens 15 Sekunden. Videoreferenzen verwenden MP4 oder MOV mit 24–60 fps und dürfen jeweils 200 MB nicht überschreiten. Audioreferenzen verwenden WAV oder MP3 und dürfen jeweils 15 MB nicht überschreiten. Die aufgeführten Bildformate sind JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC und HEIF. Bilder müssen jeweils kleiner als 30 MB sein; die gesamte Anfragegröße ist auf 64 MB begrenzt. 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 und verweisen Sie konsistent auf sie als Image 1, Video 1 oder Audio 1. Verwenden Sie neben der Dateinummer den Namen oder ein unterscheidbares Merkmal des sichtbaren Motivs. Stimmen Sie den Bildausschnitt der Endpunktbilder auf das vorgesehene Videoseitenverhältnis ab, da eine Abweichung das Bild beschneiden oder einen störenden Wechsel des Bildausschnitts verursachen kann. Konzentrieren Sie das Briefing auf zu übertragende Merkmale, das zu erzeugende Ereignis und die unverändert zu bewahrenden Elemente; ein langer Prompt kann Anweisungen zerstreuen und Nebendetails ungeklärt lassen.

Einstellungsplanung, Text und bekanntes Verhalten

Gliedern Sie ein komplexes Briefing als Shot 1, Shot 2 und Shot 3 mit klarem Motiv, Handlung, Position und Ton je Einstellung. Der Leitfaden empfiehlt eine Kamerabewegung pro Einstellung und nennt genaue Zeitstempel je Einstellung als instabil. Geben Sie jeder Figur eine stabile Bezeichnung und einige unterscheidbare Merkmale; verwenden Sie bei wichtiger Gesichtsidentität eine separate klare Kopfaufnahme und Ganzkörperreferenz statt eines kombinierten Blatts mit mehreren Figurenansichten.

Das Modell kann gängige Texte wie Slogans, Untertitel und Sprechblasen erzeugen, mit Anweisungen zu Farbe, Stil, Position und Einblendung. Gängige Zeichen werden gegenüber seltenen Zeichen oder Sonderzeichen bevorzugt. Prüfen Sie die Buchstaben in Bewegung. Unerwünschte Untertitel, Logos und doppelte Figuren sind dokumentiertes Verhalten; ausdrückliche Vorgaben und saubere Referenzen können sie reduzieren, garantieren aber nicht ihre Abwesenheit. Mehr als vier Referenzpersonen werden als Stabilitätsrisiko genannt, nicht als harte Grenze für die Dateizahl.

Wiederholte Erweiterungen können Bildqualitätsverluste verstärken; ein Erweiterungsübergang kann springen oder zurückspringen. Begrenzen Sie gestapelte Fortsetzungen und prüfen Sie den Übergang im Schnitt. Das Timbre einer Referenzstimme kann abweichen, eine Sprecheraufnahme kann mit einem Klick enden, und chinesische Zeichen mit mehreren Lesungen oder ungewöhnliche Zeichen können falsch ausgesprochen werden. Prüfen Sie die gesprochene Zeile und das abschließende Audio; eine kurze Audioblende kann bei einem abrupten Abbruch helfen. Diese Prüfungen gehören zur Vorbereitung des kreativen Ergebnisses, insbesondere wenn Sprache oder Figurenkontinuität die Geschichte trägt.

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
FeldTypAnforderungWerte und LimitsStandard
FeldmodelTypstringAnforderungErforderlichWerte und Limits
bytedance/seedance-2.0-fast
Standard—
FeldpromptTypstringAnforderungErforderlichWerte und LimitsStandard—
FelddurationTypintegerAnforderungErforderlichWerte und Limits
4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maximum: 600
Standard—
FeldresolutionTypstringAnforderungOptionalWerte und Limits
480p, 720p
Standard—
Feldaspect_ratioTypstringAnforderungOptionalWerte und Limits
1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21
Standard—
Feldgenerate_audioTypbooleanAnforderungOptionalWerte und Limits
false, true
Bedingungen: Das Weglassen von generate_audio wählt den Preis mit Audio; false wählt den Preis ohne Audio. Prüfen Sie has_audio im Ergebnis, um festzustellen, ob eine Audiospur zurückgegeben wurde.
Standard—
Feldframe_imagesTyparrayAnforderungOptionalWerte 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_referencesTyparrayAnforderungOptionalWerte 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—
FeldsizeTypstringAnforderungOptionalWerte und Limits
480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720
Muster: ^[1-9][0-9]*x[1-9][0-9]*$
Standard—
FeldseedTypintegerAnforderungOptionalWerte und Limits
Minimum: -9.223.372.036.854.775.808
Maximum: 9.223.372.036.854.775.807
Standard—
Feldcallback_urlTypstringAnforderungOptionalWerte und Limits
Muster: ^https://
Standard—
Feldsession_idTypstringAnforderungOptionalWerte und LimitsStandard—
FeldtraceTypobjectAnforderungOptionalWerte und LimitsStandard—
FelduserTypstringAnforderungOptionalWerte und LimitsStandard—
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-fast

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-fast

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-fast

prompt: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja

Methodenparameter und Lebenszyklus
ParameterVertrag
Parametercontent_typeVertragapplication/json
ParameterrequiredVertragmodel, prompt, duration
Parametermaterial_typesVertragtext, image, audio
Parameteradditional_propertiesVertragfalse
Parameteroptional_controlsVertragresolution, 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.

KonfigurationTarifstaffelPrognostizierte MengeAbrechnungseinheitAbrechnungsbedingungenGebühr
KonfigurationBasistarife für TokenTarifstaffelGrundtarifPrognostizierte 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
KonfigurationVideotokenpreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro 1K Video-TokenAbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben.Gebühr
Ausgabe · Videotokenpreis · Schätzung nur zum Vergleich $0.0084 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.

KonfigurationVideotokenpreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro 1K Video-TokenAbrechnungsbedingungenEingabe: with_video_inputGebühr
reference · Videotokenpreis · Schätzung nur zum Vergleich $0.00495 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.

KonfigurationVideotokenpreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro 1K Video-TokenAbrechnungsbedingungenAudio: without_audioGebühr
Ausgabe · Videotokenpreis · Schätzung nur zum Vergleich $0.0084 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 GenerierungskostenTarifstaffel—Prognostizierte MengeSchätzung für eine GenerierungAbrechnungseinheit—Abrechnungsbedingungen—Gebühr
Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.18144 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.

KonfigurationAbrechnungsbedingungenGebühr
KonfigurationVideotokenpreisAbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben.Gebühr
Ausgabe · Videotokenpreis $0.0084 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.

KonfigurationVideotokenpreisAbrechnungsbedingungenAudio: without_audioGebühr
Ausgabe · Videotokenpreis $0.0084 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.

KonfigurationVideotokenpreisAbrechnungsbedingungenEingabe: with_video_inputGebühr
reference · Videotokenpreis $0.00495 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\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"model":"bytedance/seedance-2.0-fast","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Ergebnisse abrufen und speichern

Ailoot Ultra · Video

Signierte Inhalts-URLs der Ihnen zugeordneten Assets

Auftragsstatus prüfen
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Abrufe anderer Inhalte
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    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')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
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
FeldTypBedeutung
FeldindexTypintegerBedeutungBei null beginnende Position dieses Videos in der Ausgabeliste.
Feldcontent_urlTypstringBedeutungSignierte HTTPS-Download-URL für dieses fertiggestellte Video.
Feldsha256Typstring | nullBedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar.
Feldsize_bytesTypinteger | nullBedeutungGröße der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar.
Feldduration_msTypinteger | nullBedeutungGemessene Videodauer in Millisekunden; null, falls nicht verfügbar.
FeldwidthTypinteger | nullBedeutungVideobreite in Pixeln; null, falls nicht verfügbar.
FeldheightTypinteger | nullBedeutungVideohöhe in Pixeln; null, falls nicht verfügbar.
Feldvideo_codecTypstring | nullBedeutungVideocodec-Kennung; null, falls nicht aufgezeichnet.
Feldhas_audioTypboolean | nullBedeutungGibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen.
Feldaudio_codecTypstring | nullBedeutungAudiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde.
Fehler und nächste Schritte
AntwortBedingungNächster Schritt
Antwort404 · not_found_errorBedingungDer 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_errorBedingungDer 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_errorBedingungDie 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_unavailableBedingungFü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_errorBedingungEine 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_errorBedingungDas 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_errorBedingungVideoprü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_checkBedingungDas 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_unavailableBedingungDer 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_readyBedingungDer 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-fast

Aliasnamen für Methodenpfade

Verwenden Sie die oben angezeigten Methodenpfade.

Zugehörige Aufrufer-IDs

bytedance/seedance-2.0-fast

", "method_identity": { "effective_request_model_id": "bytedance/seedance-2.0-fast", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|bytedance%2Fseedance-2.0-fast", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Bewahren Sie jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Der Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Prüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.", "type": "not_found_error" }, { "condition": "Der API-Schlüssel passt nicht zum authentifizierten Konto.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Prüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff.", "type": "authentication_error" }, { "condition": "Die Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat.", "type": "invalid_request_error" }, { "condition": "Für die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Wählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden.", "type": "price_unavailable" }, { "condition": "Eine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Verwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel.", "type": "invalid_request_error" }, { "condition": "Das verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Prüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden.", "type": "billing_error" }, { "condition": "Videoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Warten 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.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Das ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Der Download des vorhandenen Videos ist vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Prüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang.", "type": "server_error" }, { "condition": "Der Videoinhalt wurde nicht veröffentlicht.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Prü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.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration" ], "required_material": "Ein schriftlicher Prompt." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Ein schriftlicher Prompt und ein Frame-Bild." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Ein schriftlicher Prompt und Bild- oder Audioreferenzen." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Bei null beginnende Position dieses Videos in der Ausgabeliste.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signierte HTTPS-Download-URL für dieses fertiggestellte Video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Größe der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Gemessene Videodauer in Millisekunden; null, falls nicht verfügbar.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videobreite in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videohöhe in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videocodec-Kennung; null, falls nicht aufgezeichnet.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Gibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "Signierte Inhalts-URLs der Ihnen zugeordneten Assets", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-fast" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "Das Weglassen von generate_audio wählt den Preis mit Audio; false wählt den Preis ohne Audio. Prüfen Sie has_audio im Ergebnis, um festzustellen, ob eine Audiospur zurückgegeben wurde.", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Diese Schlüssel gelten für jedes Frame-Objekt. Lassen Sie frame_images bei einer reinen Textanfrage weg.", "content": "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.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "Lassen Sie frame_images weg, um den Referenzmodus zu verwenden. Verwenden Sie öffentliche HTTPS-URLs.", "content": "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.", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-fast" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Videotokenpreis", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr.", "dimensions": { "conditions": "Eingabe: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Videotokenpreis", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Geschätzte Generierungskosten", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-fast\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "bytedance/seedance-2.0-fast", "nativeProvenance": { "input_facts_canonical_sha256": "7e00466ec2d5411010786dd015fb83c2c490b6e861b5eae4ca5ccf8a8e7e7393", "input_html_sha256": "a4e6701587e107775b5d1775163f6a4f63844d80b12c3bbd95703c1f2cfcacd5", "private_audit_sha256": "fa47be19059e4829d4a1c67993a277f658fd413c3987a6d4ae3f6d113e2b1693", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/de/bytedance-seedance-2-0-fast/", "description": "ByteDance Seedance 2.0 Fast erzeugt Audio-Video-Szenen aus Text-, Bild-, Video- und Klangreferenzen. Seine geschwindigkeitsorientierte Modellversion unterstützt Bewegungs- und Stilübertragung, Videobearbeitung sowie Vorwärts- oder Rückwärtserweiterung mit dokumentierter 480p- und 720p-Ausgabe.", "locale": "de", "md_url": "https://ailoot.ai/models/de/bytedance-seedance-2-0-fast/index.md", "title": "ByteDance: Seedance 2.0 Fast — Ailoot", "url": "https://ailoot.ai/models/de/bytedance-seedance-2-0-fast/" }, "rawModel": { "about": "Seedance 2.0 Fast ist die geschwindigkeitsorientierte Modellversion der Seedance-2.0-Familie von ByteDance Seed. Es unterstützt gemeinsame Video- und Audiogenerierung sowie ein multimodales Briefing aus Text, Bildern, Video und Klang. Zu seinen kreativen Fähigkeiten gehören neue referenzgestützte Szenen, Bearbeitungen vorhandenen Materials und Erweiterungen einer Szene; seine dokumentierten Ausgabestufen sind 480p und 720p.\n\n### Multimodale Referenz: dem Material Rollen zuweisen\n\nEin Bild kann eine Figur, ein Produkt, eine Komposition oder visuelle Gestaltung liefern. Ein Referenzvideo kann Handlung, Kamerabewegung oder einen Effekt liefern. Referenzaudio kann Stimmtimbre, musikalische Melodie oder Dialoginhalt liefern. Erklären Sie, welchen Teil jeder Quelle Sie in die neue Szene übernehmen möchten; eine Referenz ist nützlicher, wenn sie eine bestimmte kreative Rolle hat.\n\nZum Beispiel: „Verwende die Keramiklampe in Image 1 als Produkt. Folge der langsamen Kameraumrundung aus Video 1, platziere die Lampe aber in einer ruhigen Leseecke. Verwende Audio 1 für die musikalische Stimmung.“ Die vorgesehene Ausgabe ist eine neue Szene, die gewähltes Aussehen, Bewegung und Klanggestaltung verbindet, statt jedes Referenzdetail unspezifisch nachzuahmen.\n\nZu den dokumentierten Kombinationen gehören Bilder mit Audio, Bilder mit Video, Video mit Audio sowie alle drei gemeinsam. Text mit Audio allein und reine Audioeingabe werden nicht unterstützt. Das Modell unterstützt außerdem Text-zu-Video und bildgestützte Generierung mit einem Anfangsbild oder einem Paar aus erstem und letztem Bild. Wenn ein genauer Endpunkt im Mittelpunkt des Briefings steht, verwenden Sie den dafür vorgesehenen Endpunktworkflow; ein Referenzbild in einem Omni-Referenz-Prompt als Endpunkt zu beschreiben, ist indirekte Steuerung.\n\n### Ein vorhandenes Video bearbeiten\n\nDas Modell kann Elemente hinzufügen, entfernen oder verändern, ein Motiv ersetzen und Teile einer Szene neu zeichnen oder reparieren. Benennen Sie das Quellvideo, das zu ändernde Objekt und die Elemente, die erhalten bleiben sollen. Beschreiben Sie bei einer Ergänzung, wo und wann sie erscheint. Identifizieren Sie bei einer Entfernung das Objekt im gesamten Clip konsistent.\n\nEin praktisches Bearbeitungsbriefing könnte eine schlichte Flasche in einer Demonstration durch die Flasche aus Image 1 ersetzen und dabei Handbewegung, Hintergrund und Kamerapfad von Video 1 bewahren lassen. Prüfen Sie sowohl die Ersetzung als auch die Bereiche, die stabil bleiben sollen. Klare Erhaltungsanweisungen machen die vorgesehene Bearbeitung leichter bewertbar als eine allgemeine Aufforderung, das Material zu „verbessern“.\n\n### Clips erweitern und verbinden\n\nSeedance 2.0 Fast unterstützt Vorwärts- oder Rückwärtserweiterung und die Verbindung von zwei oder drei Clips durch erzeugte Übergänge. Geben Sie für eine Erweiterung an, ob die neue Handlung vor oder nach dem bereitgestellten Video stattfindet, und beschreiben Sie diese Handlung. Stellen Sie für eine Verbindung die Clips in der vorgesehenen Reihenfolge bereit und erklären Sie das visuelle Ereignis, das sie verbindet.\n\nEine einfache Erweiterung liefert gewöhnlich die neu entwickelte Fortsetzung rund um das ursprüngliche Material, statt von einer Wiederholung des gesamten Quellclips auszugehen. Wenn die Ausgabe das ursprüngliche Segment enthalten soll, sagen Sie dies im Briefing. Beim Füllen eines Übergangs zwischen zwei oder drei Videos kann der dokumentierte Workflow ursprüngliche und neu erzeugte Inhalte kombinieren. Das ist nützlich, um eine weite Produktansicht durch eine gezielte Kamerabewegung mit einer Detailaufnahme zu verbinden.\n\n### Ausgabe und Unterschiede zwischen Modellversionen\n\nDie dokumentierte Fast-Ausgabe ist MP4 mit 24 fps, 480p oder 720p, 8-Bit-Farbtiefe und Clips von 4–15 Sekunden. Unterstützte Seitenverhältnisse sind 21:9, 16:9, 4:3, 1:1, 3:4 und 9:16. Die Standardversion von Seedance 2.0 nennt separat 1080p- und 4K-Ausgabe; diese Stufen gehören nicht zur Fast-Spezifikation. Die 2.0-Familie unterstützt die Rückgabe des letzten erzeugten Bildes, aber nicht den separaten Draft-Vorschaumodus.\n\nAudio kann mit dem Material erzeugt oder für einen stummen Clip weggelassen werden. Erzeugtes Audio ist mono. 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. Benennen Sie für eine gesprochene Szene den Sprecher und setzen Sie seine Zeile in Anführungszeichen; geben Sie anschließend Sprechweise und zugehörige Klangeffekte an. Stimmen Sie die gewünschte Darbietung auf die gewählte Cliplänge ab.\n\n### Referenzen vorbereiten und Eingabegrenzen beachten\n\nDie dokumentierten Referenzgrenzen sind 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- oder Audioclip muss 2–15 Sekunden lang sein; die gesamte Videodauer beträgt höchstens 15 Sekunden, und die gesamte Audiodauer beträgt separat höchstens 15 Sekunden. Videoreferenzen verwenden MP4 oder MOV mit 24–60 fps und dürfen jeweils 200 MB nicht überschreiten. Audioreferenzen verwenden WAV oder MP3 und dürfen jeweils 15 MB nicht überschreiten. Die aufgeführten Bildformate sind JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC und HEIF. Bilder müssen jeweils kleiner als 30 MB sein; die gesamte Anfragegröße ist auf 64 MB begrenzt. 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.\n\nOrdnen Sie die Dateien und verweisen Sie konsistent auf sie als Image 1, Video 1 oder Audio 1. Verwenden Sie neben der Dateinummer den Namen oder ein unterscheidbares Merkmal des sichtbaren Motivs. Stimmen Sie den Bildausschnitt der Endpunktbilder auf das vorgesehene Videoseitenverhältnis ab, da eine Abweichung das Bild beschneiden oder einen störenden Wechsel des Bildausschnitts verursachen kann. Konzentrieren Sie das Briefing auf zu übertragende Merkmale, das zu erzeugende Ereignis und die unverändert zu bewahrenden Elemente; ein langer Prompt kann Anweisungen zerstreuen und Nebendetails ungeklärt lassen.\n\n### Einstellungsplanung, Text und bekanntes Verhalten\n\nGliedern Sie ein komplexes Briefing als Shot 1, Shot 2 und Shot 3 mit klarem Motiv, Handlung, Position und Ton je Einstellung. Der Leitfaden empfiehlt eine Kamerabewegung pro Einstellung und nennt genaue Zeitstempel je Einstellung als instabil. Geben Sie jeder Figur eine stabile Bezeichnung und einige unterscheidbare Merkmale; verwenden Sie bei wichtiger Gesichtsidentität eine separate klare Kopfaufnahme und Ganzkörperreferenz statt eines kombinierten Blatts mit mehreren Figurenansichten.\n\nDas Modell kann gängige Texte wie Slogans, Untertitel und Sprechblasen erzeugen, mit Anweisungen zu Farbe, Stil, Position und Einblendung. Gängige Zeichen werden gegenüber seltenen Zeichen oder Sonderzeichen bevorzugt. Prüfen Sie die Buchstaben in Bewegung. Unerwünschte Untertitel, Logos und doppelte Figuren sind dokumentiertes Verhalten; ausdrückliche Vorgaben und saubere Referenzen können sie reduzieren, garantieren aber nicht ihre Abwesenheit. Mehr als vier Referenzpersonen werden als Stabilitätsrisiko genannt, nicht als harte Grenze für die Dateizahl.\n\nWiederholte Erweiterungen können Bildqualitätsverluste verstärken; ein Erweiterungsübergang kann springen oder zurückspringen. Begrenzen Sie gestapelte Fortsetzungen und prüfen Sie den Übergang im Schnitt. Das Timbre einer Referenzstimme kann abweichen, eine Sprecheraufnahme kann mit einem Klick enden, und chinesische Zeichen mit mehreren Lesungen oder ungewöhnliche Zeichen können falsch ausgesprochen werden. Prüfen Sie die gesprochene Zeile und das abschließende Audio; eine kurze Audioblende kann bei einem abrupten Abbruch helfen. Diese Prüfungen gehören zur Vorbereitung des kreativen Ergebnisses, insbesondere wenn Sprache oder Figurenkontinuität die Geschichte trägt.", "alias_of": null, "aliases": [], "author": "ByteDance", "available": null, "canonical_model": "bytedance/seedance-2.0-fast", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Die vollständigen Preisangaben zur Konfiguration finden Sie in den Details." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "24999f354c53561f1fcfc3f1", "label": "Preisreferenzen für Videokonfigurationen", "profiles": [ { "basis": "Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr.", "dimensions": { "conditions": "In diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben." }, "label": "Videotokenpreis", "units": [ { "amount": "0.0084", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr.", "dimensions": { "conditions": "Audio: without_audio" }, "label": "Videotokenpreis", "units": [ { "amount": "0.0084", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr.", "dimensions": { "conditions": "Eingabe: with_video_input" }, "label": "Videotokenpreis", "units": [ { "amount": "0.00495", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "reference", "unit": "video_token" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "bytedance/seedance-2.0-fast", "input": [ "text", "image", "audio" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Bewahren Sie jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Der Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Prüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.", "type": "not_found_error" }, { "condition": "Der API-Schlüssel passt nicht zum authentifizierten Konto.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Prüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff.", "type": "authentication_error" }, { "condition": "Die Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat.", "type": "invalid_request_error" }, { "condition": "Für die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Wählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden.", "type": "price_unavailable" }, { "condition": "Eine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Verwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel.", "type": "invalid_request_error" }, { "condition": "Das verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Prüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden.", "type": "billing_error" }, { "condition": "Videoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Warten 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.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Das ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Bewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Der Download des vorhandenen Videos ist vorübergehend nicht verfügbar.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Prüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang.", "type": "server_error" }, { "condition": "Der Videoinhalt wurde nicht veröffentlicht.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Prü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.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration" ], "required_material": "Ein schriftlicher Prompt." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Ein schriftlicher Prompt und ein Frame-Bild." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Ein schriftlicher Prompt und Bild- oder Audioreferenzen." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Bei null beginnende Position dieses Videos in der Ausgabeliste.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signierte HTTPS-Download-URL für dieses fertiggestellte Video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Größe der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Gemessene Videodauer in Millisekunden; null, falls nicht verfügbar.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videobreite in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videohöhe in Pixeln; null, falls nicht verfügbar.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videocodec-Kennung; null, falls nicht aufgezeichnet.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Gibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "Signierte Inhalts-URLs der Ihnen zugeordneten Assets", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-fast" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "Das Weglassen von generate_audio wählt den Preis mit Audio; false wählt den Preis ohne Audio. Prüfen Sie has_audio im Ergebnis, um festzustellen, ob eine Audiospur zurückgegeben wurde.", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Diese Schlüssel gelten für jedes Frame-Objekt. Lassen Sie frame_images bei einer reinen Textanfrage weg.", "content": "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.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "Lassen Sie frame_images weg, um den Referenzmodus zu verwenden. Verwenden Sie öffentliche HTTPS-URLs.", "content": "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.", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-fast" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Videotokenpreis", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Der Tarif pro Videotoken ist die maßgebliche Preisreferenz. Die hervorgehobenen Schätzwerte pro Sekunde sind gesonderte Referenzwerte, keine zusätzliche Gebühr.", "dimensions": { "conditions": "Eingabe: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Videotokenpreis", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Geschätzte Generierungskosten", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-fast\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "bytedance/seedance-2.0-fast", "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra" } ], "name": "ByteDance: Seedance 2.0 Fast", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.18144, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.18144, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000112", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000066", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "basis": "video token", "billing_original_currency": "USD", "billing_original_rate": "0.0000084", "key": "video_tokens", "label": "video token", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "basis": "audio=false", "billing_original_currency": "USD", "billing_original_rate": "0.0000084", "key": "video_tokens_without_audio", "label": "video token", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.004950000", "amount_unit": "usd_per_thousand_tokens", "basis": "video_reference_present Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.000004950", "key": "video_tokens_with_video_input", "label": "video token", "native_amount_usd_per_unit": "0.000004950", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" } ] } ], "public_id": "bytedance/seedance-2.0-fast", "short": "ByteDance Seedance 2.0 Fast erzeugt Audio-Video-Szenen aus Text-, Bild-, Video- und Klangreferenzen. Seine geschwindigkeitsorientierte Modellversion unterstützt Bewegungs- und Stilübertragung, Videobearbeitung sowie Vorwärts- oder Rückwärtserweiterung mit dokumentierter 480p- und 720p-Ausgabe." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "ByteDance Seedance 2.0 Fast erzeugt Audio-Video-Szenen aus Text-, Bild-, Video- und Klangreferenzen. Seine geschwindigkeitsorientierte Modellversion unterstützt Bewegungs- und Stilübertragung, Videobearbeitung sowie Vorwärts- oder Rückwärtserweiterung mit dokumentierter 480p- und 720p-Ausgabe.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_exact_canonical_sha256": "106bef3a73cd9ac63d9e862f462caea85558782e0c982edc49aef65121a29124", "raw_model_js_projection_sha256": "4536a3ba0a77cecbc02730cea54c9e0070166d29dba42e7392fba098bac08560", "raw_model_json_sha256": "106bef3a73cd9ac63d9e862f462caea85558782e0c982edc49aef65121a29124", "renderer_sha256": "8bd3076b303b7b3aa4d961032854071403a471ec26a4f50c64e3a32556ea2925" }, "sourceRevision": "62b79892d75e5cc0f58f62316e131cca417f665bc02a14c60366a4dd056076ae" }