Alibaba: Wan 3.0
Alibaba Wan 3.0 skaber video med lyd ud fra en prompt, et første billede eller et første og sidste billede samt multimodale referencer. Producentens profil samler storyboard, kildebaseret redigering og fortsættelse i én model med MP4-output på 2–30 sekunder ved 30 fps og en opløsning på 480p, 720p eller 1080p.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Alibaba Wan 3.0 er en samlet profil til videoproduktion, der omsætter en beskrivelse og understøttende materiale til en scene med tilhørende lyd. Producenten angiver standardmodellen som wan3.0-video. Generering udelukkende fra tekst, indledende og afsluttende billeder, multimodale referencer, redigering og fortsættelse bruger forskellige kombinationer af input inden for denne profil. Nyttige resultater omfatter en kort fortælling, en produktpræsentation, en billedbaseret overgang eller et revideret kildeklip, hvor ændringerne følger en bestemt kreativ retning.
Til en scene baseret udelukkende på tekst skal du beskrive motiv, sted, handling, kamera, visuel stil og lyd. Producenten understøtter enkeltoptagelser og storyboards med flere optagelser og anbefaler en struktur med cirka fire til seks sekunder pr. optagelse samt valgfrie tidsintervaller. I en kort fortælling kan du introducere en lille mekanisk fugl på en arbejdsbænk, følge dens første bevægelse og afslutte med et fastholdt nærbillede, mens rummets baggrundslyd fortsætter. Beskriv den visuelle sammenhæng mellem disse øjeblikke, så de tilladte tredive sekunder bruges på én sammenhængende fortælling frem for en række løsrevne handlinger.
Generering fra et første billede animerer et medsendt stillbillede. Stillbilledet fastlægger den indledende komposition, mens prompten forklarer bevægelse og kameraføring. Generering fra et første og sidste billede forankrer også slutningen og beskriver overgangen mellem de to billeder. Forbered start- og slutbilleder med en kompatibel scene og den ønskede indramning. Vejledningen anbefaler adaptivt valg af billedformat til disse tilstande. Deres billedinput holdes adskilt fra kombinationerne af referencebilleder, referencevideo, referencelyd, filer og weblinks, så vælg den materialetilstand, der passer til den planlagte optagelse.
Referencetilstanden kombinerer op til ti billeder, fem videoklip og fem lydklip inden for en samlet grænse på tyve materialer. Billedreferencer kan angive en figur, en genstand, et miljø eller en stil; video kan styre bevægelse eller kameraføring, og lyd kan styre fremførelse eller rytme. Typespecifikke betegnelser som Image 1, Video 1 og Audio 1 følger inputrækkefølgen hver for sig. Giv hver reference en rolle, og beskriv, hvordan den skal indgå sammen med de andre. En figur, der ser rigtig ud i et forkert miljø, er en anden fejl end et kamera, der ikke følger den ønskede bevægelse.
De dokumenterede størrelsesgrænser for referencefiler er 20 MB pr. billede, 100 MB pr. video og 15 MB pr. lydklip. Referencevideoer må tilsammen vare højst femten sekunder, og lydreferencer har en separat samlet grænse på femten sekunder. Ét dokument eller én offentlig webside kan medsendes som reference sammen med referencematerialet; et dokument og et link kan ikke bruges samtidig. Kilden skal være offentligt tilgængelig uden login. Forbered en fokuseret kilde, og angiv, hvilket indhold der skal præge klippet, især når et dokument indeholder mere information, end scenen kan bruge.
Indbygget lyd kombinerer dialog, baggrundsmusik, atmosfære og lydeffekter med det genererede billede. Angiv de ord, der skal siges, hvem der siger dem og hvordan, de vigtige effekter, og om der skal være baggrundsmusik. Lyd er slået til som standard i producentens vejledning og kan slås fra. I en demonstrationsscene kan en kort indledende replik komme før en produktdetalje, mens en afdæmpet mekanisk lyd markerer bevægelsen. Lyt til det færdige klip for at kontrollere den faktiske ordlyd, hvem der taler, og synkroniseringen frem for at vurdere lyden ud fra den skrevne beskrivelse alene.
Ved redigering skal du beskrive ændringen og det indhold, der skal bevares. Vejledningen omfatter tilføjelse eller fjernelse af elementer, udskiftning af egenskaber, ændring af visuel stil eller belysning og revision af dialog. Ved fortsættelse skal du beskrive, hvad der skal ske før, efter eller omkring det eksisterende klip. Adaptiv billedindramning og intelligent varighed hjælper arbejdsgangen med kildevideo med at bevare dens form og tidsmæssige hensigt. Når der indgår videoinput, må den dokumenterede samlede varighed af input- og outputvideo ikke overstige 30 sekunder. Bevar den oprindelige kilde, og undersøg både det ændrede område og kontinuiteten i hele klippet.
Output er MP4 ved 30 fps med en opløsning på 480p, 720p eller 1080p. Varigheden ved nygenerering spænder fra to til tredive sekunder, eller en indstilling for intelligent varighed kan lade modellen vælge længden. Liggende, kvadratiske og stående formater er dokumenteret, og adaptiv billedindramning egner sig til medsendt materiale. Producenten behandler anmodningen som et job og returnerer en placering for den færdige video, som er gyldig i fireogtyve timer. Gem det faktiske resultat, beskrivelsen og referencerne som produktionsdokumentation, og kontrollér den returnerede varighed og indramning, før du sætter videoen sammen med andre klip.
Standardudgaven af Wan 3.0 og dens Prime-variant deler de dokumenterede samlede tilstande; Prime lægger vægt på hurtig generering. Wan 2.7 og 2.6 har særskilte opgavespecifikke regler for varighed og referencer, så deres grænseflader bør ikke behandles som denne udgaves konfiguration. Gennemgå den færdige scene for figur- og produktidentitet, rumlig kontinuitet, tale, effekter, detaljer fra kildematerialet samt den ønskede begyndelse og slutning. En konkret næste rettelse bevarer den vellykkede retning og afhjælper samtidig den faktiske fejl, der er fundet i klippet.
Ailoot Ultra · Video POST /v1/videos alibaba/wan-3.0
alibaba/wan-3.0Start
Alibaba Wan 3.0 skaber video med lyd ud fra en prompt, et første billede eller et første og sidste billede samt multimodale referencer. Producentens profil samler storyboard, kildebaseret redigering og fortsættelse i én model med MP4-output på 2–30 sekunder ved 30 fps og en opløsning på 480p, 720p eller 1080p.
- Accepterede input
- Tekst · Billeder
- Resultater
- Video
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Video POST /v1/videos
- Inputtyper
text,image- Outputtyper
video- Outputformat
- oprindelige MP4-bytes; ingen normalisering/transkodning
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser alibaba/wan-3.0 | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser | Standard— |
Feltduration | Typeinteger | KravPåkrævet | Værdier og grænser 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 Minimum: 1 Maksimum: 600 | Standard— |
Feltresolution | Typestring | KravValgfrit | Værdier og grænser 480p, 720p, 1080p | Standard— |
Feltaspect_ratio | Typestring | KravValgfrit | Værdier og grænser 16:9, 4:3, 1:1, 3:4, 9:16 | Standard— |
Feltgenerate_audio | Typeboolean | KravValgfrit | Værdier og grænser false, true | Standard— |
Feltframe_images | Typearray | KravValgfrit | Værdier og grænser Minimumsantal elementer: 1 Maksimalt antal elementer: 1 Inputindhold: Array af billedobjekter. Hvert objekt har type=image_url, image_url med url samt frame_type. Brug en HTTPS URL til et billede, og sæt frame_type til first_frame. Hver billedrolle må højst forekomme én gang. Præcise nøgler: type, image_url, frame_type Betingelser: Disse nøgler beskriver hvert billedobjekt; image_url indeholder kun url. Udelad frame_images ved en forespørgsel med kun tekst. | Standard— |
Feltinput_references | Typearray | KravValgfrit | Værdier og grænser | Standard— |
Feltseed | Typeinteger | KravValgfrit | Værdier og grænser Minimum: -9.223.372.036.854.775.808 Maksimum: 9.223.372.036.854.775.807 | Standard— |
Feltcallback_url | Typestring | KravValgfrit | Værdier og grænser Mønster: ^https:// | Standard— |
Feltsession_id | Typestring | KravValgfrit | Værdier og grænser | Standard— |
Felttrace | Typeobject | KravValgfrit | Værdier og grænser | Standard— |
Feltuser | Typestring | KravValgfrit | Værdier og grænser | Standard— |
Kombinationer af inputmaterialer
Tekst til video · En skriftlig prompt. · Påkrævet: model, prompt, duration
Angiv prompten som tekst og varigheden i hele sekunder. Vælg en understøttet opløsning og om nødvendigt et billedformat.
model: Type: string · alibaba/wan-3.0
prompt: Type: string · Maksimalt antal UTF-8-bytes: 10.000 · Mindst ét tegn, der ikke er et blanktegn, kræves: Ja
Billede til video · En skriftlig prompt og et billede til første frame. · Påkrævet: model, prompt, duration, frame_images
frame_images er et array. Hvert billedobjekt har type, image_url og frame_type; image_url indeholder url. Sæt type til image_url. Brug first_frame. Hver billedrolle må højst forekomme én gang. Angiv en offentlig HTTPS URL til hvert billede. Vælg en understøttet opløsning og om nødvendigt et billedformat.
Præcise nøgler: type, image_url, frame_type
model: Type: string · alibaba/wan-3.0
prompt: Type: string · Maksimalt antal UTF-8-bytes: 10.000 · Mindst ét tegn, der ikke er et blanktegn, kræves: Ja
Reference to video · En skriftlig prompt og understøttede billedreferencer. · Påkrævet: model, prompt, duration, input_references
input_references er et array af objekter. Sæt type til image_url, og brug det tilsvarende felt med url. Brug offentlige HTTPS-URL’er. Udelad frame_images for at vælge referencetilstand. Vælg en understøttet opløsning og om nødvendigt et billedformat.
model: Type: string · alibaba/wan-3.0
prompt: Type: string · Maksimalt antal UTF-8-bytes: 10.000 · Mindst ét tegn, der ikke er et blanktegn, kræves: Ja
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt, duration |
Parametermaterial_types | Kontrakttext, image |
Parameteradditional_properties | Kontraktfalse |
Parameteroptional_controls | Kontraktresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
Livscyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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 | Afregningsbetingelser | Beløb |
|---|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregningsenhed— | Afregningsbetingelser— | 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 |
| KonfigurationVideopris | Takstplan— | Forventet mængde— | Afregningsenhedpr. videosekund | Afregningsbetingelserresolution: 1080p | Beløb Output · Videopris · Estimat kun til sammenligning $0.4 pr. videosekund |
| KonfigurationVideopris | Takstplan— | Forventet mængde— | Afregningsenhedpr. videosekund | Afregningsbetingelserresolution: 480p | Beløb Output · Videopris · Estimat kun til sammenligning $0.1 pr. videosekund |
| KonfigurationVideopris | Takstplan— | Forventet mængde— | Afregningsenhedpr. videosekund | Afregningsbetingelserresolution: 720p | Beløb Output · Videopris · Estimat kun til sammenligning $0.2 pr. videosekund |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregningsenhed— | Afregningsbetingelser— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.2 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 →
Detaljer om referencetariffen
Referenceplaner på modelniveau ændrer ikke metodevalg, prisoverslag eller opkrævninger. Ved den aktive afregning anvendes taksterne for den valgte Ailoot-metode.
Prisreferencer for videokonfigurationer
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Afregningsbetingelser | Beløb |
|---|---|---|
| KonfigurationVideopris | Afregningsbetingelserresolution: 480p | Beløb Output · Videopris $0.1 pr. videosekund Offentliggjort prisreference for den viste konfiguration. Den endelige afregning følger den konfiguration, der faktisk faktureres. |
| KonfigurationVideopris | Afregningsbetingelserresolution: 720p | Beløb Output · Videopris $0.2 pr. videosekund Offentliggjort prisreference for den viste konfiguration. Den endelige afregning følger den konfiguration, der faktisk faktureres. |
| KonfigurationVideopris | Afregningsbetingelserresolution: 1080p | Beløb Output · Videopris $0.4 pr. videosekund Offentliggjort prisreference for den viste konfiguration. Den endelige afregning følger den konfiguration, der faktisk faktureres. |
Eksempelanmodninger
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('{"aspect_ratio":"16:9","duration":8,"model":"alibaba/wan-3.0","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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
Hent og gem resultater
Ailoot Ultra · Video
signerede indholds-URL’er, du ejer
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Kontrollér opgavestatus
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
Læsning af andet indhold
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
Behold alle færdige resultater
Gem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Behold hvert faktisk output, du ejer, og dets returnerede, målte metadata.
Hvis det oprindelige svar skal kontrolleres
503 result_pending_check + originalid + X-Should-Retry:false; gentag aldrig originalen
Svarfelter
| Felt | Type | Betydning |
|---|---|---|
Feltindex | Typeinteger | BetydningDenne videos position i outputlisten, talt fra nul. |
Feltcontent_url | Typestring | BetydningSigneret HTTPS URL til download af denne færdige video. |
Feltsha256 | Typestring | null | BetydningSHA-256-hash af de oprindelige videobytes; null, hvis den ikke er tilgængelig. |
Feltsize_bytes | Typeinteger | null | BetydningDen oprindelige videofils størrelse i bytes; null, hvis den ikke er tilgængelig. |
Feltduration_ms | Typeinteger | null | BetydningMålt videovarighed i millisekunder; null, hvis den ikke er tilgængelig. |
Feltwidth | Typeinteger | null | BetydningVideoens bredde i pixels; null, hvis den ikke er tilgængelig. |
Feltheight | Typeinteger | null | BetydningVideoens højde i pixels; null, hvis den ikke er tilgængelig. |
Feltvideo_codec | Typestring | null | BetydningIdentifikator for videocodec; null, hvis den ikke er registreret. |
Felthas_audio | Typeboolean | null | BetydningOm videoen indeholder et lydspor; null, hvis det ikke er målt. |
Feltaudio_codec | Typestring | null | BetydningIdentifikator for lydcodec; null, når ingen identifikator er registreret. |
Fejl og næste trin
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar404 · not_found_error | BetingelseVideoadgang er utilgængelig, eller dette video-ID blev ikke fundet. | Næste trinKontrollér videoadgang. For en eksisterende video skal du bruge dens oprindelige offentlige ID og samme API-nøgle. |
Svar401 · authentication_error | BetingelseAPI-nøglen stemmer ikke overens med den autentificerede konto. | Næste trinKontrollér din API-nøgle og kontoadgang, før du indsender. |
Svar400 · invalid_request_error | BetingelseForespørgslen kunne ikke læses, eller downloadindekset er ugyldigt. | Næste trinRet forespørgselsindholdet. Ved download skal du vælge et outputindeks, der er returneret af den oprindelige opgave. |
Svar422 · price_unavailable | BetingelseDen valgte videokonfiguration kan ikke prissættes. | Næste trinVælg en understøttet videokonfiguration, og udfyld dens påkrævede indstillinger, før du sender en rettet forespørgsel. |
Svar422 · invalid_request_error | BetingelseEt videoinput eller den oprindelige fortsættelsesopgave er ugyldigt. | Næste trinBrug gyldigt HTTPS-input. Ved fortsættelse skal du bruge din færdige originals offentlige video-ID med samme API-nøgle. |
Svar402 · billing_error | BetingelseDen tilgængelige saldo eller grænserne tillader ikke en reservation. | Næste trinKontrollér din tilgængelige saldo og dine grænser, før du sender en ny forespørgsel. |
Svar503 · server_error | BetingelseVideokontrol, lager eller tjenesteadgang er midlertidigt utilgængelig. | Næste trinVent, indtil tjenesten er tilgængelig. Hvis du allerede har et video-ID, skal du kontrollere den oprindelige opgave i stedet for at oprette en ny generering. |
Svar503 · result_pending_check | BetingelseDet oprindelige videoresultat og opkrævningen skal kontrolleres. | Næste trinBehold det returnerede video-ID, og kontrollér denne opgave. Send ikke en erstatningsforespørgsel om generering, mens den kontrolleres. |
Svar503 · owned_result_unavailable | BetingelseDownload af den eksisterende video er midlertidigt utilgængelig. | Næste trinKontrollér samme videoopgave senere, og download dens eksisterende output. En ny generering opretter en separat operation. |
Svar409 · video_not_ready | BetingelseVideoindholdet er ikke blevet offentliggjort. | Næste trinKontrollér den oprindelige opgaves status. Download, når den melder completed; hvis den melder failed, skal du følge dens meddelelse om kontrol af opkrævningen. |
Aliaser
Modelaliaser
Ailoot Ultra alibaba/wan-3.0
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · Alibaba: Wan 3.0
- Hvilke input og resultater er tilgængelige?
POST /v1/videos·alibaba/wan-3.0:text,image→video- Hvilke felter bruger anmodningen?
POST /v1/videos·alibaba/wan-3.0:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,seed,callback_url,session_id,trace,user- Hvilke grænser gælder?
POST /v1/videos·alibaba/wan-3.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807