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. 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.
openapi: 3.2.0
info:
title: Maginary Auth API
description: Public API documentation for Maginary — AI image and video generation platform.
version: v1
servers:
- url: https://app.maginary.ai/api
security:
- Basic: []
- Bearer: []
tags:
- name: Auth
paths:
/auth/account-status/:
parameters: []
get:
operationId: auth_account-status_list
summary: Account status for MCP/agent onboarding flow
description: 'Works with any DRF auth method (Basic, Bearer, Session). Returns
verification status, credit balance, and API key count — everything
an agent needs to decide the next onboarding step.'
responses:
'200':
description: ''
tags:
- Auth
/auth/register/:
parameters: []
post:
operationId: auth_register_create
summary: Create a new account via API (for MCP/agent onboarding)
description: 'Uses allauth''s internals (EmailAddress, send_email_confirmation, adapter
IP enrichment) so the verification flow is identical to web signup.
Rate-limited aggressively to prevent registration spam and email bombing.'
responses:
'201':
description: ''
tags:
- Auth
/auth/wallet-account/:
parameters: []
post:
operationId: auth_wallet-account_create
summary: Create an account from a wallet signature — no email, no payment
description: 'The caller proves control of a wallet by signing the standard auth
message (EIP-191 personal_sign). On success the endpoint creates a
wallet-only account (or finds the existing one) and returns an API key
so the caller can authenticate over MCP or REST immediately.
This is the "light" onboarding for wallet-bearing agents that want an
account before their first x402 payment. The wallet signature IS the
proof of identity — no email verification needed.'
responses:
'201':
description: ''
tags:
- Auth
components:
securitySchemes:
Basic:
type: http
scheme: basic
Bearer:
type: apiKey
name: Authorization
in: header