Generate Image
OpenAI-compatible image generation endpoint.
Note: The image response may not render in GitBook’s “Test it” panel. To view the generated image, try this endpoint with Postman, curl, or another HTTP client.
Authorizations
Enter your MeshAPI key (rsk_...) or, for the admin-keys endpoints, a dashboard session token — sent as Authorization: Bearer <token>.
Headers
Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.
2026-08, 2026-09 Body
1 <= x <= 10url, b64_json png, jpeg, webp 0 <= x <= 100transparent, opaque, auto low, auto 0 <= x <= 3-1 <= x <= 2147483647auto, disabled 1 <= x <= 10Your own labels for this request, echoed back on the usage row and available as a filter and a group-by dimension in the usage API. String keys to string values. Never put personal or sensitive data here — tags are stored with the usage record and are not redacted.
A stable, anonymised identifier for the end user making this request, recorded on the usage row and available as a filter and a group-by dimension in the usage API. Supersedes the deprecated user field. Use an opaque id, not an email address or a name.
256Response
Successful Response