{"servers":[{"url":"https://api.modellix.ai/api/v1/google/gemini-omni-1.2-flash-v2v"}],"post":{"description":"Prompt-driven video editing for restyling scenes, changing lighting, and revising visual details in existing footage. Optional image references guide the transformation while the output follows the source clip's duration and aspect ratio.","operationId":"geminiOmni12FlashV2VAsync","requestBody":{"content":{"application/json":{"examples":{"basic":{"summary":"Basic","value":{"prompt":"Change the scene to a snowy winter night","video":"https://example.com/source.mp4"}},"with_references":{"summary":"With references","value":{"prompt":"Apply the visual style shown in the reference image while preserving the motion","referenceImages":["https://example.com/style.jpg"],"resolution":"1080p","video":"https://example.com/source.mp4"}}},"schema":{"additionalProperties":false,"description":"Edit a source video while retaining its length and aspect ratio.","properties":{"prompt":{"description":"Describe the scene, motion, or edit to produce.","minLength":1,"type":"string"},"referenceImages":{"description":"Optional visual references for the edit or continuation.","items":{"description":"Publicly reachable HTTP(S) URL of a reference image.","format":"uri","minLength":1,"pattern":"^https?://","type":"string"},"maxItems":2,"minItems":1,"type":"array"},"resolution":{"default":"720p","description":"Output resolution.","enum":["360p","720p","1080p","4k"],"type":"string"},"seed":{"description":"Optional generation seed. Omit it to leave seed selection to the model.","type":"integer"},"video":{"description":"Publicly reachable HTTP(S) URL of the source video. Its aspect ratio is retained. Source length must be 3 to 15 seconds.","format":"uri","minLength":1,"pattern":"^https?://","type":"string"}},"required":["prompt","video"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"code":0,"data":{"get_result":{"method":"GET","url":"https://api.modellix.ai/api/v1/tasks/task-omni12-v2v-001"},"model_id":"google/gemini-omni-1.2-flash-v2v","status":"pending","task_id":"task-omni12-v2v-001"},"message":"success"},"schema":{"properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Detailed data about the submitted asynchronous task.","properties":{"get_result":{"description":"API information to query the task result","properties":{"method":{"description":"HTTP method","example":"GET","type":"string"},"url":{"description":"Full URL to query the task result","example":"https://api.modellix.ai/api/v1/tasks/task-abc123","type":"string"}},"type":"object"},"model_id":{"description":"Model ID in `provider/model` format","example":"google/gemini-omni-flash-video-edit","type":"string"},"status":{"description":"Task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier for polling","example":"task-abc123","type":"string"}},"required":["status","task_id","model_id"],"type":"object"},"message":{"description":"Response message","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Task submitted successfully"},"400":{"content":{"application/json":{"example":{"code":400,"message":"Invalid parameters: parameter 'prompt' is required"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Invalid request parameters"},"401":{"content":{"application/json":{"example":{"code":401,"message":"Authentication failed: invalid API key"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Unauthorized - Invalid or missing API Key"},"429":{"content":{"application/json":{"example":{"code":429,"message":"Rate limit exceeded: 100 requests per minute, retry after 60 seconds"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Too many requests - Rate limit exceeded","headers":{"X-RateLimit-Limit":{"description":"Maximum requests per minute","schema":{"example":100,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining quota in current window","schema":{"example":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Rate limit window reset time (Unix timestamp)","schema":{"example":1704067260,"type":"integer"}}}},"500":{"content":{"application/json":{"example":{"code":500,"message":"Internal server error"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Internal server error"}},"summary":"Gemini Omni 1.2 Flash V2V","x-mint":{"href":"google/gemini-omni-1-2-flash-v2v"}}}