Runway: Gen-4.5
Runway Gen-4.5 creëert video's op basis van een scènebeschrijving of een beeld met bewegingsaanwijzingen. Clips van 2–10 seconden, expliciete cameraprompts en afzonderlijke compositiekeuzes voor tekst-naar-video en beeld-naar-video ondersteunen filmische concepten, B-roll en geanimeerde visuele scènes.
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.
Runway Gen-4.5 is een videogeneratiemodel met tekst-naar-video- en beeld-naar-videomodi. Het kan een briefing volgen die scènecompositie, onderwerpactie, camerachoreografie en een reeks gebeurtenissen beschrijft. Het bruikbare resultaat is een kort gegenereerd shot dat kan worden gecontroleerd, bewaard of met ander beeldmateriaal samengevoegd.
De invoermodus voor het shot kiezen
Tekst-naar-video begint met een geschreven scènebeschrijving. Neem zowel de zichtbare inhoud als de beweging op: onderwerp, omgeving, belichting, kadrering, actie en cameragedrag. Deze modus is nuttig voor een nieuwe scène, B-roll, achtergrondbeeld of visueel concept waarbij het startframe geen aangeleverd beeld hoeft te reproduceren.
Beeld-naar-video begint met een beeld dat als eerste frame fungeert. Dat beeld levert compositie, onderwerp, belichting en stijl. Richt de geschreven prompt op wat daarna moet gebeuren: de actie van het onderwerp, beweging in de omgeving, camerabeweging en het verloop van het shot.
Bereid een duidelijk beeld voor waarin de belangrijke details al zichtbaar zijn. Onscherpe gezichten, handen of andere artefacten kunnen tijdens animatie opvallender worden. Een referentie die snelle beweging door stof of bewegingsonscherpte suggereert, kan ook botsen met een prompt die om een stilstaand onderwerp vraagt.
Beeld en beweging rechtstreeks beschrijven
Gebruik duidelijke natuurlijke taal en positieve beschrijvingen van het bedoelde resultaat. Een tekst-naar-videobriefing kan eerst het camerabeeld, onderwerp en de actie benoemen en daarna de scènebehandeling toevoegen. Een gedetailleerde beschrijving is nuttig wanneer het shot vastgelegde eisen heeft; een eenvoudigere beschrijving laat meer ruimte voor verkenning. Er is geen ideaal aantal woorden dat duidelijkheid vervangt.
Beschrijf bijvoorbeeld een dichtbijaanzicht van een messing bureaulamp waarvan het licht aangaat, gevolgd door een langzame camerabeweging die een notitieboek ernaast onthult. Benoem voor tekst-naar-video de zichtbare materialen en het licht. Als een aangeleverd beeld die details al vastlegt, kan de beeld-naar-videoprompt zich op de lichtverandering en camera-onthulling richten.
Vermijd tegenstrijdige aanwijzingen. Een vast camerabeeld met subtiele onderwerpbeweging is anders dan een energiek, uit de hand gefilmd volgshot. Voeg de details toe die het bruikbare shot bepalen, in plaats van een lange lijst losstaande visuele stijlen.
Cameratermen en geordende actie
De cameragids van de maker onderscheidt kadrering, hoeken, beweging en focus. Een close-up verandert wat het frame vult, een lage hoek verandert het perspectief, een pan draait de kijkrichting van de camera en een trackingbeweging volgt een onderwerp. Een rack-focus-instructie verplaatst de scherpte tussen zichtbare onderwerpen. Geef aan wat in beeld moet zijn of moet worden onthuld terwijl de beweging zich ontwikkelt.
Opeenvolgende prompts kunnen gebeurtenissen in gewone taal of met globale tijdsaanduidingen uitdrukken. Die tijdsaanduidingen sturen volgorde en timing bij benadering; ze garanderen geen frame-exacte uitvoering. Geef de gevraagde acties voldoende tijd om natuurlijk binnen de gekozen cliplengte plaats te vinden.
Beschrijf voor een statisch shot de beweging die binnen het frame hoort en benadruk de bedoelde stilstaande camera. De maker merkt op dat volledig bewegingloze aanzichten lastig kunnen zijn, vooral bij sommige ruime of overzichtsshots. Controleer kleine ongewenste bewegingen in het daadwerkelijke resultaat in plaats van aan te nemen dat een formulering voor een statische camera ze onmogelijk maakt.
Duur, afmetingen en framefrequentie
Gen-4.5 ondersteunt cliplengtes van 2 tot 10 seconden. Een langere keuze kan meerdere geordende acties bevatten, terwijl een korte reactie of onthulling een korter shot kan gebruiken. De gedocumenteerde uitvoer is 720p, met 24 of 25 frames per seconde in de generatieworkflow van de maker.
De tekst-naar-videospecificatie vermeldt 16:9 op 1280 × 720 pixels. Beeld-naar-video vermeldt daarnaast 9:16 op 720 × 1280, 1:1 op 960 × 960, 4:3 op 1104 × 832, 3:4 op 832 × 1104 en 21:9 op 1584 × 672. Houd de modus en concrete afmetingen bij elkaar in plaats van aan te nemen dat beide invoermodi dezelfde set beeldverhoudingen bieden.
De beeldverhouding van een beeld kan de standaardcompositie vastleggen en een wijziging kan de invoer bijsnijden. Controleer de plaatsing van het onderwerp voordat u de beweging beoordeelt: een juiste actie is niet bruikbaar als een belangrijk deel van het bronbeeld is weggesneden.
Een langere reeks uit voltooide shots opbouwen
Voor beeldgestuurd werk beschrijft de maker het voortzetten van een reeks door het laatste frame van een voltooide clip als beeldinvoer voor een volgende generatie te gebruiken. De clips worden daarna in een video-editor gecombineerd, waarbij het gedeelde frame en de timing in de montage worden afgehandeld. Dit is een reeks afzonderlijke shots en geen enkele generatie met onbeperkte duur.
Bewaar het eindframe en de bijbehorende briefing zodat het volgende shot vanuit de bedoelde visuele toestand begint. Controleer continuïteit in het samengevoegde beeldmateriaal, inclusief onderwerpuiterlijk, camerarichting en de overgang tussen clips.
Het productieresultaat bewaren en beoordelen
Controleer na de generatie de volledige clip en bewaar de voltooide uitvoer. De workflow van de producent biedt ook afzonderlijke keuzes voor opschaling en productie-export, zoals ProRes of een PNG-reeks. Dat zijn aanvullende workflowopties; de native generatieafmetingen blijven gescheiden van een later opgeschaald resultaat.
Gebruik Gen-4.5 voor filmische concepten, geanimeerde visuele ideeën, B-roll en het uitwerken van korte scènes. Bewaar de prompt, het invoerbeeld wanneer gebruikt, duur, modus en teruggegeven clip samen. Controleer actievolgorde, cameragedrag, onderwerpdetails, ongewenste cuts en de bedoelde kadrering en voer daarna een gerichte correctie van het shot uit.
Ailoot Ultra · Video POST /v1/videos runway/gen-4.5
runway/gen-4.5Aan de slag
Runway Gen-4.5 creëert video's op basis van een scènebeschrijving of een beeld met bewegingsaanwijzingen. Clips van 2–10 seconden, expliciete cameraprompts en afzonderlijke compositiekeuzes voor tekst-naar-video en beeld-naar-video ondersteunen filmische concepten, B-roll en geanimeerde visuele scènes.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Video
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Video POST /v1/videos
- Invoer
text,image- Uitvoer
video- Uitvoerformaat
- oorspronkelijke MP4-bytes; geen normalisatie of transcodering
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten runway/gen-4.5 | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldduration | Typeinteger | VereisteVereist | Waarden en limieten 2, 3, 4, 5, 6, 7, 8, 9, 10 Minimum: 1 Maximum: 600 | Standaard— |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 720p | Standaard— |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 16:9, 9:16 | Standaard— |
Veldgenerate_audio | Typeboolean | VereisteOptioneel | Waarden en limieten false | Standaard— |
Veldframe_images | Typearray | VereisteOptioneel | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 1 Invoerinhoud: Array met frameobjecten. Elk object bevat type=image_url, image_url met daarin url, en frame_type. Gebruik een HTTPS-afbeeldings-URL en stel frame_type in op first_frame. Elke framerol komt hoogstens één keer voor. Exacte sleutels: type, image_url, frame_type Voorwaarden: Deze sleutels beschrijven elk frameobject; image_url bevat alleen url. Laat frame_images weg bij een aanvraag met uitsluitend tekst. | Standaard— |
Veldinput_references | Typearray | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten 1280x720, 720x1280 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 prompt op als tekst en duration als een geheel aantal seconden. Kies een ondersteunde resolutie; voeg een beeldverhouding toe of gebruik een vermelde grootte.
model: Type: string · runway/gen-4.5
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 afbeelding voor het eerste frame. · Vereist: model, prompt, duration, frame_images
frame_images is een array. Elk frameobject bevat type, image_url en frame_type; image_url bevat url. Stel type in op image_url. Gebruik first_frame. Elke framerol komt hoogstens één keer voor. Geef voor elk frame een openbare HTTPS-afbeeldings-URL op. Kies een ondersteunde resolutie; voeg een beeldverhouding toe of gebruik een vermelde grootte.
Exacte sleutels: type, image_url, frame_type
model: Type: string · runway/gen-4.5
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 |
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 getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen 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 geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor 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 |
| ConfiguratieVideoprijs | Tariefstaffel— | Verwachte hoeveelheid— | Rekeneenheidper videoseconde | FactureringsvoorwaardenIn deze prijssleutel is geen bijkomende voorwaarde opgegeven. | Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.24 per videoseconde |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Rekeneenheid— | Factureringsvoorwaarden— | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.48 schatting vóór generatie Deze raming is geen extra kost 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
| Configuratie | Factureringsvoorwaarden | Kosten |
|---|---|---|
| ConfiguratieVideoprijs | FactureringsvoorwaardenIn deze prijssleutel is geen bijkomende voorwaarde opgegeven. | Kosten Uitvoer · Videoprijs $0.24 per videoseconde Gepubliceerde prijsreferentie voor de getoonde configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie. |
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('{"aspect_ratio":"16:9","duration":8,"model":"runway/gen-4.5","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
Resultaten ophalen en opslaan
Ailoot Ultra · Video
ondertekende inhouds-URL's die je toebehoren
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 werkelijke uitvoer die je toebehoort en de teruggestuurde meetgegevens.
Als het oorspronkelijke antwoord moet worden gecontroleerd
503 result_pending_check + oorspronkelijke id + X-Should-Retry:false; voer de oorspronkelijke aanvraag nooit opnieuw uit
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-hash van de oorspronkelijke videobytes; null als die niet beschikbaar is. |
Veldsize_bytes | Typeinteger | null | BetekenisGrootte van het oorspronkelijke videobestand in bytes; null als die niet beschikbaar is. |
Veldduration_ms | Typeinteger | null | BetekenisGemeten videoduur in milliseconden; null als die niet beschikbaar is. |
Veldwidth | Typeinteger | null | BetekenisVideobreedte in pixels; null als die niet beschikbaar is. |
Veldheight | Typeinteger | null | BetekenisVideohoogte in pixels; null als die niet beschikbaar is. |
Veldvideo_codec | Typestring | null | BetekenisIdentificatiecode van de videocodec; null als die niet is vastgelegd. |
Veldhas_audio | Typeboolean | null | BetekenisOf de video een audiotrack bevat; null als dit niet is gemeten. |
Veldaudio_codec | Typestring | null | BetekenisIdentificatiecode van de audiocodec; null als er geen identificatiecode is vastgelegd. |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord404 · not_found_error | VoorwaardeToegang tot de video is niet beschikbaar, of deze video-ID werd niet gevonden. | Volgende stapControleer de toegang tot de video. 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 je API-sleutel en accounttoegang voordat je de aanvraag indient. |
Antwoord400 · invalid_request_error | VoorwaardeDe aanvraag kon niet worden gelezen, of de downloadindex is ongeldig. | Volgende stapCorrigeer de aanvraaginhoud. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is teruggestuurd. |
Antwoord422 · price_unavailable | VoorwaardeVoor de geselecteerde videoconfiguratie kan geen prijs worden bepaald. | Volgende stapKies een ondersteunde videoconfiguratie en vul alle verplichte opties in voordat je een gecorrigeerde aanvraag indient. |
Antwoord422 · invalid_request_error | VoorwaardeEen video-invoer of oorspronkelijke vervolgtaak is ongeldig. | Volgende stapGebruik geldige HTTPS-invoer. Gebruik voor een vervolg je voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel. |
Antwoord402 · billing_error | VoorwaardeHet beschikbare saldo of de limieten laten geen reservering toe. | Volgende stapControleer je beschikbare saldo en limieten voordat je een nieuwe aanvraag verstuurt. |
Antwoord503 · server_error | VoorwaardeVideocontrole, opslag of toegang tot de dienst is tijdelijk niet beschikbaar. | Volgende stapWacht tot de dienst beschikbaar is. Als je al een video-ID hebt, controleer dan die oorspronkelijke taak in plaats van een nieuwe generatie aan te maken. |
Antwoord503 · result_pending_check | VoorwaardeHet oorspronkelijke videoresultaat en de aanrekening moeten worden gecontroleerd. | Volgende stapBewaar de teruggestuurde video-ID en controleer die taak. Verstuur geen vervangende generatieaanvraag zolang de controle loopt. |
Antwoord503 · owned_result_unavailable | VoorwaardeDe bestaande videodownload is tijdelijk niet beschikbaar. | Volgende stapControleer later dezelfde videotaak en download de bestaande uitvoer ervan. Een nieuwe generatie maakt een afzonderlijke operatie aan. |
Antwoord409 · video_not_ready | VoorwaardeDe video-inhoud is niet gepubliceerd. | Volgende stapControleer de oorspronkelijke taakstatus. Download zodra de status completed is; volg bij failed de melding over de controle van de aanrekening. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra runway/gen-4.5
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · Runway: Gen-4.5
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/videos·runway/gen-4.5:text,image→video- Welke velden gebruikt het verzoek?
POST /v1/videos·runway/gen-4.5: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·runway/gen-4.5:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807