{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/butterbase-ai/json-schema/butterbase-ai-post-v1-appid-images-completions-request-schema.json",
  "title": "PostV1AppidImagesCompletionsRequest",
  "x-generated": "2026-11-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/butterbase-ai-openapi-generated.yml#/components/schemas/PostV1AppidImagesCompletionsRequest",
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "Image model ID (see table above)."
    },
    "prompt": {
      "type": "string",
      "description": "Text description of the image to generate."
    },
    "size": {
      "type": "string",
      "description": "e.g. 1024x1024, 1536x1024, or symbolic like 1K / 2K / 4K."
    },
    "aspect_ratio": {
      "type": "string",
      "description": "e.g. 16:9, 1:1. Gemini and Pruna families only."
    },
    "n": {
      "type": "string",
      "description": "Number of images to generate. GPT Image 2 / 1 / 1-mini only."
    },
    "seed": {
      "type": "string",
      "description": "Integer for deterministic generation."
    },
    "input_images": {
      "type": "string",
      "description": "Array of HTTPS image URLs for image-to-image or reference guidance."
    },
    "mask": {
      "type": "string",
      "description": "HTTPS URL of an alpha mask for edit mode."
    },
    "negative_prompt": {
      "type": "string",
      "description": "Text description of what to avoid."
    },
    "provider": {
      "type": "string",
      "description": "Object of model‑specific params."
    }
  },
  "required": [
    "model",
    "prompt"
  ]
}