@runware/schemas 0.0.0-20260510231619

package/dist/schemas/requests/models/pixverse/pixverse-v4.json

@@ -0,0 +1,1040 @@
+{
+  "$schema": "https://json-schema.org/draft/2019-09/schema",
+  "type": "object",
+  "properties": {
+    "model": {
+      "title": "Model",
+      "description": "Identifier of the model to use for generation.",
+      "type": "string",
+      "const": "pixverse:1@2"
+    },
+    "inputs": {
+      "title": "Inputs",
+      "description": "The unified payload wrapper for complex media assets dictating image, video or audio inference constraints.",
+      "type": "object",
+      "properties": {
+        "frameImages": {
+          "title": "Frame Images",
+          "description": "List of frame-specific image inputs. Each item can be either a plain image input (UUID, URL, Data URI, or Base64) or an object with an image and a target frame position.",
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "anyOf": [
+              {
+                "title": "Image",
+                "description": "Image input (UUID, URL, Data URI, or Base64).",
+                "type": "string",
+                "anyOf": [
+                  {
+                    "format": "uuid"
+                  },
+                  {
+                    "format": "uri"
+                  },
+                  {
+                    "pattern": "^data:image\\/[a-zA-Z]+;base64,[a-zA-Z0-9+/=]+$"
+                  },
+                  {
+                    "pattern": "^[a-zA-Z0-9+/=]+$"
+                  }
+                ]
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "image": {
+                    "title": "Image",
+                    "description": "Image input (UUID, URL, Data URI, or Base64).",
+                    "type": "string",
+                    "anyOf": [
+                      {
+                        "format": "uuid"
+                      },
+                      {
+                        "format": "uri"
+                      },
+                      {
+                        "pattern": "^data:image\\/[a-zA-Z]+;base64,[a-zA-Z0-9+/=]+$"
+                      },
+                      {
+                        "pattern": "^[a-zA-Z0-9+/=]+$"
+                      }
+                    ]
+                  },
+                  "frame": {
+                    "title": "Frame",
+                    "description": "Target frame position for the image. Supports first and last frame.",
+                    "oneOf": [
+                      {
+                        "const": "first",
+                        "description": "First frame of the video."
+                      },
+                      {
+                        "const": "last",
+                        "description": "Last frame of the video."
+                      },
+                      {
+                        "const": 0,
+                        "description": "Frame index 0 (first frame)."
+                      },
+                      {
+                        "const": -1,
+                        "description": "Frame index -1 (last frame)."
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "image"
+                ],
+                "additionalProperties": false
+              }
+            ]
+          },
+          "maxItems": 2
+        }
+      },
+      "additionalProperties": false
+    },
+    "positivePrompt": {
+      "title": "Positive Prompt",
+      "description": "Text prompt describing elements to include in the generated output.",
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 2048
+    },
+    "negativePrompt": {
+      "title": "Negative Prompt",
+      "description": "Prompt to guide what to exclude from generation. Ignored when guidance is disabled (CFGScale ≤ 1).",
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 2048
+    },
+    "width": {
+      "title": "Width",
+      "description": "Width of the generated media in pixels.",
+      "type": "integer"
+    },
+    "height": {
+      "title": "Height",
+      "description": "Height of the generated media in pixels.",
+      "type": "integer"
+    },
+    "resolution": {
+      "title": "Resolution",
+      "description": "Resolution preset for the output. When used with input media, automatically matches the aspect ratio from the input.",
+      "type": "string",
+      "enum": [
+        "360p",
+        "540p",
+        "720p",
+        "1080p"
+      ],
+      "default": "720p"
+    },
+    "duration": {
+      "title": "Duration",
+      "description": "Length of the generated video in seconds. The total number of frames produced is determined by duration multiplied by the model's frame rate (fps).",
+      "type": "number",
+      "enum": [
+        5,
+        8
+      ]
+    },
+    "seed": {
+      "title": "Seed",
+      "description": "Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.",
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 2147483647
+    },
+    "providerSettings": {
+      "title": "Provider Settings",
+      "description": "Provider-specific configuration settings.",
+      "type": "object",
+      "properties": {
+        "pixverse": {
+          "title": "Pixverse Settings",
+          "description": "Provider-specific settings for PixVerse.",
+          "type": "object",
+          "properties": {
+            "cameraMovement": {
+              "title": "Camera Movement",
+              "description": "Cinematic camera movement.",
+              "type": "string",
+              "oneOf": [
+                {
+                  "const": "horizontal_left",
+                  "description": "Horizontal pan to the left."
+                },
+                {
+                  "const": "horizontal_right",
+                  "description": "Horizontal pan to the right."
+                },
+                {
+                  "const": "vertical_up",
+                  "description": "Upward vertical movement."
+                },
+                {
+                  "const": "vertical_down",
+                  "description": "Downward vertical movement."
+                },
+                {
+                  "const": "zoom_in",
+                  "description": "Gradual zoom into the subject."
+                },
+                {
+                  "const": "zoom_out",
+                  "description": "Gradual zoom away from the subject."
+                },
+                {
+                  "const": "auto_camera",
+                  "description": "Automatic camera movement based on scene content."
+                },
+                {
+                  "const": "crane_up",
+                  "description": "Upward crane shot movement."
+                },
+                {
+                  "const": "quickly_zoom_in",
+                  "description": "Fast zoom into the subject."
+                },
+                {
+                  "const": "quickly_zoom_out",
+                  "description": "Fast zoom away from the subject."
+                },
+                {
+                  "const": "smooth_zoom_in",
+                  "description": "Gentle, smooth zoom into the subject."
+                },
+                {
+                  "const": "camera_rotation",
+                  "description": "Rotating camera movement around the axis."
+                },
+                {
+                  "const": "robo_arm",
+                  "description": "Mechanical, precise camera movement."
+                },
+                {
+                  "const": "super_dolly_out",
+                  "description": "Dramatic outward dolly movement."
+                },
+                {
+                  "const": "whip_pan",
+                  "description": "Quick, dynamic pan movement."
+                },
+                {
+                  "const": "hitchcock",
+                  "description": "Classic Hitchcock-style dolly zoom effect."
+                },
+                {
+                  "const": "left_follow",
+                  "description": "Camera follows subject moving left."
+                },
+                {
+                  "const": "right_follow",
+                  "description": "Camera follows subject moving right."
+                },
+                {
+                  "const": "pan_left",
+                  "description": "Horizontal pan to the left."
+                },
+                {
+                  "const": "pan_right",
+                  "description": "Horizontal pan to the right."
+                },
+                {
+                  "const": "fix_bg",
+                  "description": "Fixed background with foreground movement."
+                }
+              ]
+            },
+            "effect": {
+              "title": "Effect",
+              "description": "Visual effect template.",
+              "type": "string",
+              "oneOf": [
+                {
+                  "const": "bikini up",
+                  "description": "Body transformation effect."
+                },
+                {
+                  "const": "the tigers touch",
+                  "description": "Animal-themed transformation."
+                },
+                {
+                  "const": "jiggle jiggle",
+                  "description": "Rhythmic movement effect."
+                },
+                {
+                  "const": "hug your love",
+                  "description": "Romantic interaction template."
+                },
+                {
+                  "const": "kiss me ai",
+                  "description": "Kiss interaction effect."
+                },
+                {
+                  "const": "subject 3 fever",
+                  "description": "Energetic movement template."
+                },
+                {
+                  "const": "fin-tastic mermaid",
+                  "description": "Mermaid transformation."
+                },
+                {
+                  "const": "lets ymca",
+                  "description": "Dance movement template."
+                },
+                {
+                  "const": "skeleton dance",
+                  "description": "Spooky dance effect."
+                },
+                {
+                  "const": "kungfu club",
+                  "description": "Martial arts action template."
+                },
+                {
+                  "const": "boom drop",
+                  "description": "Explosive impact effect."
+                },
+                {
+                  "const": "vroom vroom step",
+                  "description": "Vehicle-themed movement."
+                },
+                {
+                  "const": "creepy devil smile",
+                  "description": "Horror-themed facial effect."
+                },
+                {
+                  "const": "pubg winner hit",
+                  "description": "Gaming victory celebration."
+                },
+                {
+                  "const": "360 microwave",
+                  "description": "Spinning rotation effect."
+                },
+                {
+                  "const": "eye zoom challenge",
+                  "description": "Close-up eye effect."
+                },
+                {
+                  "const": "muscle surge",
+                  "description": "Body enhancement effect."
+                },
+                {
+                  "const": "punch face",
+                  "description": "Impact reaction template."
+                },
+                {
+                  "const": "balloon belly",
+                  "description": "Body inflation effect."
+                },
+                {
+                  "const": "kiss kiss",
+                  "description": "Multiple kiss interaction."
+                }
+              ]
+            },
+            "motionMode": {
+              "title": "Motion Mode",
+              "description": "Motion intensity in the generated video.",
+              "type": "string",
+              "oneOf": [
+                {
+                  "const": "normal",
+                  "description": "Standard motion intensity and pacing."
+                },
+                {
+                  "const": "fast",
+                  "description": "Increased motion speed."
+                }
+              ],
+              "default": "normal"
+            },
+            "style": {
+              "title": "Style",
+              "description": "Artistic style aesthetic for video generation.",
+              "type": "string",
+              "oneOf": [
+                {
+                  "const": "anime",
+                  "description": "Japanese animation aesthetic."
+                },
+                {
+                  "const": "3d_animation",
+                  "description": "Three-dimensional animated style with depth."
+                },
+                {
+                  "const": "clay",
+                  "description": "Stop-motion clay animation appearance."
+                },
+                {
+                  "const": "comic",
+                  "description": "Comic book or graphic novel visual style."
+                },
+                {
+                  "const": "cyberpunk",
+                  "description": "Futuristic, neon-lit dystopian aesthetic."
+                }
+              ]
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "taskType": {
+      "title": "Task Type",
+      "description": "Identifier for the type of task being performed",
+      "type": "string",
+      "const": "videoInference"
+    },
+    "taskUUID": {
+      "title": "Task UUID",
+      "description": "UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.",
+      "type": "string",
+      "format": "uuid"
+    },
+    "webhookURL": {
+      "title": "Webhook URL",
+      "description": "Specifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.",
+      "type": "string",
+      "format": "uri"
+    },
+    "includeCost": {
+      "title": "Include Cost",
+      "description": "Include task cost in the response.",
+      "type": "boolean",
+      "default": false
+    },
+    "numberResults": {
+      "title": "Number of Results",
+      "description": "Number of results to generate. Each result uses a different seed, producing variations of the same parameters.",
+      "type": "integer",
+      "minimum": 1,
+      "default": 1,
+      "maximum": 4
+    },
+    "uploadEndpoint": {
+      "title": "Upload Endpoint",
+      "description": "URL to upload content via HTTP PUT. The request body will contain the raw binary data.",
+      "type": "string",
+      "format": "uri"
+    },
+    "ttl": {
+      "title": "TTL",
+      "description": "Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.",
+      "type": "integer",
+      "minimum": 60
+    },
+    "outputType": {
+      "title": "Output Type",
+      "description": "Video output type.",
+      "type": "string",
+      "enum": [
+        "URL"
+      ],
+      "default": "URL"
+    },
+    "outputFormat": {
+      "title": "Output Format",
+      "description": "File format for the generated video.",
+      "type": "string",
+      "enum": [
+        "MP4",
+        "WEBM",
+        "MOV"
+      ],
+      "default": "MP4"
+    },
+    "outputQuality": {
+      "title": "Output Quality",
+      "description": "Compression quality of the output. Higher values preserve quality but increase file size.",
+      "type": "integer",
+      "minimum": 20,
+      "maximum": 99,
+      "default": 95
+    },
+    "deliveryMethod": {
+      "title": "Delivery Method",
+      "description": "Determines how the API delivers task results.",
+      "type": "string",
+      "oneOf": [
+        {
+          "const": "async",
+          "description": "Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse. Required for long-running tasks like video generation."
+        }
+      ],
+      "default": "async"
+    },
+    "safety": {
+      "type": "object",
+      "title": "Safety Settings",
+      "description": "Content safety checking configuration for video generation.",
+      "properties": {
+        "checkContent": {
+          "title": "Check Content",
+          "description": "Enable or disable content safety checking. When enabled, defaults to `fast` mode.",
+          "type": "boolean",
+          "default": false
+        },
+        "mode": {
+          "description": "Safety checking mode for video generation.",
+          "type": "string",
+          "oneOf": [
+            {
+              "const": "none",
+              "title": "None",
+              "description": "Disables checking."
+            },
+            {
+              "const": "fast",
+              "title": "Fast",
+              "description": "Checks key frames."
+            },
+            {
+              "const": "full",
+              "title": "Full",
+              "description": "Checks all frames."
+            }
+          ],
+          "default": "none"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": [
+    "positivePrompt",
+    "taskType",
+    "taskUUID",
+    "model"
+  ],
+  "allOf": [
+    {
+      "dependentRequired": {
+        "width": [
+          "height"
+        ],
+        "height": [
+          "width"
+        ]
+      }
+    },
+    {
+      "oneOf": [
+        {
+          "title": "360p (16:9)",
+          "properties": {
+            "width": {
+              "const": 640
+            },
+            "height": {
+              "const": 360
+            }
+          }
+        },
+        {
+          "title": "360p (4:3)",
+          "properties": {
+            "width": {
+              "const": 480
+            },
+            "height": {
+              "const": 360
+            }
+          }
+        },
+        {
+          "title": "360p (1:1)",
+          "properties": {
+            "width": {
+              "const": 360
+            },
+            "height": {
+              "const": 360
+            }
+          }
+        },
+        {
+          "title": "360p (3:4)",
+          "properties": {
+            "width": {
+              "const": 360
+            },
+            "height": {
+              "const": 480
+            }
+          }
+        },
+        {
+          "title": "360p (9:16)",
+          "properties": {
+            "width": {
+              "const": 360
+            },
+            "height": {
+              "const": 640
+            }
+          }
+        },
+        {
+          "title": "540p (16:9)",
+          "properties": {
+            "width": {
+              "const": 960
+            },
+            "height": {
+              "const": 540
+            }
+          }
+        },
+        {
+          "title": "540p (4:3)",
+          "properties": {
+            "width": {
+              "const": 720
+            },
+            "height": {
+              "const": 540
+            }
+          }
+        },
+        {
+          "title": "540p (1:1)",
+          "properties": {
+            "width": {
+              "const": 540
+            },
+            "height": {
+              "const": 540
+            }
+          }
+        },
+        {
+          "title": "540p (3:4)",
+          "properties": {
+            "width": {
+              "const": 540
+            },
+            "height": {
+              "const": 720
+            }
+          }
+        },
+        {
+          "title": "540p (9:16)",
+          "properties": {
+            "width": {
+              "const": 540
+            },
+            "height": {
+              "const": 960
+            }
+          }
+        },
+        {
+          "title": "720p (16:9)",
+          "properties": {
+            "width": {
+              "const": 1280
+            },
+            "height": {
+              "const": 720
+            }
+          }
+        },
+        {
+          "title": "720p (4:3)",
+          "properties": {
+            "width": {
+              "const": 960
+            },
+            "height": {
+              "const": 720
+            }
+          }
+        },
+        {
+          "title": "720p (1:1)",
+          "properties": {
+            "width": {
+              "const": 720
+            },
+            "height": {
+              "const": 720
+            }
+          }
+        },
+        {
+          "title": "720p (3:4)",
+          "properties": {
+            "width": {
+              "const": 720
+            },
+            "height": {
+              "const": 960
+            }
+          }
+        },
+        {
+          "title": "720p (9:16)",
+          "properties": {
+            "width": {
+              "const": 720
+            },
+            "height": {
+              "const": 1280
+            }
+          }
+        },
+        {
+          "title": "1080p (16:9)",
+          "properties": {
+            "width": {
+              "const": 1920
+            },
+            "height": {
+              "const": 1080
+            }
+          }
+        },
+        {
+          "title": "1080p (4:3)",
+          "properties": {
+            "width": {
+              "const": 1440
+            },
+            "height": {
+              "const": 1080
+            }
+          }
+        },
+        {
+          "title": "1080p (1:1)",
+          "properties": {
+            "width": {
+              "const": 1080
+            },
+            "height": {
+              "const": 1080
+            }
+          }
+        },
+        {
+          "title": "1080p (3:4)",
+          "properties": {
+            "width": {
+              "const": 1080
+            },
+            "height": {
+              "const": 1440
+            }
+          }
+        },
+        {
+          "title": "1080p (9:16)",
+          "properties": {
+            "width": {
+              "const": 1080
+            },
+            "height": {
+              "const": 1920
+            }
+          }
+        }
+      ]
+    },
+    {
+      "if": {
+        "properties": {
+          "inputs": {
+            "properties": {
+              "frameImages": {
+                "minItems": 1
+              }
+            },
+            "required": [
+              "frameImages"
+            ]
+          }
+        },
+        "required": [
+          "inputs"
+        ]
+      },
+      "then": {
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "width"
+              ]
+            },
+            {
+              "required": [
+                "height"
+              ]
+            }
+          ]
+        }
+      },
+      "else": {
+        "required": [
+          "width",
+          "height"
+        ]
+      }
+    },
+    {
+      "not": {
+        "allOf": [
+          {
+            "required": [
+              "resolution"
+            ]
+          },
+          {
+            "anyOf": [
+              {
+                "required": [
+                  "width"
+                ]
+              },
+              {
+                "required": [
+                  "height"
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "not": {
+        "allOf": [
+          {
+            "properties": {
+              "providerSettings": {
+                "properties": {
+                  "pixverse": {
+                    "required": [
+                      "cameraMovement"
+                    ]
+                  }
+                }
+              }
+            },
+            "required": [
+              "providerSettings"
+            ]
+          },
+          {
+            "properties": {
+              "providerSettings": {
+                "properties": {
+                  "pixverse": {
+                    "required": [
+                      "effect"
+                    ]
+                  }
+                }
+              }
+            },
+            "required": [
+              "providerSettings"
+            ]
+          }
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "providerSettings": {
+            "properties": {
+              "pixverse": {
+                "properties": {
+                  "motionMode": {
+                    "const": "fast"
+                  }
+                },
+                "required": [
+                  "motionMode"
+                ]
+              }
+            }
+          }
+        },
+        "required": [
+          "providerSettings"
+        ]
+      },
+      "then": {
+        "properties": {
+          "duration": {
+            "enum": [
+              5
+            ]
+          }
+        },
+        "oneOf": [
+          {
+            "properties": {
+              "width": {
+                "const": 640
+              },
+              "height": {
+                "const": 360
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 480
+              },
+              "height": {
+                "const": 360
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 360
+              },
+              "height": {
+                "const": 360
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 360
+              },
+              "height": {
+                "const": 480
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 360
+              },
+              "height": {
+                "const": 640
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 960
+              },
+              "height": {
+                "const": 540
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 720
+              },
+              "height": {
+                "const": 540
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 540
+              },
+              "height": {
+                "const": 540
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 540
+              },
+              "height": {
+                "const": 720
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 540
+              },
+              "height": {
+                "const": 960
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 1280
+              },
+              "height": {
+                "const": 720
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 960
+              },
+              "height": {
+                "const": 720
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 720
+              },
+              "height": {
+                "const": 720
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 720
+              },
+              "height": {
+                "const": 960
+              }
+            }
+          },
+          {
+            "properties": {
+              "width": {
+                "const": 720
+              },
+              "height": {
+                "const": 1280
+              }
+            }
+          }
+        ]
+      }
+    }
+  ],
+  "additionalProperties": false
+}