Generation response

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/modelslab-com/json-schema/modelslab-com-generation-response-schema.json",
  "title": "Generation response",
  "description": "Discriminated on `status`. Every generation and fetch endpoint returns one of these three shapes, always on HTTP 200.",
  "x-generated": "2026-10-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/modelslab-com-api-openapi.json#/components/schemas/GenerationResponse",
  "oneOf": [
    {
      "$ref": "#/$defs/GenerationSuccess"
    },
    {
      "$ref": "#/$defs/GenerationProcessing"
    },
    {
      "$ref": "#/$defs/GenerationError"
    }
  ],
  "$defs": {
    "GenerationError": {
      "type": "object",
      "title": "Generation error",
      "description": "Failure envelope. Note that generation endpoints return this on HTTP 200 — branch on `status` and `code`, not on the HTTP status.",
      "required": [
        "status",
        "message"
      ],
      "properties": {
        "status": {
          "type": "string",
          "const": "error"
        },
        "code": {
          "type": "string",
          "description": "Stable machine-readable error code. Branch on this.",
          "enum": [
            "validation_error",
            "invalid_api_key",
            "unauthenticated",
            "forbidden",
            "no_subscription",
            "insufficient_balance",
            "not_found",
            "rate_limited",
            "provider_error",
            "content_moderated",
            "upstream_unavailable",
            "server_error"
          ]
        },
        "message": {
          "type": "string",
          "description": "Human-readable explanation. Wording is not stable; do not parse it."
        },
        "errors": {
          "type": "object",
          "description": "Per-field validation detail. Present when code is \"validation_error\".",
          "additionalProperties": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "tips": {
          "type": "string",
          "description": "Optional remediation hint."
        }
      },
      "additionalProperties": true
    },
    "GenerationProcessing": {
      "type": "object",
      "title": "Generation queued",
      "description": "The job was accepted and is running. Poll `fetch_result` after `eta` seconds.",
      "required": [
        "status",
        "id"
      ],
      "properties": {
        "status": {
          "type": "string",
          "const": "processing"
        },
        "id": {
          "type": [
            "integer",
            "string"
          ],
          "description": "Request id to poll on the matching fetch endpoint."
        },
        "eta": {
          "type": [
            "number",
            "string",
            "null"
          ],
          "description": "Estimated seconds until the result is ready."
        },
        "fetch_result": {
          "type": [
            "string",
            "null"
          ],
          "format": "uri",
          "description": "Absolute URL to poll for this job."
        },
        "future_links": {
          "type": "array",
          "description": "URLs the assets will occupy once generation completes.",
          "items": {
            "type": "string",
            "format": "uri"
          }
        },
        "output": {
          "type": "array",
          "description": "Always empty while processing.",
          "items": {
            "type": "string",
            "format": "uri"
          }
        },
        "message": {
          "type": "string"
        },
        "meta": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "GenerationSuccess": {
      "type": "object",
      "title": "Generation success",
      "required": [
        "status",
        "output"
      ],
      "properties": {
        "status": {
          "type": "string",
          "const": "success"
        },
        "id": {
          "type": [
            "integer",
            "string"
          ],
          "description": "Request id. Use it with the matching fetch endpoint."
        },
        "output": {
          "type": "array",
          "description": "Result URLs. One entry per generated asset.",
          "items": {
            "type": "string",
            "format": "uri"
          }
        },
        "proxy_links": {
          "type": [
            "array",
            "string"
          ],
          "description": "Alternate CDN URLs for the same assets, when available.",
          "items": {
            "type": "string",
            "format": "uri"
          }
        },
        "generationTime": {
          "type": [
            "number",
            "null"
          ],
          "description": "Seconds spent generating."
        },
        "nsfw_content_detected": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "True when the safety checker flagged the output."
        },
        "meta": {
          "type": "object",
          "description": "The resolved model parameters for this request. Keys vary by model; discover them with GET /v6/model-search/{modelId}.",
          "additionalProperties": true
        },
        "tip": {
          "type": "string"
        }
      },
      "additionalProperties": true
    }
  }
}