ByteDance: Seedance 1.0 Pro
Seedance 1.0 Pro genererer video uden lyd fra tekst eller et åbningsbillede. Beskriv handling og kamera, eller animer en eksisterende komposition, med en varighed på 2–12 sekunder, 24 fps og eksplicitte indstillinger til outputindramning og opløsning.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Seedance 1.0 Pro genererer en video ud fra tekst eller en billedstyret scene. Selektoren doubao-seedance-1-0-pro-250528 understøtter begge inputtilstande, så udgangspunktet kan være et skriftligt koncept eller en eksisterende visuel komposition. Brug en tekstbeskrivelse til at skabe en ny scene, eller lever et billede, når motiv, opstilling og åbningsbillede skal fastlægges visuelt. Denne 1.0-profil producerer video uden lyd; synkroniseret lyd hører til den særskilt beskrevne 1.5 Pro-profil.
Til tekst-til-video skal motiv, omgivelser, bevægelse, billedindramning og kamera angives i én sammenhængende scene. Det dokumenterede eksempel bevæger sig gradvist fra en mark med tusindfryd til et nærbillede af en blomst med dug på kronbladene. Den struktur er nyttig til andre afsløringer: etabler omgivelserne, bevæg kameraet mod motivet, og slut på den vigtige detalje. Ved et produktkoncept skal materiale og belysning beskrives sammen med handlingen, og kameraet skal have en gennemførlig rute gennem den korte optagelse.
Til billede-til-video skal referencen placeres i et content-element af typen image_url, og det skal forklares, hvad der skal ændres fra dette startbillede. Et forberedt portræt kan definere personen og beskæringen, mens beskrivelsen angiver en lille drejning, hår i bevægelse eller en rolig kamerabevægelse bagud. Et produktfoto kan fastlægge genstanden og baggrunden, mens prompten beder om en kontrolleret afsløring. Hold den ønskede bevægelse forenelig med kildekompositionen; et billede af én side af en genstand leverer ikke en præcis gengivelse af alle de andre, usete sider.
Billedfeltet accepterer en tilgængelig URL eller en data-URL med Base64-billeddata. De dokumenterede formater er JPEG, PNG, WEBP, BMP, TIFF og GIF. Billeder skal være mindre end 30 MB med et bredde-højde-forhold strengt mellem 0,4 og 2,5 og hver dimension strengt mellem 300 og 6000 pixels. Forbered en tydelig kilde med den tilsigtede beskæring frem for at stole på en miniature, hvor de afgørende detaljer allerede mangler. Til billede-til-video-generering anbefaler vejledningen adaptiv indramning, der følger referencebilledets proportioner.
Den dokumenterede varighed for 1.0 er to til tolv sekunder, og billedfrekvensen er 24 fps. Outputindstillingerne omfatter niveauerne 480p, 720p og 1080p med 1080p som Pro-standard; vejledningen udelukker 1080p i scenariet med referencebillede. De faste billedformater omfatter 16:9, 4:3, 1:1, 3:4, 9:16 og 21:9. Vælg en billedkompatibel kombination til en billedstyret optagelse frem for at overføre alle tekst-til-video-indstillinger uændret. Undersøg den faktisk returnerede billedindramning, før klippet placeres i et layout.
Indstillinger til seed og watermark er dokumenteret sammen med camerafixed. Instruktionen om fast kamera understøttes ikke i scenariet med referencebillede, og hvor den gælder, garanterer vejledningen ikke et fuldstændig stillestående kamera. Parameterinstruktioner i prompten har forrang for separate valgfrie felter. Bevar én styrende indstilling til varighed, opløsning og billedformat, og lad kamerabeskrivelsen stemme overens med den. Det forhindrer, at en scenebeskrivelse stiltiende tilsidesætter de indstillinger, der er valgt til anmodningen.
Forbruget måles i videotokens: outputbredde × outputhøjde × billedfrekvens × outputvarighed / 1024. Den fuldførte opgave rapporterer denne mængde som usage.completion_tokens. Bevar det rapporterede forbrug sammen med det færdige klip og de ønskede indstillinger.
Arbejdsgangen returnerer først en opgaveidentifikator og efter behandlingen en placering for den færdige video. Bevar identifikatoren, mens kø- eller kørestatus kontrolleres; en vellykket opgave leverer content.video_url og forbrugsoplysninger. Den dokumenterede opbevaring af genererede filer er syv dage. Gem det færdige klip, kildebilledet og den præcise prompt som revisionsgrundlag, og gennemgå derefter motivets udseende, bevægelse, billedkontinuitet og slutkomposition i hele resultatet.
Ailoot Ultra · Videoer POST /v1/videos doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528Start
Seedance 1.0 Pro genererer video uden lyd fra tekst eller et åbningsbillede. Beskriv handling og kamera, eller animer en eksisterende komposition, med en varighed på 2–12 sekunder, 24 fps og eksplicitte indstillinger til outputindramning og opløsning.
- Accepterede input
- Tekst · Billeder
- Resultater
- Video
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Videoer POST /v1/videos
- Inputtyper
text,image- Outputtyper
video
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser doubao-seedance-1-0-pro-250528 | Standard— |
Feltcontent | Typearray | KravPåkrævet | Værdier og grænser Betingelser: Tekst- og medieobjekter i det oprindelige format; det yderste array må ikke være tomt. Indlejrede nodetyper valideres ikke af denne generiske Ailoot-konstruktør. | Standard— |
Feltduration | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 2 Maksimum: 12 Betingelser: Det primære 1.x-skema angiver 2–12; en senere fælles beskrivelse angiver 1.5 som 4–12 eller -1. Eksemplet bruger 5, som er dokumenteret begge steder. | Standard5 |
Feltresolution | Typestring | KravValgfrit | Værdier og grænser Betingelser: De bekræftede værdier for tekst til video er 480p og 1080p. Input med referencebillede udelukker 1080p. Den fælles 720p-enum er i modstrid med den modelspecifikke tekst, så understøttelse af 720p er fortsat uafklaret i begge tilstande. | Standard1080p |
Feltratio | Typestring | KravValgfrit | Værdier og grænser 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Betingelser: Standardværdierne afhænger af scene og model; dokumentationen for billedinput anbefaler adaptive. | Standard— |
Feltservice_tier | Typestring | KravValgfrit | Værdier og grænser default, flex Betingelser: default=online, flex=offline; vælg før oprettelse. | Standarddefault |
Feltseed | Typeinteger | KravPåkrævet | Værdier og grænser Minimum: -1 Maksimum: 4.294.967.295 | Standard-1 |
Feltcamerafixed | Typeboolean | KravPåkrævet | Værdier og grænser Betingelser: Påkrævet af Ailoot; kamerastyring med referencebillede er dokumenteret som ikke understøttet, og virkningen er ikke garanteret. | Standardfalse |
Feltwatermark | Typeboolean | KravPåkrævet | Værdier og grænser | Standardfalse |
Feltexecution_expires_after | Typeinteger | KravPåkrævet | Værdier og grænser Minimum: 3.600 Maksimum: 259.200 Enhed: sekunder | Standard172.800 |
Kombinationer af inputmaterialer
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktcamerafixed, content, execution_expires_after, model, seed, watermark |
Parameteroptional | Kontraktduration, resolution, ratio, service_tier |
Parametermaterial_types | Kontrakttext, image |
Parameteradditional_properties | Kontrakttrue |
Parametervalidation_scope | KontraktAiloot kontrollerer de påkrævede felttyper og et ikke-tomt model/content-array. Andre forespørgselsfelter bevares til den valgte model. |
Parameterimage_constraints | Kontrakt{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":null} |
Metodealiaser: /v1/videos/generations
Livscyklus: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Opret én gang, og behold det returnerede offentlige id/polling_url.
Forespørg på det oprindelige jobs status; download faktisk ejet content.video_url efter succeeded.
Priser
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Afregningsenhed | Beløb |
|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregningsenhed— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| KonfigurationUltra | Takstplan— | Forventet mængde— | Afregningsenhedpr. 1K videotokens | Beløb Output · Estimat kun til sammenligning $0.0044 pr. 1K videotokens |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.2112 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Videoer
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-250528","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
JSON_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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
index=$((index + 1))
done < asset-urls.txt
Hent og gem resultater
Ailoot Ultra · Videoer
Native JSON med offentligt id/polling_url. Efter offentliggørelse indeholder content.video_url signerede URL’er, der ejes af Ailoot; før offentliggørelse tømmes de valgte output-URL’er.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Behold alle færdige resultater
Gem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Behold hver faktisk URL i content.video_url; index skal identificere et reelt returneret output.
Hvis det oprindelige svar skal kontrolleres
Behold det oprindelige svar, headere og id, og forespørg på denne operations status; indsend aldrig en oprettelse med ukendt udfald igen.
Svarfelter
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltprovider_task_id | Typestring |
Feltpolling_url | Typestring |
Feltstatus | Typestring when supplied |
Feltcontent.video_url | Typestring|string[] |
Feltusage | Typeobject when supplied |
Fejl og næste trin
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar400 · invalid_request_error | BetingelseUgyldig JSON/model, ugyldige påkrævede felttyper eller ugyldigt indholdsindeks. | Næste trin |
Svar401 · authentication_error | BetingelseUgyldig Ailoot API-nøgle. | Næste trin |
Svar404 · not_found_error | BetingelseOpgaven eller outputtet mangler eller tilhører ikke samme bruger/API-nøgle/gruppe. | Næste trin |
Svar502 · result_pending_check | BetingelseOprindelig indsendelse eller status er ufuldstændig; behold det oprindelige ID, og indsend ikke igen. | Næste trin |
Svar503 · result_pending_check | BetingelseDe oprindelige medier, ruten eller afregningen kontrolleres; fortsæt den oprindelige operation. | Næste trin |
Aliaser
Modelaliaser
Ailoot Ultra doubao-seedance-1-0-pro-250528
Aliaser for metodestier
/v1/videos/generations
Relaterede kalder-ID’er
FAQ · ByteDance: Seedance 1.0 Pro
- Hvilke input og resultater er tilgængelige?
POST /v1/videos·doubao-seedance-1-0-pro-250528:text,image→video- Hvilke felter bruger anmodningen?
POST /v1/videos·doubao-seedance-1-0-pro-250528:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Hvilke grænser gælder?
POST /v1/videos·doubao-seedance-1-0-pro-250528:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200