Alibaba: Wan 3.0
Alibaba Wan 3.0 lager video med lyd fra en prompt, første bilde eller første/siste bilde og multimodale referanser. Produsentens profil samler storyboard, kildebasert redigering og videreføring i én modell, med MP4-resultater på 2–30 sekunder ved 30 bilder per sekund og oppløsning på 480p, 720p eller 1080p.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Alibaba Wan 3.0 er en samlet profil for videoskaping som er utviklet for å gjøre en beskrivelse og tilhørende materiale om til en scene med lyd. Produsenten identifiserer standardmodellen som wan3.0-video. Generering fra bare tekst, åpnings- og sluttbilder, multimodale referanser, redigering og videreføring bruker ulike inndataoppsett innenfor denne profilen. Nyttige resultater omfatter en kort fortelling, en produktpresentasjon, en bildebasert overgang eller et bearbeidet kildeklipp der endringene følger en bestemt kreativ retning.
For en scene med bare tekst klargjør du motiv, lokasjon, handling, kamera, visuell stil og lyd. Produsenten støtter enkeltopptak og storyboard med flere opptak, med en anbefalt struktur på omtrent fire til seks sekunder per opptak og valgfrie tidsintervaller. I en kort historie kan du introdusere en liten mekanisk fugl på en arbeidsbenk, følge den første bevegelsen og avslutte med et holdt nærbilde mens rommets bakgrunnslyd fortsetter. Beskriv den visuelle sammenhengen mellom disse momentene, slik at rammen på tretti sekunder tjener én sammenhengende historie fremfor en liste over løsrevne handlinger.
Generering fra første bilde animerer et innsendt stillbilde. Stillbildet definerer startkomposisjonen, mens prompten forklarer bevegelse og kameraføring. Generering fra første/siste bilde forankrer også avslutningen og beskriver overgangen mellom de to bildene. Klargjør endepunkter med en forenlig scene og ønsket utsnitt. Veiledningen anbefaler tilpasset valg av sideforhold for disse modusene. Bildeinndataene deres holdes atskilt fra oppsettene for referansebilder, referansevideo, referanselyd, filer og nettlenker, så velg materialmodusen som passer det planlagte opptaket.
Referansemodus kombinerer opptil ti bilder, fem videoklipp og fem lydklipp, innenfor en samlet ramme på tjue materialer. Bildereferanser kan angi en karakter, et objekt, omgivelser eller en stil; video kan styre bevegelse eller kameraføring, og lyd kan styre fremføring eller rytme. Typespesifikke etiketter som Image 1, Video 1 og Audio 1 følger inndatarekkefølgen uavhengig av hverandre. Gi hver referanse en rolle, og beskriv hvordan den skal samspille med de andre. En karakter som ser riktig ut i feil omgivelser, er en annen feil enn et kamera som bommer på den ønskede bevegelsen.
De dokumenterte grensene for referansefiler er 20 MB per bilde, 100 MB per video og 15 MB per lydklipp. Referansevideoene er samlet begrenset til femten sekunder, og lydreferansene har en egen samlet grense på femten sekunder. Ett dokument eller én offentlig nettsidereferanse kan følge referansematerialet; et dokument og en lenke utelukker hverandre. Kilden må være offentlig tilgjengelig uten innlogging. Klargjør en avgrenset kilde, og angi hvilket innhold som skal påvirke klippet, særlig når et dokument inneholder mer informasjon enn scenen kan bruke.
Innebygd lyd kombinerer dialog, bakgrunnsmusikk, atmosfære og lydeffekter med det genererte bildet. Angi ordene som skal sies, taleren og fremføringen, viktige effekter og om bakgrunnsmusikk skal være med. Lyd er aktivert som standard i produsentens veiledning og kan deaktiveres. I en demonstrasjonsscene kan en kort innledende replikk komme før en produktdetalj, mens en dempet mekanisk lyd markerer bevegelsen. Lytt til det ferdige klippet for å kontrollere faktisk ordlyd, hvem som snakker og synkronisering, fremfor å vurdere lyden bare fra den skriftlige beskrivelsen.
For en redigering beskriver du endringen og innholdet som skal beholdes. Veiledningen dekker å legge til eller fjerne elementer, erstatte egenskaper, endre visuell stil eller lyssetting og bearbeide dialog. For videreføring beskriver du hva som skal skje før, etter eller rundt det eksisterende klippet. Tilpasset utsnitt og smart lengde hjelper arbeidsflyten med kildevideo å bevare hensikten med format og timing. Når videoinndata sendes inn, må den dokumenterte samlede lengden på inngangs- og utdatavideo ikke overstige 30 sekunder. Behold originalkilden, og undersøk både det endrede området og kontinuiteten gjennom hele klippet.
Resultatet er MP4 ved 30 bilder per sekund, med oppløsning på 480p, 720p eller 1080p. Lengden ved nygenerering varierer fra to til tretti sekunder, eller en innstilling for smart lengde lar modellen velge varigheten. Liggende, kvadratiske og stående formater er dokumentert, med tilpasset utsnitt egnet for innsendt materiale. Produsenten behandler forespørselen som en jobb og returnerer en adresse til den ferdige videoen som er gyldig i tjuefire timer. Behold selve resultatet, beskrivelsen og referansene som produksjonsgrunnlag, og kontroller returnert lengde og utsnitt før du setter det sammen med andre klipp.
Standardutgaven Wan 3.0 og Prime-varianten deler de dokumenterte, samlede modusene; Prime legger vekt på genereringshastighet. Wan 2.7 og 2.6 har egne oppgavespesifikke regler for lengde og referanser, så grensesnittene deres skal ikke behandles som denne utgavens konfigurasjon. Vurder den ferdige scenen for karakter- og produktidentitet, romlig kontinuitet, tale, effekter, detaljer fra kildene og den ønskede begynnelsen og avslutningen. En konkret neste korrigering bevarer den vellykkede retningen samtidig som den håndterer den faktiske mangelen i klippet.
Ailoot Ultra · Video POST /v1/videos alibaba/wan-3.0
alibaba/wan-3.0Start
Alibaba Wan 3.0 lager video med lyd fra en prompt, første bilde eller første/siste bilde og multimodale referanser. Produsentens profil samler storyboard, kildebasert redigering og videreføring i én modell, med MP4-resultater på 2–30 sekunder ved 30 bilder per sekund og oppløsning på 480p, 720p eller 1080p.
- Godkjente inndata
- Tekst · Bilder
- Resultater
- Video
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Video POST /v1/videos
- Inndatatyper
text,image- Utdatatyper
video- Utdataformat
- opprinnelige MP4-bytes; ingen normalisering/transkoding
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser alibaba/wan-3.0 | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser | Standard— |
Feltduration | Typeinteger | KravPåkrevd | Verdier & grenser 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 | KravValgfritt | Verdier & grenser 480p, 720p, 1080p | Standard— |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 16:9, 4:3, 1:1, 3:4, 9:16 | Standard— |
Feltgenerate_audio | Typeboolean | KravValgfritt | Verdier & grenser false, true | Standard— |
Feltframe_images | Typearray | KravValgfritt | Verdier & grenser Minste antall elementer: 1 Maksimalt antall elementer: 1 Inngående innhold: Matrise med bildeobjekter. Hvert objekt har type=image_url, image_url som inneholder url, og frame_type. Bruk en HTTPS-basert URL til bildet, og sett frame_type til first_frame. Hver bilderolle forekommer høyst én gang. Nøyaktige nøkler: type, image_url, frame_type Vilkår: Disse nøklene beskriver hvert bildeobjekt; image_url inneholder bare url. Utelat frame_images ved en forespørsel som bare inneholder tekst. | Standard— |
Feltinput_references | Typearray | KravValgfritt | Verdier & grenser | Standard— |
Feltseed | Typeinteger | KravValgfritt | Verdier & grenser Minimum: −9 223 372 036 854 775 808 Maksimum: 9 223 372 036 854 775 807 | Standard— |
Feltcallback_url | Typestring | KravValgfritt | Verdier & grenser Mønster: ^https:// | Standard— |
Feltsession_id | Typestring | KravValgfritt | Verdier & grenser | Standard— |
Felttrace | Typeobject | KravValgfritt | Verdier & grenser | Standard— |
Feltuser | Typestring | KravValgfritt | Verdier & grenser | Standard— |
Kombinasjoner av inngående materialer
Tekst til video · En skriftlig ledetekst. · Påkrevd: model, prompt, duration
Oppgi prompt som tekst og duration som hele sekunder. Velg en støttet oppløsning og ved behov et sideforhold.
model: Type: string · alibaba/wan-3.0
prompt: Type: string · Maksimalt antall UTF-8-byte: 10 000 · Minst ett tegn som ikke er mellomrom, kreves: Ja
Bilde til video · En skriftlig ledetekst og et bilde for første enkeltbilde. · Påkrevd: model, prompt, duration, frame_images
frame_images er en matrise. Hvert bildeobjekt har type, image_url og frame_type; image_url inneholder url. Sett type til image_url. Bruk first_frame. Hver bilderolle forekommer høyst én gang. Oppgi en offentlig tilgjengelig HTTPS-basert URL til bildet for hvert enkeltbilde. Velg en støttet oppløsning og ved behov et sideforhold.
Nøyaktige nøkler: type, image_url, frame_type
model: Type: string · alibaba/wan-3.0
prompt: Type: string · Maksimalt antall UTF-8-byte: 10 000 · Minst ett tegn som ikke er mellomrom, kreves: Ja
Reference to video · En skriftlig ledetekst og støttede bildereferanser. · Påkrevd: model, prompt, duration, input_references
input_references er en matrise med objekter. Sett type til image_url, og bruk det tilsvarende feltet som inneholder url. Bruk offentlig tilgjengelige HTTPS-adresser. Utelat frame_images for å velge referansemodus. Velg en støttet oppløsning og ved behov et sideforhold.
model: Type: string · alibaba/wan-3.0
prompt: Type: string · Maksimalt antall UTF-8-byte: 10 000 · Minst ett tegn som ikke er mellomrom, kreves: Ja
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt, duration |
Parametermaterial_types | Avtaletext, image |
Parameteradditional_properties | Avtalefalse |
Parameteroptional_controls | Avtaleresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
Livssyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsenhet | Faktureringsvilkår | Kostnad |
|---|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Faktureringsenhetper videosekund | Faktureringsvilkårresolution: 1080p | Kostnad Utdata · Videopris · Estimat kun for sammenligning $0.4 per videosekund |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Faktureringsenhetper videosekund | Faktureringsvilkårresolution: 480p | Kostnad Utdata · Videopris · Estimat kun for sammenligning $0.1 per videosekund |
| KonfigurasjonVideopris | Prisplan— | Forventet mengde— | Faktureringsenhetper videosekund | Faktureringsvilkårresolution: 720p | Kostnad Utdata · Videopris · Estimat kun for sammenligning $0.2 per videosekund |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsenhet— | Faktureringsvilkår— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.2 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Detaljer om referansetariffen
Referanseprisplaner på modellnivå endrer ikke metodevalg, prisoverslag eller kostnader. Aktive kostnader bruker satsene til den valgte Ailoot-metoden.
Prisreferanser for videokonfigurasjoner
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Faktureringsvilkår | Kostnad |
|---|---|---|
| KonfigurasjonVideopris | Faktureringsvilkårresolution: 480p | Kostnad Utdata · Videopris $0.1 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
| KonfigurasjonVideopris | Faktureringsvilkårresolution: 720p | Kostnad Utdata · Videopris $0.2 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
| KonfigurasjonVideopris | Faktureringsvilkårresolution: 1080p | Kostnad Utdata · Videopris $0.4 per videosekund Publisert prisreferanse for den viste konfigurasjonen. Endelige belastninger følger konfigurasjonen som faktisk faktureres. |
Eksempelforespørsler
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
Motta og lagre resultater
Ailoot Ultra · Video
Signerte innholdsadresser for ressurser du eier
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Kontroller jobbstatus
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
Andre innholdslesinger
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 ferdige resultater
Lagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Behold alle faktiske utdata du eier, og de returnerte målte metadataene.
Hvis det opprinnelige svaret må kontrolleres
503 result_pending_check + opprinnelig id + X-Should-Retry:false; gjenta aldri den opprinnelige sendingen
Svarfelter
| Felt | Type | Betydning |
|---|---|---|
Feltindex | Typeinteger | BetydningNullbasert posisjon for denne videoen i utdatalisten. |
Feltcontent_url | Typestring | BetydningSignert HTTPS-basert URL for nedlasting av denne ferdigstilte videoen. |
Feltsha256 | Typestring | null | BetydningSHA-256-kontrollsum for den opprinnelige videoens byte; null hvis utilgjengelig. |
Feltsize_bytes | Typeinteger | null | BetydningStørrelsen på den opprinnelige videofilen i byte; null hvis utilgjengelig. |
Feltduration_ms | Typeinteger | null | BetydningMålt videovarighet i millisekunder; null hvis utilgjengelig. |
Feltwidth | Typeinteger | null | BetydningVideobredde i piksler; null hvis utilgjengelig. |
Feltheight | Typeinteger | null | BetydningVideohøyde i piksler; null hvis utilgjengelig. |
Feltvideo_codec | Typestring | null | BetydningIdentifikator for videokodeken; null hvis ikke registrert. |
Felthas_audio | Typeboolean | null | BetydningOm videoen inneholder et lydspor; null hvis ikke målt. |
Feltaudio_codec | Typestring | null | BetydningIdentifikator for lydkodeken; null når ingen identifikator er registrert. |
Feil og neste trinn
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar404 · not_found_error | VilkårVideotilgang er utilgjengelig, eller denne video-ID-en ble ikke funnet. | Neste trinnKontroller videotilgangen. For en eksisterende video bruker du den opprinnelige offentlige ID-en og samme API-nøkkel. |
Svar401 · authentication_error | VilkårAPI-nøkkelen samsvarer ikke med den autentiserte kontoen. | Neste trinnKontroller API-nøkkelen din og kontotilgangen før innsending. |
Svar400 · invalid_request_error | VilkårForespørselen kunne ikke leses, eller nedlastingsindeksen er ugyldig. | Neste trinnKorriger forespørselskroppen. Ved nedlasting velger du en utdataindeks som ble returnert av den opprinnelige oppgaven. |
Svar422 · price_unavailable | VilkårDen valgte videokonfigurasjonen kan ikke prises. | Neste trinnVelg en støttet videokonfigurasjon og fyll ut de påkrevde alternativene før du sender en korrigert forespørsel. |
Svar422 · invalid_request_error | VilkårVideoinndata eller den opprinnelige fortsettelsesoppgaven er ugyldig. | Neste trinnBruk gyldige HTTPS-inndata. Ved fortsettelse bruker du den ferdigstilte originalens offentlige video-ID med samme API-nøkkel. |
Svar402 · billing_error | VilkårDen tilgjengelige saldoen eller grensene tillater ikke en reservasjon. | Neste trinnKontroller tilgjengelig saldo og grenser før du sender en ny forespørsel. |
Svar503 · server_error | VilkårVideokontroll, lagring eller tjenestetilgang er midlertidig utilgjengelig. | Neste trinnVent til tjenesten er tilgjengelig. Hvis du allerede har en video-ID, kontroller den opprinnelige oppgaven fremfor å opprette en ny generering. |
Svar503 · result_pending_check | VilkårDet opprinnelige videoresultatet og belastningen må kontrolleres. | Neste trinnBehold den returnerte video-ID-en og kontroller den oppgaven. Ikke send en erstatningsforespørsel om generering mens den kontrolleres. |
Svar503 · owned_result_unavailable | VilkårNedlasting av den eksisterende videoen er midlertidig utilgjengelig. | Neste trinnKontroller den samme videooppgaven senere og last ned de eksisterende utdataene. En ny generering oppretter en separat operasjon. |
Svar409 · video_not_ready | VilkårVideoinnholdet er ikke publisert. | Neste trinnKontroller den opprinnelige oppgavestatusen. Last ned etter at den rapporterer completed; hvis den rapporterer failed, følg varselet om kontroll av belastningen. |
Aliaser
Modellaliaser
Ailoot Ultra alibaba/wan-3.0
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · Alibaba: Wan 3.0
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos·alibaba/wan-3.0:text,image→video- Hvilke felt bruker forespørselen?
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 grenser gjelder?
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