Maginary Recipes API
The recipes API from Maginary — 12 operation(s) for recipes.
The recipes API from Maginary — 12 operation(s) for recipes.
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/maginary-ai:maginary-ai-recipes-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: Maginary Recipes 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: recipes
paths:
/recipes/:
parameters: []
get:
operationId: recipes_list
description: List public recipes with optional filtering.
parameters:
- name: visibility
in: query
description: Filter by visibility (e.g., 'public')
required: false
schema:
type: string
- name: search
in: query
description: Search by title, description, or tags
required: false
schema:
type: string
- name: category
in: query
description: Filter by category
required: false
schema:
type: string
- name: tags
in: query
description: Filter by tags (comma-separated)
required: false
schema:
type: string
- name: event
in: query
description: Filter by event type
required: false
schema:
type: string
- name: order
in: query
description: 'Sort order: -use_count, -created_at, title'
required: false
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/RecipeList'
tags:
- recipes
summary: Recipes list
x-summary-source: derived
post:
operationId: recipes_create
description: Create new recipe (authenticated users only)
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeCreate'
tags:
- recipes
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeCreate'
required: true
summary: Recipes create
x-summary-source: derived
/recipes/favorites/:
parameters: []
get:
operationId: recipes_favorites_list
summary: Get current user's favorited recipes
description: GET /api/recipes/favorites/
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/RecipeDetail'
tags:
- recipes
/recipes/featured/:
parameters: []
get:
operationId: recipes_featured
description: Get featured recipes (public, no auth required)
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/RecipeDetail'
tags:
- recipes
summary: Recipes featured
x-summary-source: derived
/recipes/my/:
parameters: []
get:
operationId: recipes_my_recipes
description: Get current user's recipes
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/RecipeDetail'
tags:
- recipes
summary: Recipes my recipes
x-summary-source: derived
/recipes/trending/:
parameters: []
get:
operationId: recipes_trending
summary: Get trending recipes (public, sorted by engagement score)
description: Score = use_count + (favorite_count * 2) + (steal_count * 3) + (comment_count * 1.5)
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/RecipeDetail'
tags:
- recipes
/recipes/{uuid}/:
parameters:
- name: uuid
in: path
required: true
schema:
type: string
get:
operationId: recipes_read
summary: Get recipe detail by UUID or slug with visibility check
description: Allows unlisted recipes to be accessed via direct link.
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeDetail'
tags:
- recipes
put:
operationId: recipes_update
description: Update recipe (owner only)
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeUpdate'
tags:
- recipes
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeUpdate'
required: true
summary: Recipes update
x-summary-source: derived
delete:
operationId: recipes_delete
description: Delete recipe (owner only)
responses:
'204':
description: ''
tags:
- recipes
summary: Recipes delete
x-summary-source: derived
/recipes/{uuid}/bake/:
parameters:
- name: uuid
in: path
required: true
schema:
type: string
post:
operationId: recipes_bake
summary: 'Bake a recipe: assemble prompt + optionally check credits'
description: 'Respects source visibility - only returns prompt if user can see source.
Optionally performs credit check without revealing prompt.
POST /recipes/{uuid}/bake/
{
"field_values": [
{"field_id": "photo", "value": "https://..."},
{"field_id": "background", "value": "office"}
],
"check_credits": false // Optional, default false
}
Returns (when check_credits=false):
{
"prompt": "assembled prompt" // null if !can_see_source
}
Returns (when check_credits=true):
{
"prompt": "assembled prompt", // null if !can_see_source
"credits": 10,
"error": null // or error message if check fails
}'
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeDetail'
tags:
- recipes
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeDetail'
required: true
/recipes/{uuid}/comment/:
parameters:
- name: uuid
in: path
required: true
schema:
type: string
post:
operationId: recipes_comment
summary: Add a comment to a recipe
description: 'POST /recipes/{uuid}/comment/
{
"text": "Great recipe!"
}
Returns the created comment.'
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeDetail'
tags:
- recipes
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeDetail'
required: true
/recipes/{uuid}/comments/:
parameters:
- name: uuid
in: path
required: true
schema:
type: string
get:
operationId: recipes_comments_list
summary: Get comments for a recipe
description: GET /recipes/{uuid}/comments/
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeDetail'
tags:
- recipes
/recipes/{uuid}/favorite/:
parameters:
- name: uuid
in: path
required: true
schema:
type: string
post:
operationId: recipes_favorite
summary: Toggle favorite for a recipe
description: POST /recipes/{uuid}/favorite/
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeDetail'
tags:
- recipes
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeDetail'
required: true
/recipes/{uuid}/steal/:
parameters:
- name: uuid
in: path
required: true
schema:
type: string
post:
operationId: recipes_steal
summary: Copy/steal a recipe (creates a new recipe owned by current user)
description: 'Requires can_duplicate permission (user must be able to see source).
POST /recipes/{uuid}/steal/
Returns the newly created recipe.'
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeDetail'
tags:
- recipes
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeDetail'
required: true
/recipes/{uuid}/use/:
parameters:
- name: uuid
in: path
required: true
schema:
type: string
post:
operationId: recipes_use
summary: 'Use a recipe to create a Gen (convenience endpoint: bake + create Gen)'
description: 'Requires can_use permission.
POST /recipes/{uuid}/use/
{
"field_values": [
{"field_id": "photo", "value": "https://..."},
{"field_id": "background", "value": "office"}
]
}
Returns full Gen object (same format as POST /api/gens/).'
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeUse'
tags:
- recipes
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RecipeUse'
required: true
components:
schemas:
RecipeFieldValue:
description: Values for schema fields (required for schema-based recipes)
required:
- field_id
- value
type: object
properties:
field_id:
title: Field id
description: ID of the field from schema
type: string
minLength: 1
value:
title: Value
description: User-provided value for this field
type: object
RecipeUse:
type: object
properties:
field_values:
description: Values for schema fields (required for schema-based recipes)
type: array
items:
$ref: '#/components/schemas/RecipeFieldValue'
RecipeUpdate:
required:
- title
type: object
properties:
title:
title: Title
description: Recipe title
type: string
maxLength: 200
minLength: 1
description:
title: Description
description: What this recipe creates
type: string
image_url:
title: Image url
description: 'Cover image URL (S3: recipes/img/{uuid}.webp)'
type: string
format: uri
maxLength: 500
slug:
title: Slug
description: URL-friendly slug
type: string
format: slug
pattern: ^[-a-zA-Z0-9_]+$
maxLength: 200
schema_json:
title: Schema json
description: JSON schema defining fields and prompt template (null = simple prompt recipe)
type:
- object
- 'null'
field_values:
title: Field values
description: Default values for schema fields
type: object
prompt:
title: Prompt
description: Simple prompt template (used if schema_json is null)
type: string
parameters:
title: Parameters
description: Simple parameters (used if schema_json is null)
type: object
category:
title: Category
description: Recipe category for filtering
type: string
enum:
- portrait
- product
- holiday
- location
- professional
- creative
- other
tags:
title: Tags
description: Searchable tags (e.g., ["linkedin", "professional"])
type: object
visibility:
title: Visibility
description: Visibility and source access level
type: string
enum:
- private
- unlisted_use
- unlisted_full
- public_use
- public_full
is_public:
title: Is public
description: '[DEPRECATED] Use visibility field instead. Will be removed after migration.'
type: boolean
event_type:
title: Event type
description: Associated holiday/event (for seasonal recipes)
type:
- string
- 'null'
enum:
- diwali
- christmas
- halloween
- new_year
- valentines
- easter
- thanksgiving
- holi
- lunar_new_year
- ramadan
- custom
- null
event_start_date:
title: Event start date
description: When to start showing this event recipe
type:
- string
- 'null'
format: date
event_end_date:
title: Event end date
description: When to stop showing this event recipe
type:
- string
- 'null'
format: date
seo_title:
title: Seo title
description: Custom SEO title (max 60 chars)
type:
- string
- 'null'
maxLength: 60
seo_description:
title: Seo description
description: Custom SEO description (max 160 chars)
type:
- string
- 'null'
maxLength: 160
seo_image:
title: Seo image
description: SEO/Open Graph image URL (for social media previews)
type:
- string
- 'null'
format: uri
maxLength: 500
example_images:
title: Example images
description: List of example image URLs with metadata
type: object
RecipeList:
type: object
properties:
uuid:
title: Uuid
description: Unique identifier for URLs
type: string
readOnly: true
minLength: 1
slug:
title: Slug
description: URL-friendly slug
type: string
format: slug
pattern: ^[-a-zA-Z0-9_]+$
readOnly: true
minLength: 1
title:
title: Title
description: Recipe title
type: string
readOnly: true
minLength: 1
description:
title: Description
description: What this recipe creates
type: string
readOnly: true
minLength: 1
image_url:
title: Image url
description: 'Cover image URL (S3: recipes/img/{uuid}.webp)'
type: string
format: uri
readOnly: true
minLength: 1
category:
title: Category
description: Recipe category for filtering
type: string
enum:
- portrait
- product
- holiday
- location
- professional
- creative
- other
readOnly: true
tags:
title: Tags
description: Searchable tags (e.g., ["linkedin", "professional"])
type: object
readOnly: true
is_official:
title: Is official
description: Official/curated recipe (staff-created)
type: boolean
readOnly: true
visibility:
title: Visibility
description: Visibility and source access level
type: string
enum:
- private
- unlisted_use
- unlisted_full
- public_use
- public_full
readOnly: true
is_public:
title: Is public
description: '[DEPRECATED] Use visibility field instead. Will be removed after migration.'
type: boolean
readOnly: true
is_featured:
title: Is featured
description: Featured on landing page
type: boolean
readOnly: true
event_type:
title: Event type
description: Associated holiday/event (for seasonal recipes)
type:
- string
- 'null'
enum:
- diwali
- christmas
- halloween
- new_year
- valentines
- easter
- thanksgiving
- holi
- lunar_new_year
- ramadan
- custom
- null
readOnly: true
use_count:
title: Use count
description: Number of times this recipe has been used
type: integer
readOnly: true
steal_count:
title: Steal count
description: Number of times this recipe has been copied
type: integer
readOnly: true
favorite_count:
title: Favorite count
description: Number of favorites
type: integer
readOnly: true
comment_count:
title: Comment count
description: Number of comments
type: integer
readOnly: true
example_images:
title: Example images
description: List of example image URLs with metadata
type: object
readOnly: true
created_by_username:
title: Created by username
type:
- string
- 'null'
readOnly: true
minLength: 1
created_at:
title: Created at
type: string
format: date-time
readOnly: true
RecipeDetail:
required:
- title
type: object
properties:
uuid:
title: Uuid
description: Unique identifier for URLs
type: string
readOnly: true
minLength: 1
slug:
title: Slug
description: URL-friendly slug
type: string
format: slug
pattern: ^[-a-zA-Z0-9_]+$
readOnly: true
minLength: 1
version:
title: Version
description: Version number, increments on each edit (for tracking recipe changes)
type: integer
readOnly: true
title:
title: Title
description: Recipe title
type: string
maxLength: 200
minLength: 1
description:
title: Description
description: What this recipe creates
type: string
image_url:
title: Image url
description: 'Cover image URL (S3: recipes/img/{uuid}.webp)'
type: string
format: uri
maxLength: 500
schema_json:
title: Schema json
description: JSON schema defining fields and prompt template (null = simple prompt recipe)
type:
- object
- 'null'
field_values:
title: Field values
description: Default values for schema fields
type: object
prompt:
title: Prompt
description: Simple prompt template (used if schema_json is null)
type: string
parameters:
title: Parameters
description: Simple parameters (used if schema_json is null)
type: object
category:
title: Category
description: Recipe category for filtering
type: string
enum:
- portrait
- product
- holiday
- location
- professional
- creative
- other
tags:
title: Tags
description: Searchable tags (e.g., ["linkedin", "professional"])
type: object
is_official:
title: Is official
description: Official/curated recipe (staff-created)
type: boolean
visibility:
title: Visibility
description: Visibility and source access level
type: string
enum:
- private
- unlisted_use
- unlisted_full
- public_use
- public_full
is_public:
title: Is public
description: '[DEPRECATED] Use visibility field instead. Will be removed after migration.'
type: boolean
is_featured:
title: Is featured
description: Featured on landing page
type: boolean
event_type:
title: Event type
description: Associated holiday/event (for seasonal recipes)
type:
- string
- 'null'
enum:
- diwali
- christmas
- halloween
- new_year
- valentines
- easter
- thanksgiving
- holi
- lunar_new_year
- ramadan
- custom
- null
event_start_date:
title: Event start date
description: When to start showing this event recipe
type:
- string
- 'null'
format: date
event_end_date:
title: Event end date
description: When to stop showing this event recipe
type:
- string
- 'null'
format: date
seo_title:
title: Seo title
description: Custom SEO title (max 60 chars)
type:
- string
- 'null'
maxLength: 60
seo_description:
title: Seo description
description: Custom SEO description (max 160 chars)
type:
- string
- 'null'
maxLength: 160
seo_image:
title: Seo image
description: SEO/Open Graph image URL (for social media previews)
type:
- string
- 'null'
format: uri
maxLength: 500
use_count:
title: Use count
description: Number of times this recipe has been used
type: integer
readOnly: true
favorite_count:
title: Favorite count
description: Number of favorites
type: integer
maximum: 9223372036854775807
minimum: 0
example_images:
title: Example images
description: List of example image URLs with metadata
type: object
created_by_username:
title: Created by username
type:
- string
- 'null'
readOnly: true
minLength: 1
created_by:
title: Created by
type:
- integer
- 'null'
readOnly: true
is_schema_based:
title: Is schema based
type: boolean
readOnly: true
favorited:
title: Favorited
type: string
readOnly: true
can_see_source:
title: Can see source
type: string
readOnly: true
can_duplicate:
title: Can duplicate
type: string
readOnly: true
community_generations:
type: array
items:
type: string
readOnly: true
community_generations_total:
title: Community generations total
type: integer
readOnly: true
created_at:
title: Created at
type: string
format: date-time
readOnly: true
updated_at:
title: Updated at
type: string
format: date-time
readOnly: true
RecipeCreate:
required:
- title
type: object
properties:
title:
title: Title
description: Recipe title
type: string
maxLength: 200
minLength: 1
description:
title: Description
description: What this recipe creates
type: string
image_url:
title: Image url
description: 'Cover image URL (S3: recipes/img/{uuid}.webp)'
type: string
format: uri
maxLength: 500
schema_json:
title: Schema json
description: JSON schema defining fields and prompt template (null = simple prompt recipe)
type:
- object
- 'null'
field_values:
title: Field values
description: Default values for schema fields
type: object
prompt:
title: Prompt
description: Simple prompt template (used if schema_json is null)
type: string
parameters:
title: Parameters
description: Simple parameters (used if schema_json is null)
type: object
category:
title: Category
description: Recipe category for filtering
type: string
enum:
- portrait
- product
- holiday
- location
- professional
- creative
- other
tags:
title: Tags
description: Searchable tags (e.g., ["linkedin", "professional"])
type: object
visibility:
title: Visibility
description: Visibility and source access level
type: string
enum:
- private
- unlisted_use
- unlisted_full
- public_use
- public_full
is_public:
title: Is public
description: '[DEPRECATED] Use visibility field instead. Will be removed after migration.'
type: boolean
event_type:
title: Event type
description: Associated holiday/event (for seasonal recipes)
type:
- string
- 'null'
enum:
- diwali
- christmas
- halloween
- new_year
- valentines
- easter
- thanksgiving
- holi
- lunar_new_year
- ramadan
- custom
- null
event_start_date:
title: Event start date
description: When to start showing this event recipe
type:
- string
- 'null'
format: date
event_end_date:
title: Event end date
description: When to stop showing this event recipe
type:
- string
- 'null'
format: date
seo_title:
title: Seo title
description: Custom SEO title (max 60 chars)
type:
- string
- 'null'
maxLength: 60
seo_description:
title: Seo description
description: Custom SEO description (max 160 chars)
type:
- string
- 'null'
maxLength: 160
seo_image:
title: Seo image
description: SEO/Open Graph image URL (for social media previews)
type:
- string
- 'null'
format: uri
maxLength: 500
example_images:
title: Example images
description: List of example image URLs with metadata
type: object
securitySchemes:
Basic:
type: http
scheme: basic
Bearer:
type: apiKey
name: Authorization
in: header