Alibaba: Wan 3.0
Alibaba Wan 3.0 skapar video med ljud från en prompt, första eller första/sista bildruta och multimodala referenser. Tillverkarprofilen kombinerar storyboardarbete, källbaserad redigering och fortsättning i en modell, med MP4-utdata på 2–30 sekunder, 30 bilder per sekund och upplösningen 480p, 720p eller 1080p.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
Alibaba Wan 3.0 är en samlad profil för videoskapande, utformad för att göra en instruktion och stödmaterial till en scen med ljud. Tillverkaren identifierar standardmodellen som wan3.0-video. Generering med enbart text, öppnings- och slutbilder, multimodala referenser, redigering och fortsättning använder olika indataupplägg inom profilen. Användbara leveranser omfattar en kort berättelse, en produktpresentation, en bildbaserad övergång eller ett bearbetat källklipp vars ändringar följer en specifik kreativ inriktning.
För en scen med enbart text förbereder du motiv, plats, handling, kamera, visuell stil och ljud. Tillverkaren stöder enskilda tagningar och storyboard med flera tagningar, med en rekommenderad struktur på ungefär fyra till sex sekunder per tagning och valfria tidsintervall. En kort berättelse kan introducera en liten mekanisk fågel på en arbetsbänk, följa dess första rörelse och avsluta med en kvarhållen närbild medan rummets atmosfärljud fortsätter. Beskriv den visuella relationen mellan dessa moment så att möjligheten till trettio sekunder tjänar en sammanhängande berättelse i stället för en lista med fristående handlingar.
Generering från första bildrutan animerar en inskickad stillbild. Stillbilden definierar den inledande kompositionen, medan prompten förklarar rörelse och kameraarbete. Generering från första/sista bildruta förankrar även slutet och beskriver övergången mellan de två bilderna. Förbered ändpunkter med förenlig scen och avsett bildutsnitt. Guiden rekommenderar adaptivt val av bildförhållande för dessa lägen. Deras bildruteindata hålls åtskilda från uppläggen för referensbilder, referensvideo, referensljud, filer och webblänkar, så välj det materialläge som passar den planerade tagningen.
Referensläget kombinerar upp till tio bilder, fem videoklipp och fem ljudklipp, inom en total gräns på tjugo material. Bildreferenser kan identifiera en karaktär, ett föremål, en miljö eller en stil; video kan styra rörelse eller kameraarbete och ljud kan styra framförande eller rytm. Typspecifika etiketter som Image 1, Video 1 och Audio 1 följer indataordningen var för sig. Ge varje referens en roll och beskriv hur den ska samverka med de andra. En karaktär som ser rätt ut i fel miljö är ett annat fel än en kamera som missar den avsedda rörelsen.
De dokumenterade filgränserna för referenser är 20 MB per bild, 100 MB per video och 15 MB per ljudklipp. Referensvideor är tillsammans begränsade till femton sekunder, och ljudreferenser har en separat sammanlagd gräns på femton sekunder. Ett dokument eller en referens till en offentlig webbsida kan åtfölja referensmaterial; dokument och länk utesluter varandra. Källan måste vara offentligt åtkomlig utan inloggning. Förbered en fokuserad källa och ange vilket innehåll som ska ligga till grund för klippet, särskilt när ett dokument innehåller mer information än scenen kan använda.
Inbyggt ljud kombinerar dialog, bakgrundsmusik, atmosfär och ljudeffekter med den genererade bilden. Ange orden som ska sägas, talaren och framförandet, viktiga effekter och om bakgrundsmusik ska finnas. Ljud är aktiverat som standard i tillverkarens guide och kan inaktiveras. I en demonstrationsscen kan en kort inledande replik föregå en produktdetalj medan ett tyst mekaniskt ljud markerar rörelsen. Lyssna på det färdiga klippet för faktisk ordalydelse, talartilldelning och synkronisering i stället för att bedöma ljudet enbart utifrån den skrivna instruktionen.
För en redigering beskriver du ändringen och innehållet som ska bevaras. Guiden omfattar att lägga till eller ta bort element, ersätta egenskaper, ändra visuell stil eller ljus och bearbeta dialog. För en fortsättning beskriver du vad som ska hända före, efter eller runt det befintliga klippet. Adaptiva bildutsnitt och smart längd hjälper källvideoflödet att bevara dess form och avsedda tajmning. När videoindata skickas in får den dokumenterade sammanlagda längden på in- och utdatavideo inte överstiga 30 sekunder. Behåll originalkällan och granska både det ändrade området och kontinuiteten genom hela klippet.
Utdata är MP4 med 30 bilder per sekund och upplösningen 480p, 720p eller 1080p. Nygenererade klipp är två till trettio sekunder långa, eller så kan en inställning för smart längd låta modellen välja längden. Liggande, kvadratiska och stående format dokumenteras, med adaptivt bildutsnitt lämpat för inskickat material. Tillverkaren bearbetar förfrågan som ett jobb och returnerar en plats för den färdiga videon som gäller i tjugofyra timmar. Behåll det faktiska resultatet, instruktionen och referenserna som produktionsunderlag och kontrollera returnerad längd och bildutsnitt innan du ordnar det med andra klipp.
Vanliga Wan 3.0 och varianten Prime delar de dokumenterade samlade lägena; Prime betonar genereringshastighet. Wan 2.7 och 2.6 har separata uppgiftsspecifika regler för längd och referenser, så deras gränssnitt ska inte behandlas som denna utgåvas konfiguration. Granska den färdiga scenen för karaktärs- och produktidentitet, rumslig kontinuitet, tal, effekter, källbaserade detaljer samt avsedd början och avslutning. En specifik nästa korrigering bevarar den lyckade inriktningen samtidigt som den hanterar den faktiska bristen i klippet.
Ailoot Ultra · Video POST /v1/videos alibaba/wan-3.0
alibaba/wan-3.0Start
Alibaba Wan 3.0 skapar video med ljud från en prompt, första eller första/sista bildruta och multimodala referenser. Tillverkarprofilen kombinerar storyboardarbete, källbaserad redigering och fortsättning i en modell, med MP4-utdata på 2–30 sekunder, 30 bilder per sekund och upplösningen 480p, 720p eller 1080p.
- Godkända indata
- Text · Bilder
- Resultat
- Video
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Video POST /v1/videos
- Indatatyper
text,image- Utdatatyper
video- Utdataformat
- ursprungliga MP4-byte; ingen normalisering/omkodning
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser alibaba/wan-3.0 | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser | Standard— |
Fältduration | Typinteger | KravObligatoriskt | Värden & 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 Maximum: 600 | Standard— |
Fältresolution | Typstring | KravValfritt | Värden & gränser 480p, 720p, 1080p | Standard— |
Fältaspect_ratio | Typstring | KravValfritt | Värden & gränser 16:9, 4:3, 1:1, 3:4, 9:16 | Standard— |
Fältgenerate_audio | Typboolean | KravValfritt | Värden & gränser false, true | Standard— |
Fältframe_images | Typarray | KravValfritt | Värden & gränser Minsta antal objekt: 1 Maximalt antal objekt: 1 Indatainnehåll: Array med bildruteobjekt. Varje objekt har type=image_url, image_url som innehåller url samt frame_type. Använd en HTTPS URL till en bild och sätt frame_type till first_frame. Varje bildruteroll förekommer högst en gång. Exakta nycklar: type, image_url, frame_type Villkor: Dessa nycklar beskriver varje bildruteobjekt; image_url innehåller endast url. Utelämna frame_images för en begäran med enbart text. | Standard— |
Fältinput_references | Typarray | KravValfritt | Värden & gränser | Standard— |
Fältseed | Typinteger | KravValfritt | Värden & gränser Minimum: −9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Standard— |
Fältcallback_url | Typstring | KravValfritt | Värden & gränser Mönster: ^https:// | Standard— |
Fältsession_id | Typstring | KravValfritt | Värden & gränser | Standard— |
Fälttrace | Typobject | KravValfritt | Värden & gränser | Standard— |
Fältuser | Typstring | KravValfritt | Värden & gränser | Standard— |
Kombinationer av indatamaterial
Text till video · En skriven prompt. · Krävs: model, prompt, duration
Ange prompt som text och längd i hela sekunder. Välj en upplösning som stöds och vid behov ett bildförhållande.
model: Typ: string · alibaba/wan-3.0
prompt: Typ: string · Maximalt antal UTF-8-byte: 10 000 · Minst ett tecken som inte är blanksteg krävs: Ja
Bild till video · En skriven prompt och en bild för den första bildrutan. · Krävs: model, prompt, duration, frame_images
frame_images är en array. Varje bildruteobjekt har type, image_url och frame_type; image_url innehåller url. Sätt type till image_url. Använd first_frame. Varje bildruteroll förekommer högst en gång. Ange en offentlig HTTPS URL till en bild för varje bildruta. Välj en upplösning som stöds och vid behov ett bildförhållande.
Exakta nycklar: type, image_url, frame_type
model: Typ: string · alibaba/wan-3.0
prompt: Typ: string · Maximalt antal UTF-8-byte: 10 000 · Minst ett tecken som inte är blanksteg krävs: Ja
Reference to video · En skriven prompt och bildreferenser som stöds. · Krävs: model, prompt, duration, input_references
input_references är en array med objekt. Sätt type till image_url och använd motsvarande fält som innehåller url. Använd offentliga HTTPS-länkar. Utelämna frame_images för att välja referensläge. Välj en upplösning som stöds och vid behov ett bildförhållande.
model: Typ: string · alibaba/wan-3.0
prompt: Typ: string · Maximalt antal UTF-8-byte: 10 000 · Minst ett tecken som inte är blanksteg krävs: Ja
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt, duration |
Parametermaterial_types | Avtaltext, image |
Parameteradditional_properties | Avtalfalse |
Parameteroptional_controls | Avtalresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
Livscykel: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Debiteringsenhet | Debiteringsvillkor | Avgift |
|---|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Debiteringsenhet— | Debiteringsvillkor— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationVideopris | Prislista— | Prognostiserad mängd— | Debiteringsenhetper videosekund | Debiteringsvillkorresolution: 1080p | Avgift Utdata · Videopris · Uppskattning endast för jämförelse $0.4 per videosekund |
| KonfigurationVideopris | Prislista— | Prognostiserad mängd— | Debiteringsenhetper videosekund | Debiteringsvillkorresolution: 480p | Avgift Utdata · Videopris · Uppskattning endast för jämförelse $0.1 per videosekund |
| KonfigurationVideopris | Prislista— | Prognostiserad mängd— | Debiteringsenhetper videosekund | Debiteringsvillkorresolution: 720p | Avgift Utdata · Videopris · Uppskattning endast för jämförelse $0.2 per videosekund |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Debiteringsenhet— | Debiteringsvillkor— | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.2 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Detaljer om referenstariffen
Referensprislistor på modellnivå ändrar inte metodval, prisuppgifter eller avgifter. Aktiva avgifter använder priserna för den valda Ailoot-metoden.
Prisreferenser för videokonfigurationer
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Debiteringsvillkor | Avgift |
|---|---|---|
| KonfigurationVideopris | Debiteringsvillkorresolution: 480p | Avgift Utdata · Videopris $0.1 per videosekund Publicerad prisreferens för den visade konfigurationen. Den slutliga debiteringen följer den konfiguration som faktiskt debiterades. |
| KonfigurationVideopris | Debiteringsvillkorresolution: 720p | Avgift Utdata · Videopris $0.2 per videosekund Publicerad prisreferens för den visade konfigurationen. Den slutliga debiteringen följer den konfiguration som faktiskt debiterades. |
| KonfigurationVideopris | Debiteringsvillkorresolution: 1080p | Avgift Utdata · Videopris $0.4 per videosekund Publicerad prisreferens för den visade konfigurationen. Den slutliga debiteringen följer den konfiguration som faktiskt debiterades. |
Exempelbegäranden
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
Ta emot och spara resultat
Ailoot Ultra · Video
signerade innehållslänkar som du äger
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Kontrollera 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
Andra innehållsläsningar
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
Behåll alla färdiga resultat
Spara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Behåll varje faktiskt resultat som du äger och dess returnerade, uppmätta metadata.
Om det ursprungliga svaret behöver kontrolleras
503 result_pending_check + ursprungligt id + X-Should-Retry:false; upprepa aldrig originalet
Svarsfält
| Fält | Typ | Betydelse |
|---|---|---|
Fältindex | Typinteger | BetydelseNollbaserad position för denna video i utdatalistan. |
Fältcontent_url | Typstring | BetydelseSignerad HTTPS URL för hämtning av denna färdiga video. |
Fältsha256 | Typstring | null | BetydelseSHA-256-kontrollsumma för den ursprungliga videons byte; null om den inte är tillgänglig. |
Fältsize_bytes | Typinteger | null | BetydelseStorleken på den ursprungliga videofilen i byte; null om den inte är tillgänglig. |
Fältduration_ms | Typinteger | null | BetydelseUppmätt videolängd i millisekunder; null om den inte är tillgänglig. |
Fältwidth | Typinteger | null | BetydelseVideobredd i pixlar; null om den inte är tillgänglig. |
Fältheight | Typinteger | null | BetydelseVideohöjd i pixlar; null om den inte är tillgänglig. |
Fältvideo_codec | Typstring | null | BetydelseIdentifierare för videokodek; null om ingen har registrerats. |
Fälthas_audio | Typboolean | null | BetydelseOm videon innehåller ett ljudspår; null om detta inte har mätts. |
Fältaudio_codec | Typstring | null | BetydelseIdentifierare för ljudkodek; null när ingen identifierare har registrerats. |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar404 · not_found_error | VillkorVideoåtkomst är inte tillgänglig eller detta video-ID hittades inte. | Nästa stegKontrollera videoåtkomst. För en befintlig video använder du dess ursprungliga offentliga ID och samma API-nyckel. |
Svar401 · authentication_error | VillkorAPI-nyckeln motsvarar inte det autentiserade kontot. | Nästa stegKontrollera din API-nyckel och kontoåtkomst innan du skickar in. |
Svar400 · invalid_request_error | VillkorBegäran kunde inte läsas eller hämtningsindexet är ogiltigt. | Nästa stegKorrigera begäranskroppen. Vid hämtning väljer du ett utdataindex som returnerats av den ursprungliga uppgiften. |
Svar422 · price_unavailable | VillkorDen valda videokonfigurationen kan inte prissättas. | Nästa stegVälj en videokonfiguration som stöds och fyll i dess obligatoriska alternativ innan du skickar en korrigerad begäran. |
Svar422 · invalid_request_error | VillkorVideoindata eller den ursprungliga fortsättningsuppgiften är ogiltig. | Nästa stegAnvänd giltiga HTTPS-indata. För fortsättning använder du det färdiga originalets offentliga video-ID med samma API-nyckel. |
Svar402 · billing_error | VillkorDet tillgängliga saldot eller gränserna medger ingen reservation. | Nästa stegKontrollera ditt tillgängliga saldo och dina gränser innan du skickar en ny begäran. |
Svar503 · server_error | VillkorVideoverifiering, lagring eller tjänsteåtkomst är tillfälligt otillgänglig. | Nästa stegVänta tills tjänsten är tillgänglig. Om du redan har ett video-ID kontrollerar du den ursprungliga uppgiften i stället för att skapa en ny generering. |
Svar503 · result_pending_check | VillkorDet ursprungliga videoresultatet och debiteringen behöver kontrolleras. | Nästa stegBehåll det returnerade video-ID:t och kontrollera den uppgiften. Skicka ingen ersättande genereringsbegäran medan den kontrolleras. |
Svar503 · owned_result_unavailable | VillkorHämtningen av den befintliga videon är tillfälligt otillgänglig. | Nästa stegKontrollera samma videouppgift senare och hämta dess befintliga resultat. En ny generering skapar en separat operation. |
Svar409 · video_not_ready | VillkorVideoinnehållet har inte publicerats. | Nästa stegKontrollera den ursprungliga uppgiftens status. Hämta när den rapporterar completed; om den rapporterar failed följer du dess meddelande om debiteringskontroll. |
Alias
Modellalias
Ailoot Ultra alibaba/wan-3.0
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · Alibaba: Wan 3.0
- Vilka indata och resultat finns?
POST /v1/videos·alibaba/wan-3.0:text,image→video- Vilka fält använder begäran?
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- Vilka gränser gäller?
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