Použijte Runway Aleph přes Rivya Public API v1 s model id runway-aleph, podporovanými vstupy, parametry, pravidly Files API, kredity a příklady odpovědí.

Dostupné přes APIPřipravenostVideo

ID API modelu

runway-aleph

Vstupy

file

Files API

Vyžadováno pro referenční režimy

Základní kredity

per_video · default=90 · ⌈total⌉

Schopnost

Video

Fakturace

FIXED

Limit promptu

5000 znaků

Kontrakt požadavku

Model id posílejte na horní úrovni. Model-specific controls patří do params.

Klíč	Typ	Povinné	Výchozí	Popis
model	string	Ano	runway-aleph	Použijte API model id runway-aleph.
prompt	string	Ano	-	Maximum 5000 znaků pro tento model.
params	object	Ne	-	Objekt parametrů specifických pro model. Povolené klíče najdete v řádcích níže.
client_request_id	string	Ne	-	Volitelné client-side id pro trasování požadavků ve vašem systému.

Parametry modelu

Klíč	Typ	Povinné	Výchozí	Rozsah	Možnosti	Popis
aspectRatio	select	Ne	16:9	-	16:9, 9:16, 4:3, 3:4, 1:1, 21:9	Poměr stran
waterMark	text	Ne	-	-	-	Vodoznak
seed	number	Ne	-	-	-	Nechte prázdné, pokud chcete pokaždé nový náhodný výsledek. Opakované použití stejného celého čísla usnadňuje zopakování nebo doladění předchozího výsledku. Výsledek se přiblíží jen tehdy, když prompt i další klíčová nastavení zůstanou podobné, a nejde o zaručenou shodu 1:1.

Pravidla nahrávání

Nejprve nahrajte referenční soubory a potom vložte vrácenou URL a duration token do params.referenceMediaItems.

Pravidlo reference

Vstupní média: Nahrajte zdrojový klip, který má Aleph transformovat. Jeden volitelný statický obrázek přidejte jen tehdy, když potřebujete další vedení stylu nebo objektu.

Max. souborů

Přijímané typy souborů

video, image

Token délky trvání

Video a audio reference by měly nést durationToken z /api/v1/files, když je vyžadováno ověření délky.

kind	Max. velikost	MIME typy
video	95 MB	video/mp4, video/quicktime
image	10 MB	image/jpeg, image/png, image/webp

Minimální požadavek

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "Ponechte prázdné, pokud chcete vodoznak vypnout",
    "seed": 1
  }
}

Požadavek s referenčním souborem

{
  "model": "runway-aleph",
  "params": {
    "aspectRatio": "16:9",
    "waterMark": "Ponechte prázdné, pokud chcete vodoznak vypnout",
    "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"
      }
    ]
  }
}

Odpověď vytvoření

Create endpoint vrátí public task id. Pollujte status endpoint, dokud úloha neuspěje nebo neselže.

{
  "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
}

Běžné chyby

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Některé režimy vyžadují referenční nahrání přes Files API.

API integrace Runway Aleph