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 Public 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: Public
paths:
/public/active-event/:
parameters: []
get:
operationId: public_active-event_list
summary: Get the currently active event/holiday
description: 'Returns the highest-priority event that is either:
- Currently active (within start/end date range)
- OR starts within the next 14 days
Used for displaying event-specific content on homepage and landing pages.
Example Response:
{
"id": "diwali_2025",
"name": "Diwali",
"display_name": "Festival of Lights",
"icon": "🪔",
"start_date": "2025-10-20",
"end_date": "2025-11-05",
"priority": 9,
"recipe_slug": "diwali-portrait",
"description": "Celebrate the Festival of Lights with vibrant Diwali-themed photos",
"days_until": 5
}
If no event is active, returns empty object: {}'
responses:
'200':
description: ''
tags:
- Public
components:
securitySchemes:
Basic:
type: http
scheme: basic
Bearer:
type: apiKey
name: Authorization
in: header