Opprett en Runway-oppgave for video-til-video
Rediger en video med Runway Aleph 2 via CometAPI ved hjelp av en Prompt i tekstform, tidsbestemte veiledningsbilder og et valgfritt målsideforhold.
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
modeltilaleph2, og oppgivideoUrifor en video på opptil 30 sekunder. - Valgfritt: inkluder
promptTextfor å 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 ikeyframes.
Hvert objekt inneholder et bilde via uri og nøyaktig én posisjon:
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
BruktargetAspectRatio 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.
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 returnerteid, 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
Your CometAPI API key.
Kropp
Aleph 2 video-editing request.
Model ID for this request.
aleph2 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.
13 - 2048^https://Optional instruction describing the edit, from 1 to 1,000 characters. Can be omitted when using keyframes.
1 - 1000One 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.
5Guidance image positioned using seconds.
- Option 1
- Option 2
Target aspect ratio for expansion. The input video and keyframes are letterboxed to this shape before generation.
16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 21:9 Deprecated aspect-ratio field. Use targetAspectRatio instead.
Sampling seed. Omit for a random seed; 0 is treated as omission.
0 <= x <= 4294967295Output 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.
mp4, prores, png_sequence, sdr_rec709_10bit ProRes profile. Include only with outputFormat set to prores; omit for 4444. The 4444 and 4444 XQ profiles have an opaque alpha channel.
422, 4444, 422 Proxy, 422 LT, 422 HQ, 4444 XQ Content moderation settings. Omit to use the standard settings.
Svar
The task was created. Save its id for task retrieval.
Task ID for GET /runwayml/v1/tasks/{id}.
Task state, when returned.
Task submission timestamp, when returned.
Result URLs, when returned.
Failure explanation, when returned.
Machine-readable failure code, when returned.
Task estimate metadata, when returned.
Task cost metadata, when returned.