GET
/v1/schemas/meta/image/v1/images/generations
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. docs-derived Source trace465222224fb783e84f14887d37bfd5c785c4ac8bd9d1af3fb667ff72fe117373{
"fetchedAt": 1793077879,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
12 properties · 2 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| model* | string | Model ID for image generation. | |
| prompt* | string | Text description of the images to generate. | |
| n | integer | Number of images to generate. Range: 1-10. Defaults to 1. (minimum: 1, maximum: 10, default: 1) | 1 ≤ n ≤ 10 · default: 1 |
| size | string | Requested image shape as width x height (e.g., '1024x1024'). The value is converted into an aspect ratio only; the image is produced at the generator's own fixed output resolution, so the returned pixel dimensions stay constant regardless of the numbers suppli… | |
| response_format | enum | Format for returned images. One of: url, b64_json. Defaults to b64_json. (default: b64_json) | url | b64_json |
| moderation | string | Moderation level for the safety pipeline. One of auto or low. Enabled per model: on models where it is not enabled, any moderation value returns 400 (code: unsupported_parameter, param: moderation); omitting moderation is always valid. On enabled models, unkno… | |
| output_format | string | Requested file type for the generated images. One of png, jpeg, or webp. Defaults to webp when omitted; any other value is rejected. | |
| reasoning_strength | enum | How much reasoning the image generator applies before producing the image. One of low or high. low returns after a single generation pass (no self-refinement); high (the default) lets the generator iteratively refine. (default: high) | low | high |
| temperature | number | Sampling temperature for the model's planning step (prompt writing and refinement), between 0 and 2. It does not change how the image itself is sampled. Omit it to keep the model default. (minimum: 0, maximum: 2) | 0 ≤ n ≤ 2 |
| user | string | A stable end-user identifier that helps detect and mitigate abuse. Use it on the images endpoints; on the Responses and Chat Completions endpoints, use safety_identifier instead. | |
| stream | boolean | If true, streams the response as server-sent events. Defaults to false. (default: false) | default: false |
| tool_enablement | image-tool-enablement | Per-tool controls for the image generator's planner. Omit to keep the default (all tools available). |
Types
1 $defsimage-tool-enablementobject
| enable_image_search | boolean | Whether the image generator may search the web for visual references. false disables it. | |
| enable_web_search | boolean | Whether the image generator may search the web for facts. false disables it (also drops the browser tools). | |
| enable_shell | boolean | Whether the image generator may run code to build layouts and charts. false disables it. |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"meta","endpointId":"v1/images/generations","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}