> ## 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. # إنشاء مهمة Runway لتحويل صورة إلى فيديو > استخدم CometAPI لاستدعاء Runway image_to_video وتحويل رابط صورة ثابتة إلى إخراج فيديو خام، مع دعم X-Runway-Version للتوافق. استخدم نقطة النهاية هذه لتحريك صورة مصدر واحدة إلى فيديو من Runway. ## قبل استدعائها * أرسل ترويسة `X-Runway-Version` المطلوبة، على سبيل المثال `2024-11-06` * استخدم `model: gen3a_turbo` * وفّر `promptImage` ثابتًا عبر HTTPS * ابدأ بـ `duration: 5` وقيمة ratio مدعومة للنموذج/الإصدار المحدد من Runway ## Duration و ratio | الإعداد | القيم المدعومة | نقطة البداية الافتراضية | سلوك الحدود | | ----------------------------------------- | ---------------------------------------------------------------------------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------- | | `duration` | يعتمد على نموذج/إصدار Runway؛ استخدم `5` أو `10` لأوسع توافق | `5` | يقوم CometAPI بتمرير القيمة إلى Runway. إذا رفضها النموذج/الإصدار المحدد، فأعد المحاولة باستخدام `5`. | | `ratio` مع `X-Runway-Version: 2024-11-06` | قيم بنمط الدقة تعتمد على نموذج/إصدار Runway مثل `1280:768` أو `768:1280` أو `1280:720` أو `720:1280` | `1280:768` | قد تتم مواءمة قيم الطلب في الوسائط المكتملة؛ افحص الفيديو النهائي قبل الاعتماد على عدد بكسلات مطابق تمامًا. | | `ratio` مع إصدارات التوافق الأقدم | `16:9` أو `9:16` أو القيم بنمط الدقة المقبولة من النموذج/الإصدار المحدد | `16:9` أو `1280:768` | فضّل قيم Runway الحالية بنمط الدقة لعمليات التكامل في بيئات الإنتاج. | تستخدم الطلبات ذات التنسيق الرسمي في Runway الحقل `ratio` وليس `size`. اقرأ قيم ratio بنمط الدقة على أنها مكافئ `WxH` لها: تستهدف `1280:720` الدقة `1280x720`، وتستهدف `720:1280` الدقة `720x1280`، ويمكن أن يتم عرض `1280:768` أيضًا على شكل `1280x720` بحسب النموذج/الإصدار المحدد. ## تدفق المهمة أنشئ المهمة باستخدام صورة مصدر و Prompt حركة قصير اختياري. احفظ `id` الخاص بالمهمة لاستخدامه لاحقًا في polling. استخدم [الحصول على مهمة Runway](./runway-to-get-task-details). إذا أعاد أول polling القيمة `task_not_exist`، فانتظر بضع ثوانٍ ثم أعد المحاولة. ## OpenAPI ````yaml api/openapi/video/runway/official-format/post-runway-images-raw-video.openapi.json POST /runwayml/v1/image_to_video openapi: 3.1.0 info: title: Image to Video API version: 1.0.0 description: >- Create a Runway image-to-video task through the official-format CometAPI route. servers: - url: https://api.cometapi.com security: - bearerAuth: [] paths: /runwayml/v1/image_to_video: post: summary: Create a Runway image-to-video task description: >- Submit a source image plus optional motion prompt and receive a task id for later polling. operationId: runway_images_raw_video parameters: - name: X-Runway-Version in: header required: true description: Runway version header, for example `2024-11-06`. schema: type: string requestBody: required: true content: application/json: schema: type: object required: - promptImage - model properties: promptImage: type: string description: Source image URL. default: >- https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg seed: type: integer description: 'Random seed for reproducible results. Range: 0–999999999.' model: type: string description: >- Runway image-to-video model ID. Choose an available model from the [Models page](/overview/models). default: gen3a_turbo promptText: type: string description: >- Text prompt describing the desired motion or scene. Maximum 512 characters. watermark: type: boolean description: Whether to add a watermark to the output video. default: false duration: type: integer description: >- Video duration in seconds. Runway support is model/version dependent; use 5 or 10 for the broadest compatibility. CometAPI forwards this value to Runway. default: 5 ratio: type: string description: >- Requested output ratio. Accepted values are Runway model/version dependent. With X-Runway-Version 2024-11-06, use a resolution-style value accepted by the selected model, such as 1280:768, 768:1280, 1280:720, or 720:1280. Read these as WxH targets, but completed media may normalize, so inspect the returned file before relying on exact pixels. default: '1280:768' default: promptImage: >- https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg seed: 1 model: gen3a_turbo promptText: A calm camera move. watermark: false duration: 5 ratio: '1280:768' examples: Default: summary: Default value: promptImage: >- https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg seed: 1 model: gen3a_turbo promptText: A calm camera move. watermark: false duration: 5 ratio: '1280:768' responses: '200': description: Task accepted. content: application/json: schema: type: object required: - id properties: id: type: string example: id: d0658ae1-bbdd-4adc-aaba-fd8070e14d79 x-codeSamples: - lang: Shell label: Default source: | curl https://api.cometapi.com/runwayml/v1/image_to_video \ -H "Authorization: Bearer $COMETAPI_KEY" \ -H "Content-Type: application/json" \ -d '{ "promptImage": "https://your-image-host/first-frame.png", "promptText": "A calm camera move.", "model": "gen3a_turbo", "ratio": "1280:768", "duration": 5 }' - lang: Python label: Default source: > import os import requests response = requests.post( "https://api.cometapi.com/runwayml/v1/image_to_video", headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}, json={ "promptImage": "https://your-image-host/first-frame.png", "promptText": "A calm camera move.", "model": "gen3a_turbo", "ratio": "1280:768", "duration": 5 }, ) 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/image_to_video", { method: "POST", headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "promptImage": "https://your-image-host/first-frame.png", "promptText": "A calm camera move.", "model": "gen3a_turbo", "ratio": "1280:768", "duration": 5 }), }); 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. ````