ByteDance: Seedance 2.0 Fast
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.
Ü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.
Ailoot Ultra · Video POST /v1/videos bytedance/seedance-2.0-fast
bytedance/seedance-2.0-fastStart
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
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Video POST /v1/videos
- Eingabetypen
text,image,audio- Ausgabetypen
video- Ausgabeformat
- Originale MP4-Bytes; keine Normalisierung/Transkodierung
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits bytedance/seedance-2.0-fast | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldduration | Typinteger | AnforderungErforderlich | Werte und Limits 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 480p, 720p | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Standard— |
Feldgenerate_audio | Typboolean | AnforderungOptional | Werte und Limits false, true Bedingungen: 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_images | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 2 Eingabeinhalt: Array von Frame-Objekten. Jedes enthält type=image_url, image_url mit url und frame_type=first_frame oder last_frame. Jede Rolle darf höchstens einmal vorkommen. Verwenden Sie öffentliche HTTPS-URLs. Exakte Schlüssel: type, image_url, frame_type Bedingungen: Diese Schlüssel gelten für jedes Frame-Objekt. Lassen Sie frame_images bei einer reinen Textanfrage weg. | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits Eingabeinhalt: Array von Bild- oder Audioreferenzobjekten. Setzen Sie type auf image_url oder audio_url und geben Sie das passende URL-Objekt mit url an. Für Videoreferenzen lässt sich weiterhin kein Preis bestimmen. Bedingungen: Lassen Sie frame_images weg, um den Referenzmodus zu verwenden. Verwenden Sie öffentliche HTTPS-URLs. | Standard— |
Feldsize | Typstring | AnforderungOptional | Werte und Limits 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720 Muster: ^[1-9][0-9]*x[1-9][0-9]*$ | Standard— |
Feldseed | Typinteger | AnforderungOptional | Werte und Limits Minimum: -9.223.372.036.854.775.808 Maximum: 9.223.372.036.854.775.807 | Standard— |
Feldcallback_url | Typstring | AnforderungOptional | Werte und Limits Muster: ^https:// | Standard— |
Feldsession_id | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldtrace | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Felduser | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Kombinationen von Eingabematerialien
Text zu Video · Ein schriftlicher Prompt. · Erforderlich: model, prompt, duration
Geben Sie einen Textprompt und eine unterstützte Dauer in ganzen Sekunden an. Verwenden Sie eine exakt aufgeführte Größe oder eine Auflösung und ein Seitenverhältnis, die zu aufgeführten Abmessungen führen.
model: Typ: string · bytedance/seedance-2.0-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
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt, duration |
Parametermaterial_types | Vertragtext, image, audio |
Parameteradditional_properties | Vertragfalse |
Parameteroptional_controls | Vertragresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Lebenszyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungseinheit | Abrechnungsbedingungen | Gebühr |
|---|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationVideotokenpreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro 1K Video-Token | AbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben. | Gebühr Ausgabe · Videotokenpreis · Schätzung nur zum Vergleich $0.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. |
| KonfigurationVideotokenpreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro 1K Video-Token | AbrechnungsbedingungenEingabe: with_video_input | Gebü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. |
| KonfigurationVideotokenpreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro 1K Video-Token | AbrechnungsbedingungenAudio: without_audio | 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. |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.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.
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationVideotokenpreis | AbrechnungsbedingungenIn 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. |
| KonfigurationVideotokenpreis | AbrechnungsbedingungenAudio: without_audio | 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. |
| KonfigurationVideotokenpreis | AbrechnungsbedingungenEingabe: with_video_input | Gebü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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0-fast","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Ergebnisse abrufen und speichern
Ailoot Ultra · Video
Signierte Inhalts-URLs der Ihnen zugeordneten Assets
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Auftragsstatus prüfen
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.
Wenn die ursprüngliche Antwort geprüft werden muss
503 result_pending_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen
Antwortfelder
| Feld | Typ | Bedeutung |
|---|---|---|
Feldindex | Typinteger | BedeutungBei null beginnende Position dieses Videos in der Ausgabeliste. |
Feldcontent_url | Typstring | BedeutungSignierte HTTPS-Download-URL für dieses fertiggestellte Video. |
Feldsha256 | Typstring | null | BedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar. |
Feldsize_bytes | Typinteger | null | BedeutungGröße der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar. |
Feldduration_ms | Typinteger | null | BedeutungGemessene Videodauer in Millisekunden; null, falls nicht verfügbar. |
Feldwidth | Typinteger | null | BedeutungVideobreite in Pixeln; null, falls nicht verfügbar. |
Feldheight | Typinteger | null | BedeutungVideohöhe in Pixeln; null, falls nicht verfügbar. |
Feldvideo_codec | Typstring | null | BedeutungVideocodec-Kennung; null, falls nicht aufgezeichnet. |
Feldhas_audio | Typboolean | null | BedeutungGibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen. |
Feldaudio_codec | Typstring | null | BedeutungAudiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde. |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort404 · not_found_error | BedingungDer Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden. | Nächster SchrittPrüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel. |
Antwort401 · authentication_error | BedingungDer API-Schlüssel passt nicht zum authentifizierten Konto. | Nächster SchrittPrüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff. |
Antwort400 · invalid_request_error | BedingungDie Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig. | Nächster SchrittKorrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat. |
Antwort422 · price_unavailable | BedingungFür die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen. | Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden. |
Antwort422 · invalid_request_error | BedingungEine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig. | Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel. |
Antwort402 · billing_error | BedingungDas verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu. | Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden. |
Antwort503 · server_error | BedingungVideoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar. | Nächster SchrittWarten Sie, bis der Dienst verfügbar ist. Wenn Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung zu erstellen. |
Antwort503 · result_pending_check | BedingungDas ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden. | Nächster SchrittBewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage. |
Antwort503 · owned_result_unavailable | BedingungDer Download des vorhandenen Videos ist vorübergehend nicht verfügbar. | Nächster SchrittPrüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang. |
Antwort409 · video_not_ready | BedingungDer Videoinhalt wurde nicht veröffentlicht. | Nächster SchrittPrüfen Sie den Status der ursprünglichen Aufgabe. Laden Sie das Ergebnis herunter, sobald completed gemeldet wird; bei failed folgen Sie dem Hinweis zur Abrechnungsprüfung. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra bytedance/seedance-2.0-fast
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · ByteDance: Seedance 2.0 Fast
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·bytedance/seedance-2.0-fast:text,image,audio→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·bytedance/seedance-2.0-fast:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Welche Grenzen gelten?
POST /v1/videos·bytedance/seedance-2.0-fast:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807