Octen · Schema
ImageGenerationFormRequest
Multipart form for the Image Generation API. Same fields as the JSON body, except image inputs are uploaded as files.
SearchWeb SearchArtificial IntelligenceLLMEmbeddingsContent ExtractionModel GatewayMCPAgentsDeep ResearchCompany
Properties
| Name | Type | Description |
|---|---|---|
| model | string | The model to use. Aliases `nano-banana-pro` (= `google/gemini-3-pro-image`) and `nano-banana-2` (= `google/gemini-3.1-flash-image`) are also accepted. |
| prompt | string | The text description for the model. The length limit is set by the model. |
| n | integer | (GPT only) Number of images to generate. For Gemini, request multiple images in the `prompt` instead. |
| size | string | Output size as `width x height` (e.g. `1024x1024`) or `auto`. |
| quality | string | (GPT only) Generation quality. |
| background | string | (GPT only) Background setting. |
| output_format | string | Output image format. GPT supports png/jpeg/webp; Gemini supports png/jpeg (webp falls back to png). |
| output_compression | integer | (GPT only) Compression level (percent). Effective only when `output_format` is jpeg or webp. |
| moderation | string | (GPT only) Content moderation strength. |
| thinking_level | string | (Gemini only) Thinking effort before generation. |
| response_modalities | array | (Gemini only) Controls returned modalities. `["text","image"]` returns the image plus accompanying text; `["image"]` returns only the image. |
| media_resolution | string | (Gemini only) Processing resolution for input reference images. |
| response_format | string | Return format. |
| stream | boolean | (GPT only) Whether to stream the response. |
| partial_images | integer | (GPT only) Number of intermediate preview images to stream. Effective only when `stream=true`. Each preview costs an extra 100 image output tokens. |
| user | string | A unique identifier for the end user. Use hashed or pseudonymous identifiers to avoid passing personally identifiable information. |
| image | string | Reference/source image file. Providing an image enters edit mode. For multiple reference images, use the `image[]` field instead. |
| image[] | array | Multiple reference image files, combined by the model. Per-model limits apply. |
| mask | string | (GPT only) Mask image file (PNG matching the input size). Transparent areas are repainted. Effective only when an image is provided. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/octen-ai/json-schema/octen-ai-image-generation-form-request-schema.json",
"title": "ImageGenerationFormRequest",
"description": "Multipart form for the Image Generation API. Same fields as the JSON body, except image inputs are uploaded as files.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/octen-ai-images-api-openapi.yml#/components/schemas/ImageGenerationFormRequest",
"allOf": [
{
"$ref": "#/$defs/ImageGenerationBaseRequest"
},
{
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "binary",
"description": "Reference/source image file. Providing an image enters edit mode. For multiple reference images, use the `image[]` field instead."
},
"image[]": {
"type": "array",
"items": {
"type": "string",
"format": "binary"
},
"description": "Multiple reference image files, combined by the model. Per-model limits apply."
},
"mask": {
"type": "string",
"format": "binary",
"description": "(GPT only) Mask image file (PNG matching the input size). Transparent areas are repainted. Effective only when an image is provided."
}
}
}
],
"$defs": {
"ImageGenerationBaseRequest": {
"type": "object",
"required": [
"model",
"prompt"
],
"description": "Shared parameters for the Image Generation API. Text-to-image when no image is provided; image editing when an image is provided. Parameters marked (GPT only) or (Gemini only) apply only to those model families; unsupported parameters are ignored.",
"properties": {
"model": {
"type": "string",
"enum": [
"openai/gpt-image-2.5-flare",
"openai/gpt-image-2.5-sunburst",
"openai/gpt-image-2",
"openai/gpt-image-1-mini",
"google/gemini-3-pro-image",
"google/gemini-3.1-flash-image"
],
"description": "The model to use. Aliases `nano-banana-pro` (= `google/gemini-3-pro-image`) and `nano-banana-2` (= `google/gemini-3.1-flash-image`) are also accepted."
},
"prompt": {
"type": "string",
"description": "The text description for the model. The length limit is set by the model."
},
"n": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 1,
"description": "(GPT only) Number of images to generate. For Gemini, request multiple images in the `prompt` instead."
},
"size": {
"type": "string",
"default": "auto",
"description": "Output size as `width x height` (e.g. `1024x1024`) or `auto`."
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high",
"xhigh",
"max",
"auto"
],
"default": "auto",
"description": "(GPT only) Generation quality."
},
"background": {
"type": "string",
"enum": [
"transparent",
"opaque",
"auto"
],
"default": "auto",
"description": "(GPT only) Background setting."
},
"output_format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
],
"default": "png",
"description": "Output image format. GPT supports png/jpeg/webp; Gemini supports png/jpeg (webp falls back to png)."
},
"output_compression": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"default": 100,
"description": "(GPT only) Compression level (percent). Effective only when `output_format` is jpeg or webp."
},
"moderation": {
"type": "string",
"enum": [
"low",
"auto"
],
"default": "auto",
"description": "(GPT only) Content moderation strength."
},
"thinking_level": {
"type": "string",
"enum": [
"minimal",
"high"
],
"default": "minimal",
"description": "(Gemini only) Thinking effort before generation."
},
"response_modalities": {
"type": "array",
"items": {
"type": "string",
"enum": [
"text",
"image"
]
},
"default": [
"text",
"image"
],
"description": "(Gemini only) Controls returned modalities. `[\"text\",\"image\"]` returns the image plus accompanying text; `[\"image\"]` returns only the image."
},
"media_resolution": {
"type": "string",
"enum": [
"low",
"medium",
"high"
],
"description": "(Gemini only) Processing resolution for input reference images."
},
"response_format": {
"type": "string",
"enum": [
"b64_json"
],
"default": "b64_json",
"description": "Return format."
},
"stream": {
"type": "boolean",
"default": false,
"description": "(GPT only) Whether to stream the response."
},
"partial_images": {
"type": "integer",
"minimum": 0,
"maximum": 3,
"default": 0,
"description": "(GPT only) Number of intermediate preview images to stream. Effective only when `stream=true`. Each preview costs an extra 100 image output tokens."
},
"user": {
"type": "string",
"description": "A unique identifier for the end user. Use hashed or pseudonymous identifiers to avoid passing personally identifiable information."
}
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/octen-ai-image-generation-form-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.