Skip to main content
POST
cURL
Bruk aleph2 til å redigere en kildevideo med en Prompt i tekstform. Forespørselen returnerer en oppgave id; hent oppgavedetaljer for å få det ferdige resultatet.

Klargjør forespørselen

  • Autentiser med CometAPI API-nøkkelen din.
  • Sett model til aleph2, og oppgi videoUri for en video på opptil 30 sekunder.
  • Valgfritt: inkluder promptText for å beskrive redigeringen, med 1 til 1 000 tegn. Du kan også utelate den når du bruker nøkkelbilder.
  • Erstatt eksempel-URL-en for mediet med en tilgjengelig HTTPS-URL. Mediefeltene godtar også Base64-data-URI-er med en kodet størrelse på opptil 5 MB.

Legg til tidsbestemte veiledningsbilder

For å veilede bestemte øyeblikk kan du oppgi ett til fem objekter i keyframes. Hvert objekt inneholder et bilde via uri og nøyaktig én posisjon: Tidsstempelet for nøkkelbildet må ligge innenfor redigeringsvinduet. Hvis du bruker range, angir du det på hvert nøkkelbilde. Ellers utelater du range fra hvert nøkkelbilde. Utelat keyframes når du ikke trenger veiledningsbilder. En tom matrise eller null regnes som utelatelse.

Velg rammeform og format

Bruk targetAspectRatio for å be om utvidelse til 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, eller 21:9. Inndatavideoen og veiledningsbildene blir tilpasset med svarte kanter til denne formen før generering. Det utgåtte feltet ratio er valgfritt; bruk targetAspectRatio for å styre sideforholdet. Hvis outputFormat er prores, kan du sette proresProfile til 422, 4444, 422 Proxy, 422 LT, 422 HQ, eller 4444 XQ. Standardprofilen er 4444. Alfakanalen i 4444 og 4444 XQ er ugjennomsiktig. Utelat proresProfile for andre utdataformater. For et eksplisitt samplingfrø bruker du 1 til 4294967295. Utelat seed for et tilfeldig frø; 0 regnes som utelatelse.

Hent resultatet

Lagre den returnerte id, og bruk Hent en Runway-oppgave for å hente oppgavestatusen. Når status er SUCCEEDED, leser du resultat-URL-ene fra output. Hvis oppgaven mislykkes, undersøk failure og failureCode når de finnes.

Autorisasjoner

Authorization
string
header
påkrevd

Your CometAPI API key.

Kropp

application/json

Aleph 2 video-editing request.

model
enum<string>
påkrevd

Model ID for this request.

Tilgjengelige alternativer:
aleph2
videoUri
påkrevd

Input video to edit, with a maximum duration of 30 seconds. Use an accessible HTTPS URL or a Base64 data URI with an encoded size of up to 5 MB.

Required string length: 13 - 2048
Pattern: ^https://
promptText
string

Optional instruction describing the edit, from 1 to 1,000 characters. Can be omitted when using keyframes.

Required string length: 1 - 1000
keyframes
object[] | null

One to five timed guidance images. Each image uses exactly one of seconds or at. Omit when no guidance images are needed; an empty array or null is treated as omission.

Maximum array length: 5

Guidance image positioned using seconds.

targetAspectRatio
enum<string>

Target aspect ratio for expansion. The input video and keyframes are letterboxed to this shape before generation.

Tilgjengelige alternativer:
16:9,
4:3,
3:2,
1:1,
2:3,
3:4,
9:16,
21:9
ratio
string
utdatert

Deprecated aspect-ratio field. Use targetAspectRatio instead.

seed
integer

Sampling seed. Omit for a random seed; 0 is treated as omission.

Nødvendig område: 0 <= x <= 4294967295
outputFormat
enum<string>

Output format: mp4 for H.264 MP4, prores for ProRes MOV, png_sequence for a ZIP of PNG frames, or sdr_rec709_10bit for 10-bit Rec.709 HEVC MP4. Omit for mp4.

Tilgjengelige alternativer:
mp4,
prores,
png_sequence,
sdr_rec709_10bit
proresProfile
enum<string>

ProRes profile. Include only with outputFormat set to prores; omit for 4444. The 4444 and 4444 XQ profiles have an opaque alpha channel.

Tilgjengelige alternativer:
422,
4444,
422 Proxy,
422 LT,
422 HQ,
4444 XQ
contentModeration
object

Content moderation settings. Omit to use the standard settings.

Svar

The task was created. Save its id for task retrieval.

id
string
påkrevd

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

Sist endret 18. september 2026