{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/pika/main/json-schema/pika-video-request-schema.json",
  "title": "PikaVideoRequest",
  "description": "Common request schema for Pika 2.2 video generation endpoints (text-to-video and image-to-video) via fal.ai.",
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Text description of the video or motion to generate.",
      "examples": [
        "The man and the horse are slowly walking towards the camera, the camera orbits and dolly out"
      ]
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "description": "URL of the image to use as the first frame (required for image-to-video only).",
      "examples": [
        "https://storage.googleapis.com/falserverless/example_inputs/pika/pika_i2v_v22_input.png"
      ]
    },
    "negative_prompt": {
      "type": "string",
      "description": "Text describing features to avoid in the generated video.",
      "default": "ugly, bad, terrible"
    },
    "aspect_ratio": {
      "type": "string",
      "description": "Aspect ratio of the generated video (text-to-video only).",
      "enum": ["16:9", "9:16", "1:1", "4:5", "5:4", "3:2", "2:3"],
      "default": "16:9"
    },
    "resolution": {
      "type": "string",
      "description": "Output resolution of the generated video.",
      "enum": ["720p", "1080p"],
      "default": "720p"
    },
    "duration": {
      "type": "integer",
      "description": "Duration of the generated video in seconds.",
      "enum": [5, 10],
      "default": 5
    },
    "seed": {
      "oneOf": [
        { "type": "integer" },
        { "type": "null" }
      ],
      "description": "Seed for reproducibility. Omit or set to null for random results."
    }
  },
  "required": ["prompt"]
}