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 close-up 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 stilstaande beelden lastig kunnen zijn, vooral bij sommige totaal- 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
- Invoertypen
text,image- Uitvoertypen
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 maximaal eenmaal voor. Exacte sleutels: type, image_url, frame_type Voorwaarden: Deze sleutels beschrijven elk frameobject; image_url bevat uitsluitend url. Laat frame_images weg voor een verzoek 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 als tekst en duration in hele seconden op. 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 maximaal eenmaal 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 weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn 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 is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij 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 aanvullende voorwaarde vastgelegd. | 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 schatting is geen extra bedrag 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 aanvullende voorwaarde vastgelegd. | Kosten Uitvoer · Videoprijs $0.24 per videoseconde Gepubliceerde prijsreferentie voor de weergegeven 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-URLs die u bezit
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 daadwerkelijke uitvoer die u bezit en de geretourneerde gemeten metadata.
Als het oorspronkelijke antwoord moet worden gecontroleerd
503 result_pending_check + oorspronkelijke id + X-Should-Retry:false; herhaal het oorspronkelijke verzoek nooit
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-digest van de oorspronkelijke videobytes; null indien niet beschikbaar. |
Veldsize_bytes | Typeinteger | null | BetekenisGrootte van het oorspronkelijke videobestand in bytes; null indien niet beschikbaar. |
Veldduration_ms | Typeinteger | null | BetekenisGemeten videoduur in milliseconden; null indien niet beschikbaar. |
Veldwidth | Typeinteger | null | BetekenisVideobreedte in pixels; null indien niet beschikbaar. |
Veldheight | Typeinteger | null | BetekenisVideohoogte in pixels; null indien niet beschikbaar. |
Veldvideo_codec | Typestring | null | BetekenisVideocodec-identificatie; null indien niet vastgelegd. |
Veldhas_audio | Typeboolean | null | BetekenisOf de video een audiotrack bevat; null indien niet gemeten. |
Veldaudio_codec | Typestring | null | BetekenisAudiocodec-identificatie; null wanneer geen identificatie is vastgelegd. |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord404 · not_found_error | VoorwaardeVideotoegang is niet beschikbaar of deze video-ID is niet gevonden. | Volgende stapControleer videotoegang. 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 uw API-sleutel en accounttoegang voordat u indient. |
Antwoord400 · invalid_request_error | VoorwaardeHet verzoek kon niet worden gelezen of de downloadindex is ongeldig. | Volgende stapCorrigeer de verzoekbody. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is geretourneerd. |
Antwoord422 · price_unavailable | VoorwaardeDe geselecteerde videoconfiguratie kan niet worden geprijsd. | Volgende stapKies een ondersteunde videoconfiguratie en vul de vereiste opties in voordat u een gecorrigeerd verzoek indient. |
Antwoord422 · invalid_request_error | VoorwaardeEen videoinvoer of oorspronkelijke vervolgtaak is ongeldig. | Volgende stapGebruik geldige HTTPS-invoer. Gebruik voor een vervolg uw voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel. |
Antwoord402 · billing_error | VoorwaardeHet beschikbare saldo of de limieten staan geen reservering toe. | Volgende stapControleer uw beschikbare saldo en limieten voordat u een nieuw verzoek verstuurt. |
Antwoord503 · server_error | VoorwaardeVideoverificatie, opslag of servicetoegang is tijdelijk niet beschikbaar. | Volgende stapWacht tot de service beschikbaar is. Als u al een video-ID hebt, controleert u die oorspronkelijke taak in plaats van een nieuwe generatie aan te maken. |
Antwoord503 · result_pending_check | VoorwaardeHet oorspronkelijke videoresultaat en de kosten moeten worden gecontroleerd. | Volgende stapBewaar de geretourneerde video-ID en controleer die taak. Verstuur geen vervangend generatieverzoek terwijl deze wordt gecontroleerd. |
Antwoord503 · owned_result_unavailable | VoorwaardeDe bestaande videodownload is tijdelijk niet beschikbaar. | Volgende stapControleer dezelfde videotaak later en download de bestaande uitvoer. Een nieuwe generatie maakt een afzonderlijke operatie aan. |
Antwoord409 · video_not_ready | VoorwaardeDe video-inhoud is niet gepubliceerd. | Volgende stapControleer de oorspronkelijke taakstatus. Download nadat deze completed meldt; als deze failed meldt, volgt u de melding over kostencontrole. |
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