{
 "spec_version": 1,
 "model": "black-forest-labs/flux-3-image",
 "type": "image",
 "input_modalities": [
  "text",
  "image"
 ],
 "output_modalities": [
  "image"
 ],
 "context_window": null,
 "max_output_tokens": null,
 "endpoint": {
  "method": "POST",
  "path": "/v1/images/generations"
 },
 "also_on": [
  "/v1/images/edits"
 ],
 "parameters": [
  {
   "name": "model",
   "type": "string",
   "required": true,
   "description": "This model's ID."
  },
  {
   "name": "prompt",
   "type": "string",
   "required": true,
   "description": "What to draw."
  },
  {
   "name": "size",
   "type": "string",
   "enum": [
    "21:9",
    "2:1",
    "16:9",
    "3:2",
    "7:5",
    "4:3",
    "5:4",
    "1:1",
    "4:5",
    "3:4",
    "5:7",
    "2:3",
    "9:16",
    "1:2",
    "9:21"
   ],
   "description": "Aspect ratio. Width x height such as `1024x1024` is accepted too and mapped to its ratio."
  },
  {
   "name": "quality",
   "type": "string",
   "enum": [
    "1K",
    "2K",
    "4K"
   ],
   "description": "Resolution tier; `low`, `medium` and `high` are accepted as 1K, 2K and 4K."
  },
  {
   "name": "images",
   "type": "array",
   "maxItems": 10,
   "description": "Up to 10 reference images to start from or draw on, each a public https:// URL or a data URL. The request is then an edit."
  }
 ],
 "response": {
  "fields": [
   {
    "name": "created",
    "type": "integer",
    "description": "Unix time."
   },
   {
    "name": "data[].url",
    "type": "string",
    "description": "The image. Download it within 24 hours."
   }
  ],
  "example": {
   "created": 1792000000,
   "data": [
    {
     "url": "https://..."
    }
   ]
  }
 },
 "examples": [
  {
   "title": "Basic",
   "request": {
    "model": "black-forest-labs/flux-3-image",
    "prompt": "A lighthouse at dawn, watercolor",
    "size": "21:9"
   }
  }
 ],
 "input_schema": {
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": [
   "model",
   "prompt"
  ],
  "properties": {
   "model": {
    "type": "string",
    "description": "This model's ID."
   },
   "prompt": {
    "type": "string",
    "description": "What to draw."
   },
   "size": {
    "type": "string",
    "description": "Aspect ratio. Width x height such as `1024x1024` is accepted too and mapped to its ratio.",
    "enum": [
     "21:9",
     "2:1",
     "16:9",
     "3:2",
     "7:5",
     "4:3",
     "5:4",
     "1:1",
     "4:5",
     "3:4",
     "5:7",
     "2:3",
     "9:16",
     "1:2",
     "9:21"
    ]
   },
   "quality": {
    "type": "string",
    "description": "Resolution tier; `low`, `medium` and `high` are accepted as 1K, 2K and 4K.",
    "enum": [
     "1K",
     "2K",
     "4K"
    ]
   },
   "images": {
    "type": "array",
    "description": "Up to 10 reference images to start from or draw on, each a public https:// URL or a data URL. The request is then an edit.",
    "maxItems": 10
   }
  }
 }
}