> ## Documentation Index > Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Eine Runway-Video-zu-Video-Aufgabe erstellen > Verwenden Sie CometAPI Runway POST /runwayml/v1/video_to_video, um Video-zu-Video-Generierungsaufgaben zu starten, X-Runway-Version festzulegen und Quellclips zu transformieren. Verwenden Sie diesen Endpunkt, um einen vorhandenen Quellclip mit Runways Video-zu-Video-Workflow zu transformieren. Er startet eine asynchrone Aufgabe, anstatt die endgültige Ausgabe sofort zurückzugeben. ## Bevor Sie ihn aufrufen * Bereiten Sie ein Quellvideo vor, das den Eingabeanforderungen des Anbieters entspricht * Fügen Sie den erforderlichen Header `X-Runway-Version` für den gewünschten Funktionsumfang hinzu * Beginnen Sie mit einem kurzen Prompt, der die Änderung beschreibt, nicht mit einem vollständigen Storyboard ## Ausgabeverhältnis | Setting | Unterstützte Werte | Standard-Ausgangspunkt | Verhalten an den Grenzen | | ------- | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------------------------- | | `ratio` | `1280:720`, `720:1280` oder ein anderes Verhältnis, das vom ausgewählten Runway-Modell bzw. der ausgewählten Version akzeptiert wird | `1280:720` | Stimmen Sie das Verhältnis nach Möglichkeit auf die Ausrichtung des Quellclips ab. | Dieser Endpunkt erwartet durch Doppelpunkte getrennte `ratio`-Werte. Verwenden Sie `1280:720` für eine Ausgabe in `1280x720` und `720:1280` für `720x1280`; `1280x720` wird nicht auf jeder Runway-Video-zu-Video-Route akzeptiert. ## Aufgabenablauf Starten Sie die Aufgabe über diesen Endpunkt und speichern Sie die zurückgegebene task id. Verwenden Sie [Eine Runway-Aufgabe abrufen](./runway-to-get-task-details), bis die Aufgabe einen terminalen Zustand erreicht. Laden Sie das fertige Asset herunter oder speichern Sie es über Ihre normale Medienpipeline. ## OpenAPI ````yaml api/openapi/video/runway/official-format/post-generate-a-video-from-a-video.openapi.json POST /runwayml/v1/video_to_video openapi: 3.1.0 info: title: Generate a video from a video API version: 1.0.0 servers: - url: https://api.cometapi.com security: - bearerAuth: [] paths: /runwayml/v1/video_to_video: post: summary: Generate a video from a video operationId: generate_a_video_from_a_video parameters: - name: X-Runway-Version in: header required: true description: Runway API version header, for example `2024-11-06`. schema: type: string requestBody: required: true content: application/json: schema: type: object required: - videoUri - promptText - seed - model - references - ratio - contentModeration properties: videoUri: type: string description: >- HTTPS URL of the source video, or a base64 data URI containing the video. default: https://your-video-host/source.mp4 promptText: type: string description: >- Text prompt describing the desired output. Maximum 1000 characters. default: A cat yawning in slow motion. seed: type: integer description: 'Random seed for reproducible results. Range: 0–4294967295.' default: 1 model: type: string description: Model variant to use. default: gen4_aleph references: type: array description: >- Optional reference images to guide generation. Each item must include `type` (e.g. `image`) and `uri` (HTTPS URL). items: type: object properties: type: type: string uri: type: string default: - {} ratio: type: string description: >- Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator. default: '1280:720' contentModeration: type: object required: - publicFigureThreshold properties: publicFigureThreshold: type: string description: >- Threshold for public-figure detection. Use `auto` for default behavior. default: publicFigureThreshold: auto default: videoUri: https://media.w3.org/2010/05/sintel/trailer.mp4 promptText: Make the motion feel cinematic. model: gen4_aleph references: - type: image uri: https://res.cloudinary.com/demo/image/upload/dog.jpg ratio: '1280:720' examples: Default: summary: Default value: videoUri: https://media.w3.org/2010/05/sintel/trailer.mp4 promptText: Make the motion feel cinematic. model: gen4_aleph references: - type: image uri: https://res.cloudinary.com/demo/image/upload/dog.jpg ratio: '1280:720' responses: '200': description: success content: application/json: schema: type: object required: - id properties: id: type: string description: >- The ID of the task that was created. Use this to retrieve the task later. example: id: 12a01a5e-ab55-4aa7-b002-7b873546cf76 x-codeSamples: - lang: Shell label: Default source: | curl https://api.cometapi.com/runwayml/v1/video_to_video \ -H "Authorization: Bearer $COMETAPI_KEY" \ -H "Content-Type: application/json" \ -d '{ "videoUri": "https://your-video-host/source.mp4", "promptText": "Make the motion feel cinematic.", "model": "gen4_aleph", "references": [ { "type": "image", "uri": "https://your-image-host/style.jpg" } ] }' - lang: Python label: Default source: > import os import requests response = requests.post( "https://api.cometapi.com/runwayml/v1/video_to_video", headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}, json={ "videoUri": "https://your-video-host/source.mp4", "promptText": "Make the motion feel cinematic.", "model": "gen4_aleph", "references": [ { "type": "image", "uri": "https://your-image-host/style.jpg" } ] }, ) task = response.json() print(task["id"]) # poll GET /runwayml/v1/tasks/{id} until the output array appears - lang: JavaScript label: Default source: > const response = await fetch("https://api.cometapi.com/runwayml/v1/video_to_video", { method: "POST", headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "videoUri": "https://your-video-host/source.mp4", "promptText": "Make the motion feel cinematic.", "model": "gen4_aleph", "references": [ { "type": "image", "uri": "https://your-image-host/style.jpg" } ] }), }); const task = await response.json(); console.log(task.id); // poll GET /runwayml/v1/tasks/{id} until the output array appears components: securitySchemes: bearerAuth: type: http scheme: bearer description: Bearer token authentication. Use your CometAPI key. ````