Mangii Images API
The images API from Mangii — 1 operation(s) for images.
The images API from Mangii — 1 operation(s) for images.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.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.curl "https://apis.io/api/v1/apis/mangii-ai:mangii-ai-images-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Mangii Headless Images API
version: 1.0.0
description: 'Agent-consumable creation API. Auth is Authorization Bearer mangii_sk_. Generation POSTs default to async 202 + job_id. Debit is useApiCredit: apiPackCredits first, then purchase-backed packCredits. weeklyCredits never.'
servers:
- url: https://api.mangii.ai
description: Generation host (Functions custom domain or Cloud Run)
security:
- mangiiKey: []
tags:
- name: Images
paths:
/v1/images:
post:
operationId: createImage
tags:
- Images
parameters:
- $ref: '#/components/parameters/IdempotencyKey'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateImageRequest'
responses:
'200':
description: Sync completion (opt-in, long-timeout host only)
headers:
X-RateLimit-Limit:
$ref: '#/components/headers/XRateLimitLimit'
X-RateLimit-Remaining:
$ref: '#/components/headers/XRateLimitRemaining'
X-RateLimit-Reset:
$ref: '#/components/headers/XRateLimitReset'
content:
application/json:
schema:
$ref: '#/components/schemas/GenerationResult'
'202':
description: Job accepted
headers:
X-RateLimit-Limit:
$ref: '#/components/headers/XRateLimitLimit'
X-RateLimit-Remaining:
$ref: '#/components/headers/XRateLimitRemaining'
X-RateLimit-Reset:
$ref: '#/components/headers/XRateLimitReset'
content:
application/json:
schema:
$ref: '#/components/schemas/JobAccepted'
'402':
$ref: '#/components/responses/Error'
'409':
$ref: '#/components/responses/IdempotencyCollision'
'429':
$ref: '#/components/responses/RateLimited'
summary: Create image
x-summary-source: derived
components:
schemas:
JobAccepted:
type: object
required:
- job_id
- request_id
properties:
job_id:
type: string
request_id:
type: string
credits_charged:
type: integer
credits_remaining:
type: integer
quality:
type: string
next_step:
type: string
description: What to call next. Follow this instead of guessing.
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- type
- code
- message
- request_id
properties:
type:
type: string
code:
type: string
enum:
- invalid_key
- insufficient_credits
- budget_exceeded
- content_blocked
- gone
- idempotency_conflict
- idempotency_in_progress
message:
type: string
request_id:
type: string
buy_url:
type: string
GenerationResult:
type: object
required:
- credits_charged
- credits_remaining
- quality
- request_id
properties:
credits_charged:
type: integer
credits_remaining:
type: integer
quality:
type: string
request_id:
type: string
job_id:
type: string
story_id:
type: string
panel_id:
type: string
image_url:
type: string
description: HTTPS URL of the finished panel.
next_step:
type: string
description: What to call next.
CreateImageRequest:
type: object
required:
- prompt
- style_id
properties:
prompt:
type: string
maxLength: 2000
style_id:
type: string
quality:
type: string
enum:
- standard
- hd
- ultra
reference_image:
type: string
async:
type: boolean
default: true
parameters:
IdempotencyKey:
name: Idempotency-Key
in: header
required: true
schema:
type: string
responses:
Error:
description: Uniform error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
IdempotencyCollision:
description: 'Idempotency-Key is already in flight (idempotency_in_progress — retry the same key) or was reused with a different body (idempotency_conflict — pick a new key).
'
headers:
X-RateLimit-Limit:
$ref: '#/components/headers/XRateLimitLimit'
X-RateLimit-Remaining:
$ref: '#/components/headers/XRateLimitRemaining'
X-RateLimit-Reset:
$ref: '#/components/headers/XRateLimitReset'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
RateLimited:
description: 'Per-key rate limit exceeded for the current minute bucket. Every /v1 operation shares one per-key limiter, so any of them can return this.
'
headers:
X-RateLimit-Limit:
$ref: '#/components/headers/XRateLimitLimit'
X-RateLimit-Remaining:
$ref: '#/components/headers/XRateLimitRemaining'
X-RateLimit-Reset:
$ref: '#/components/headers/XRateLimitReset'
Retry-After:
$ref: '#/components/headers/RetryAfter'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
headers:
XRateLimitLimit:
description: Requests this key may make in the current minute bucket.
schema:
type: integer
example: 60
XRateLimitReset:
description: Unix seconds at the start of the next minute bucket, when the allowance rolls over.
schema:
type: integer
example: 1755600120
RetryAfter:
description: Seconds to wait before retrying. Always the full bucket width.
schema:
type: integer
example: 60
XRateLimitRemaining:
description: Requests left in the current minute bucket. Floored at 0, so a 429 always reports 0.
schema:
type: integer
example: 59
securitySchemes:
mangiiKey:
type: http
scheme: bearer
bearerFormat: mangii_sk_
description: API key mangii_sk_<32 bytes base62>