Bruk Runway Aleph via Rivya Public API v1 med modell-ID runway-aleph, støttede inndata, parametere, Files API-regler, kreditter og svareksempler.

Tilgjengelig via APIKlarstatusVideo

API-modell-ID

runway-aleph

Inndata

file

Files API

Kreves for referansemoduser

Basiskreditter

per_video · default=90 · ⌈total⌉

Egenskap

Video

Fakturering

FIXED

Promptgrense

5000 tegn

Forespørselskontrakt

Send modell-ID-en på toppnivå. Modellspesifikke kontroller hører hjemme i params.

Nøkkel	Type	Påkrevd	Standard	Beskrivelse
model	string	Ja	runway-aleph	Bruk API-modell-ID-en runway-aleph.
prompt	string	Ja	-	Maksimalt 5000 tegn for denne modellen.
params	object	Nei	-	Modellspesifikt parameterobjekt. Bruk radene nedenfor for tillatte nøkler.
client_request_id	string	Nei	-	Valgfri klient-ID for sporing av forespørsler i systemet ditt.

Modellparametere

Nøkkel	Type	Påkrevd	Standard	Område	Alternativer	Beskrivelse
aspectRatio	select	Nei	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9	Sideforhold
waterMark	text	Nei	-	-	-	Vannmerke
seed	number	Nei	-	-	-	La det stå tomt for et nytt tilfeldig resultat hver gang. Å bruke samme heltall på nytt gjør det enklere å gjenskape eller finjustere et tidligere resultat. Resultatet blir bare mer likt når prompten og andre viktige innstillinger også er omtrent de samme, og det er ikke en garantert 1:1-match.

Opplastingspolicy

Last opp referansefiler først, og plasser deretter returnert URL og varighetstoken i params.referenceMediaItems.

Referanseregel

Inndatamedier: Last opp kildeklippet du vil at Aleph skal transformere. Legg bare til ett valgfritt stillbilde når du trenger ekstra veiledning for stil eller motiv.

Maks antall filer

Godtatte filtyper

video, image

Varighetstoken

Video- og lydreferanser bør ha durationToken fra /api/v1/files når varighetsverifisering kreves.

kind	Maks størrelse	MIME-typer
video	95 MB	video/mp4, video/quicktime
image	10 MB	image/jpeg, image/png, image/webp

Minimal forespørsel

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "La stå tomt for å deaktivere vannmerke",
    "seed": 1
  }
}

Referansefilforespørsel

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "La stå tomt for å deaktivere vannmerke",
    "seed": 1,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api"
      }
    ]
  }
}

Opprettelsessvar

Opprettingsendepunktet returnerer en offentlig oppgave-ID. Hent status fra statusendepunktet til oppgaven lykkes eller mislykkes.

{
  "id": "task_runway_aleph_example",
  "status": "queued",
  "model": "runway-aleph",
  "reserved_credits": 90,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Vanlige feil

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Noen moduser krever referanseopplastinger via Files API.

Runway Aleph API-integrasjon