ByteDance: Seedance 2.0
ByteDance Seedance 2.0 combineert native audio-videogeneratie met beeld-, video- en geluidsreferenties. Regisseer nieuwe scènes, bewerk bestaand beeldmateriaal of verleng een reeks; de standaardversie omvat gedocumenteerde 1080p- en 10-bits 4K-uitvoer.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Seedance 2.0 is het standaardmodel van ByteDance Seed voor multimodale audio-videocreatie. Het combineert tekst, beelden, video's en audio in een architectuur voor gezamenlijke generatie, met afzonderlijke creatieve workflows voor referentiegestuurde scènes, videobewerking en videoverlenging. Het is nuttig wanneer de briefing zowel een samenhangende uitvoering als specifieke visuele of geluidsinformatie uit voorbereid materiaal vereist.
Multimodale referentie en regie
Beelden kunnen het uiterlijk van het onderwerp, de visuele stijl en de compositie bepalen. Videoreferenties kunnen actie, camerabeweging en effecten sturen. Audio kan stemtimbre, muziek of dialoog sturen. Definieer de rol van elk materiaal en beschrijf daarna de scène die eruit moet ontstaan. De fabrikant benadrukt controle over spel, belichting, schaduwen en camerataal.
Bereid voor een productverhaal een productbeeld, een referentie voor de camerabeweging en een audioaanwijzing voor. Een briefing kan luiden: “Behoud de blauwe glazen vaas uit Image 1. Gebruik de langzame zijwaartse trackingbeweging uit Video 1. De vaas staat op een zonovergoten plank, met zachte instrumentale muziek op basis van Audio 1.” De bedoelde uitvoer is een nieuw geënsceneerde scène die geselecteerde referentie-informatie combineert.
Referentie-invoer kan beeld en audio, beeld en video, video en audio of alle drie combineren. Invoer met uitsluitend audio en tekst plus audio zonder beeld of video worden niet ondersteund. Traditionele tekst-naar-video, generatie met een eerste frame en generatie met een eerste en laatste frame zijn eveneens gedocumenteerd. Gebruik de specifieke eindpuntworkflow wanneer vaste composities voor het begin en het einde belangrijk zijn: een referentiebeeld binnen een omni-referentieprompt als eindpunt benoemen is slechts een indirecte manier om het te sturen.
Beeldmateriaal bewerken
Het model kan een onderwerp vervangen, objecten toevoegen of verwijderen, elementen veranderen en delen van een video opnieuw tekenen of herstellen. Beschrijf de specifieke wijziging en identificeer het bronmateriaal. Vermeld bij een toevoeging het tijdstip waarop en de positie waar deze verschijnt; benoem bij verwijdering of vervanging het object precies en geef aan wat moet blijven.
Bijvoorbeeld: “Vervang de bureaulamp in Video 1 door de messing lamp uit Image 1. Behoud de camerabeweging, de opstelling op het bureau en de lichtrichting.” Het gewenste resultaat is een bewerkte versie van de scène met de bedoelde vervanging. Controleer zowel de ongewijzigde gebieden als het nieuwe object, vooral wanneer iets aan het zicht wordt onttrokken, tijdens beweging en bij shotwisselingen.
Een reeks verlengen en verbinden
Seedance 2.0 kan een video voorwaarts of achterwaarts verlengen en maximaal drie aangeleverde clips met gegenereerde overgangen verbinden. Specificeer de tijdsrichting en de nieuwe gebeurtenis. Orden voor een verbinding de clips en beschrijf de overgang tussen elk paar, zoals een camera die in het ene shot door een deuropening gaat en in de volgende omgeving aankomt.
Een eenvoudige verlenging geeft doorgaans de voortzetting terug die rond het bronmateriaal is ontwikkeld; voeg een duidelijke instructie toe als het uiteindelijke resultaat ook het oorspronkelijke segment moet herhalen. Bij het voltooien van een verbinding tussen twee of drie clips kan de gedocumenteerde workflow zowel oorspronkelijk materiaal als nieuwe overgangsinhoud bevatten. Dat is nuttig om een opening of einde uit te werken of voorbereide scènes te verbinden zonder de verbindende actie ongespecificeerd te laten.
Uitvoer van de standaardversie en 4K
De standaardversie beschrijft MP4 met 24 fps en een duur van 4 tot 15 seconden. De uitvoerniveaus zijn 480p, 720p en 1080p met 8-bits kleurdiepte, plus 4K met 10-bits kleurdiepte. De ondersteunde verhoudingen zijn 21:9, 16:9, 4:3, 1:1, 3:4 en 9:16. Adaptieve kadrering en automatische duurselectie zijn eveneens gedocumenteerd. De Fast-versie heeft een eigen, beperktere uitvoerspecificatie van 480p/720p.
De 4K-uitvoer gebruikt H.265/HEVC-codering. Tienbitscodering behoudt extra toongradaties en vloeiendere kleurovergangen, wat van belang is voor materiaal met subtiele licht- of kleurverlopen. Controleer of de bedoelde afspeel- en montageomgeving dat formaat kan decoderen; sommige browsers en apparaten spelen het niet rechtstreeks af. Een compatibele container garandeert op zichzelf geen compatibele videodecodering.
Het model kan gesynchroniseerd geluid of een stille video genereren en kan het laatste gegenereerde frame teruggeven voor een volgende scène. Gegenereerde audio is mono. De 2.0-familie ondersteunt niet de afzonderlijke Draft-previewmodus in twee fasen, dus die previewfunctie mag niet uit een andere Seedance-versie worden afgeleid.
Referentievoorbereiding en inhoudelijke grenzen
De gedocumenteerde referentiecapaciteit is maximaal negen beelden, drie video's en drie audioclips. Rechtstreeks geüploade referentiebeelden of video's met echte menselijke gezichten worden in dit gedocumenteerde profiel van de producent niet geaccepteerd; portretwerk gebruikt de ondersteunde workflow voor portretmateriaal. Elke video- en audioclip moet 2–15 seconden duren. Alle videoreferenties samen moeten binnen 15 seconden passen en alle audioreferenties samen hebben een eigen totaal van 15 seconden. Videobestanden gebruiken MP4 of MOV met 24–60 fps, tot 200 MB per bestand; audiobestanden gebruiken WAV of MP3, tot 15 MB per bestand. De vermelde beeldformaten zijn JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC en HEIF. Elk beeld moet kleiner zijn dan 30 MB en de request-body mag niet groter zijn dan 64 MB. In het gedocumenteerde profiel voor referentie-invoer moeten beeldbreedte en -hoogte elk strikt tussen 300 en 6.000 pixels liggen, met een breedte-hoogteverhouding strikt tussen 0,4 en 2,5. Referentievideo's staan 300–6.000 pixels in elke dimensie en verhoudingen van 0,4–2,5 toe, inclusief de grenswaarden, met in totaal 407.696–8.295.044 pixels. MP4- of MOV-video's gebruiken H.264/AVC- of H.265/HEVC-video en AAC- of MP3-audio.
Orden de bestanden doelbewust en verwijs naar elk bestand met mediatype en nummer: Image 1, Video 1 en Audio 1. Het nummer volgt de volgorde van de bestanden van dat type. Leg uit welke eigenschappen moeten worden overgedragen en welke broninhoud de nieuwe scène niet mag bepalen. Gedocumenteerde prompttalen omvatten Engels, Spaans, Indonesisch, Portugees en Japans. Houd de gesproken taal binnen een dialoog consistent; de gids raadt het mengen van talen af, behalve voor eigennamen. Scheid voor stemgestuurd werk de spreker, de exacte regel en de voordrachtaanwijzing.
Bereid eerste en laatste beelden met compatibele kadrering voor. Een afwijking tussen het invoerbeeld en de uitvoerafmetingen kan bijsnijden of een abrupte visuele verandering veroorzaken; overeenkomende afmetingen en adaptieve kadrering zijn gedocumenteerde oplossingen. Houd de beschrijving gericht op de gebeurtenis en de referentierollen. De fabrikant waarschuwt dat lange prompts informatie kunnen versnipperen, waardoor details worden genegeerd. Controleer de resulterende beweging, referentiecontinuïteit, audio-uitvoering en aansluitingen tussen scènes als afzonderlijke onderdelen van het creatieve resultaat.
Shotplanning en tekstregie
Structureer voor een complexe scène de briefing als Shot 1, Shot 2 en Shot 3 en specificeer camera, onderwerpactie, positie en geluid in volgorde. De gids beveelt één camerabeweging per shot aan en geeft de voorkeur aan langzame, samenhangende acties. Exacte tijdsaanduidingen per shot zijn instabiel, dus een reeks gebeurtenissen is een betere sturing dan het afdwingen van meerdere exacte tijdvensters.
Het model genereert ook gangbare tekst, waaronder slogans, ondertitels en tekstballonnen. U kunt kleur, visuele behandeling, plaats en verschijnen van de tekst sturen. Gebruik gangbare tekens in plaats van zeldzame tekens of speciale symbolen en controleer de formulering terwijl deze beweegt. Koppel bij onderwerpreferenties elk bestand duidelijk aan het bedoelde personage of object. Productaanzichten kunnen verschillende visuele informatie leveren; collages met personageaanzichten kunnen gezichtsidentiteit verwarren. Een afzonderlijk duidelijk hoofdportret en een beeld van het volledige lichaam vormen de gedocumenteerde aanbeveling voor personagereferenties.
Gedrag dat vóór een bewerking moet worden gecontroleerd
De gids beschrijft ongewenste ondertitels, logo's, dubbele personages en stijlverschuiving. Schoon bronmateriaal, consistente labels en expliciete beperkingen verminderen die risico's, maar garanderen niet dat ongewenste tekst of dubbele figuren verdwijnen. Meer dan vier referentiepersonen wordt genoemd als risico voor stabiliteit, los van het aantal bestanden dat het model accepteert.
Videoverlenging kan een sprong of terugsprong bij de aansluiting veroorzaken en herhaalde voortzettingen kunnen het verlies van beeldkwaliteit versterken. Controleer de grensframes en beperk gestapelde verlengingen. Een referentiestem kan afwijken van het brontimbre; vertelspraak kan met een klik of abrupte afbreking eindigen, waarvoor een audiofade een gedocumenteerde oplossing is. Chinese tekens met meerdere uitspraken, ongebruikelijke tekens of tekens met een vergelijkbare vorm kunnen verkeerd worden uitgesproken. Voor een precies geanimeerd effect, zoals aftellen, is een bewegingsreferentie informatiever dan alleen een verzoek in woorden. Dit zijn concrete redenen om identiteit, tekst, beweging en geluid afzonderlijk te controleren bij het selecteren van de clip.
Ailoot Ultra · Video POST /v1/videos bytedance/seedance-2.0
bytedance/seedance-2.0Aan de slag
ByteDance Seedance 2.0 combineert native audio-videogeneratie met beeld-, video- en geluidsreferenties. Regisseer nieuwe scènes, bewerk bestaand beeldmateriaal of verleng een reeks; de standaardversie omvat gedocumenteerde 1080p- en 10-bits 4K-uitvoer.
- Toegestane invoer
- Tekst · Afbeeldingen · Audio
- Resultaten
- Video
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Video POST /v1/videos
- Invoertypen
text,image,audio- Uitvoertypen
video- Uitvoerformaat
- oorspronkelijke MP4-bytes; geen normalisatie of transcodering
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten bytedance/seedance-2.0 | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldduration | Typeinteger | VereisteVereist | Waarden en limieten 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Standaard— |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 480p, 720p, 1080p, 4K | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Standaard— |
Veldgenerate_audio | Typeboolean | VereisteOptioneel | Waarden en limieten false, true Voorwaarden: Bij 480p en 720p kiest het weglaten van generate_audio de prijs met audio en kiest false de prijs zonder audio. Bij 1080p en 4K geldt de resolutieprijs voor beide instellingen. Controleer has_audio in het resultaat voor de geretourneerde audiotrack. | Standaard— |
Veldframe_images | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 2 Invoerinhoud: Array met frameobjecten. Elk object bevat type=image_url, image_url met daarin url en frame_type=first_frame of last_frame. Elke rol komt maximaal eenmaal voor. Gebruik openbare HTTPS-URLs. Exacte sleutels: type, image_url, frame_type Voorwaarden: Deze sleutels gelden voor elk frameobject. Laat frame_images weg voor een verzoek met uitsluitend tekst. | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten Invoerinhoud: Array met afbeeldings- of audioreferentieobjecten. Stel type in op image_url of audio_url en geef het bijbehorende URL-object met daarin url op. Voor videoreferenties kan nog steeds geen prijs worden bepaald. Voorwaarden: Laat frame_images weg om de referentiemodus te gebruiken. Gebruik openbare HTTPS-URLs. | Standaard— |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 Patroon: ^[1-9][0-9]*x[1-9][0-9]*$ | Standaard— |
Veldseed | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: -9.223.372.036.854.775.808 Maximum: 9.223.372.036.854.775.807 | Standaard— |
Veldcallback_url | Typestring | VereisteOptioneel | Waarden en limieten Patroon: ^https:// | Standaard— |
Veldsession_id | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldtrace | Typeobject | VereisteOptioneel | Waarden en limieten | Standaard— |
Velduser | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Combinaties van invoermaterialen
Tekst naar video · Een geschreven prompt. · Vereist: model, prompt, duration
Geef een tekstprompt en een ondersteunde duur in hele seconden op. Gebruik een exact vermelde grootte, of een resolutie en beeldverhouding die resulteren in vermelde afmetingen.
model: Type: string · bytedance/seedance-2.0
prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja
Afbeelding naar video · Een geschreven prompt en een frameafbeelding. · Vereist: model, prompt, duration, frame_images
frame_images is een array met objecten met type=image_url, image_url met daarin url, en frame_type. Gebruik een openbare HTTPS-afbeeldings-URL; first_frame en last_frame mogen elk eenmaal voorkomen. Gebruik een vermelde uitvoergrootte of compatibele afmetingen. Voeg geen videoreferenties toe.
Exacte sleutels: type, image_url, frame_type
model: Type: string · bytedance/seedance-2.0
prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja
Reference to video · Een geschreven prompt en afbeeldings- of audioreferenties. · Vereist: model, prompt, duration, input_references
input_references is een array. Elk object bevat type=image_url of type=audio_url en een bijbehorend URL-object met daarin url. Gebruik openbare HTTPS-links. Laat frame_images weg om de referentiemodus te selecteren. Videoreferenties kunnen niet worden geprijsd.
model: Type: string · bytedance/seedance-2.0
prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt, duration |
Parametermaterial_types | Contracttext, image, audio |
Parameteradditional_properties | Contractfalse |
Parameteroptional_controls | Contractresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Levenscyclus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Rekeneenheid | Factureringsvoorwaarden | Kosten |
|---|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Rekeneenheid— | Factureringsvoorwaarden— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratiePrijs per videotoken | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper 1K videotokens | FactureringsvoorwaardenIn deze prijssleutel is geen aanvullende voorwaarde vastgelegd. | Kosten Uitvoer · Prijs per videotoken · Schatting uitsluitend ter vergelijking $0.014 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper 1K videotokens | Factureringsvoorwaardenresolution: 1080p | Kosten Uitvoer · Prijs per videotoken · Schatting uitsluitend ter vergelijking $0.0154 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper 1K videotokens | Factureringsvoorwaardeninvoer: with_video_input; resolutie: 1080p | Kosten reference · Prijs per videotoken · Schatting uitsluitend ter vergelijking $0.0094 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper 1K videotokens | Factureringsvoorwaardenresolution: 4k | Kosten Uitvoer · Prijs per videotoken · Schatting uitsluitend ter vergelijking $0.008 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper 1K videotokens | Factureringsvoorwaardeninvoer: with_video_input; resolutie: 4k | Kosten reference · Prijs per videotoken · Schatting uitsluitend ter vergelijking $0.0048 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper 1K videotokens | Factureringsvoorwaardeninvoer: with_video_input | Kosten reference · Prijs per videotoken · Schatting uitsluitend ter vergelijking $0.0086 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper 1K videotokens | Factureringsvoorwaardengeluid: without_audio | Kosten Uitvoer · Prijs per videotoken · Schatting uitsluitend ter vergelijking $0.014 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Factureringsvoorwaarden— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.3024 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Details van het referentietarief
Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.
Prijsreferenties voor videoconfiguraties
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| ConfiguratiePrijs per videotoken | FactureringsvoorwaardenIn deze prijssleutel is geen aanvullende voorwaarde vastgelegd. | Kosten Uitvoer · Prijs per videotoken $0.014 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Factureringsvoorwaardenresolution: 4k | Kosten Uitvoer · Prijs per videotoken $0.008 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Factureringsvoorwaardenresolution: 1080p | Kosten Uitvoer · Prijs per videotoken $0.0154 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Factureringsvoorwaardengeluid: without_audio | Kosten Uitvoer · Prijs per videotoken $0.014 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Factureringsvoorwaardeninvoer: with_video_input | Kosten reference · Prijs per videotoken $0.0086 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Factureringsvoorwaardeninvoer: with_video_input; resolutie: 4k | Kosten reference · Prijs per videotoken $0.0048 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
| ConfiguratiePrijs per videotoken | Factureringsvoorwaardeninvoer: with_video_input; resolutie: 1080p | Kosten reference · Prijs per videotoken $0.0094 per 1K videotokens Het tarief per videotoken is de primaire prijsreferentie. De prominent weergegeven schattingen per seconde zijn afzonderlijke referenties, geen extra kosten. |
Voorbeeldverzoeken
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Resultaten ophalen en opslaan
Ailoot Ultra · Video
ondertekende inhouds-URLs die u bezit
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Taakstatus controleren
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
Lezen van andere inhoud
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 voltooide resultaten bewaren
Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.
Bewaar alle daadwerkelijke uitvoer die u bezit en de geretourneerde gemeten metadata.
Als het oorspronkelijke antwoord moet worden gecontroleerd
503 result_pending_check + oorspronkelijke id + X-Should-Retry:false; herhaal het oorspronkelijke verzoek nooit
Antwoordvelden
| Veld | Type | Betekenis |
|---|---|---|
Veldindex | Typeinteger | BetekenisPositie van deze video in de uitvoerlijst, geteld vanaf nul. |
Veldcontent_url | Typestring | BetekenisOndertekende HTTPS-download-URL voor deze voltooide video. |
Veldsha256 | Typestring | null | BetekenisSHA-256-digest van de oorspronkelijke videobytes; null indien niet beschikbaar. |
Veldsize_bytes | Typeinteger | null | BetekenisGrootte van het oorspronkelijke videobestand in bytes; null indien niet beschikbaar. |
Veldduration_ms | Typeinteger | null | BetekenisGemeten videoduur in milliseconden; null indien niet beschikbaar. |
Veldwidth | Typeinteger | null | BetekenisVideobreedte in pixels; null indien niet beschikbaar. |
Veldheight | Typeinteger | null | BetekenisVideohoogte in pixels; null indien niet beschikbaar. |
Veldvideo_codec | Typestring | null | BetekenisVideocodec-identificatie; null indien niet vastgelegd. |
Veldhas_audio | Typeboolean | null | BetekenisOf de video een audiotrack bevat; null indien niet gemeten. |
Veldaudio_codec | Typestring | null | BetekenisAudiocodec-identificatie; null wanneer geen identificatie is vastgelegd. |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord404 · not_found_error | VoorwaardeVideotoegang is niet beschikbaar of deze video-ID is niet gevonden. | Volgende stapControleer videotoegang. Gebruik voor een bestaande video de oorspronkelijke openbare ID en dezelfde API-sleutel. |
Antwoord401 · authentication_error | VoorwaardeDe API-sleutel komt niet overeen met het geauthenticeerde account. | Volgende stapControleer uw API-sleutel en accounttoegang voordat u indient. |
Antwoord400 · invalid_request_error | VoorwaardeHet verzoek kon niet worden gelezen of de downloadindex is ongeldig. | Volgende stapCorrigeer de verzoekbody. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is geretourneerd. |
Antwoord422 · price_unavailable | VoorwaardeDe geselecteerde videoconfiguratie kan niet worden geprijsd. | Volgende stapKies een ondersteunde videoconfiguratie en vul de vereiste opties in voordat u een gecorrigeerd verzoek indient. |
Antwoord422 · invalid_request_error | VoorwaardeEen videoinvoer of oorspronkelijke vervolgtaak is ongeldig. | Volgende stapGebruik geldige HTTPS-invoer. Gebruik voor een vervolg uw voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel. |
Antwoord402 · billing_error | VoorwaardeHet beschikbare saldo of de limieten staan geen reservering toe. | Volgende stapControleer uw beschikbare saldo en limieten voordat u een nieuw verzoek verstuurt. |
Antwoord503 · server_error | VoorwaardeVideoverificatie, opslag of servicetoegang is tijdelijk niet beschikbaar. | Volgende stapWacht tot de service beschikbaar is. Als u al een video-ID hebt, controleert u die oorspronkelijke taak in plaats van een nieuwe generatie aan te maken. |
Antwoord503 · result_pending_check | VoorwaardeHet oorspronkelijke videoresultaat en de kosten moeten worden gecontroleerd. | Volgende stapBewaar de geretourneerde video-ID en controleer die taak. Verstuur geen vervangend generatieverzoek terwijl deze wordt gecontroleerd. |
Antwoord503 · owned_result_unavailable | VoorwaardeDe bestaande videodownload is tijdelijk niet beschikbaar. | Volgende stapControleer dezelfde videotaak later en download de bestaande uitvoer. Een nieuwe generatie maakt een afzonderlijke operatie aan. |
Antwoord409 · video_not_ready | VoorwaardeDe video-inhoud is niet gepubliceerd. | Volgende stapControleer de oorspronkelijke taakstatus. Download nadat deze completed meldt; als deze failed meldt, volgt u de melding over kostencontrole. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra bytedance/seedance-2.0
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · ByteDance: Seedance 2.0
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/videos·bytedance/seedance-2.0:text,image,audio→video- Welke velden gebruikt het verzoek?
POST /v1/videos·bytedance/seedance-2.0:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Welke limieten gelden?
POST /v1/videos·bytedance/seedance-2.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807