curl --request POST \
  --url https://api.magnific.com/v1/ai/magnific-one \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "A lighthouse on a cliff at dusk"
}
'

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "IN_PROGRESS"
  }
}

Magnific One

Create Image

Generate images with Magnific One, Magnific’s image model with art direction built in: from a prompt, it develops the composition, style, lighting and visual treatment before rendering.

Modes:

quality (default): one finished image, with selectable quality and resolution (up to 4k)
draft: a contact sheet of quick variations, returned as 8 or 16 individual images — explore directions, then render the chosen one in quality mode

Key Features:

Art direction from a short prompt
Optional style reference images (up to 10), in both modes
10 aspect ratios, from 21:9 to 9:16

Output: the task’s generated array holds one image URL in quality mode, or 8 or 16 URLs (one per individual image) in draft mode.

Credits: a quality request is billed once, at the price of its quality and resolution. A draft request is billed once for the whole sheet, at the medium / 2k price, never per image. Reference images do not change the price.

The request is processed asynchronously: the endpoint returns a task id immediately. Retrieve the result by polling the task endpoint or by providing an optional webhook_url.

POST

magnific-one

curl --request POST \
  --url https://api.magnific.com/v1/ai/magnific-one \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "A lighthouse on a cliff at dusk"
}
'

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "IN_PROGRESS"
  }
}

Authorizations

x-magnific-api-key

string

header

required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json

prompt

string

required

Text description of the image you want to generate. Magnific One develops the art direction (composition, style, lighting and visual treatment) from it before rendering.

Examples:

Simple: "A lighthouse on a cliff at dusk"
Detailed: "Editorial photo of a lighthouse on a basalt cliff at dusk, long exposure sea, warm window light, cinematic framing"

Required string length: 1 - 2000

Example:

"A lighthouse on a cliff at dusk"

mode

enum<string>

default:quality

What the request produces.

quality: one finished image (default)
draft: a contact sheet of quick variations, returned as 8 or 16 individual images (see tiles). Use it to explore directions before rendering the chosen one in quality mode.

Available options:

quality,

draft

Example:

"quality"

aspect_ratio

enum<string>

default:1:1

Aspect ratio of the image. In draft mode it describes each individual image, not the contact sheet.

With tiles: 16 every ratio is honoured exactly. With tiles: 8 the sheet is twice as wide relative to its images, and the ratios that no longer fit are approximated to the closest supported one: 1:1, 2:3, 3:2 and 3:4 come back exact, the rest may deviate. Use tiles: 16 when the ratio of every image must be exact.

Available options:

1:1,

2:1,

3:1,

2:3,

3:2,

3:4,

4:3,

16:9,

9:16,

21:9

Example:

"1:1"

quality

enum<string>

default:high

Render quality in quality mode.

medium: faster and cheaper
high: maximum detail (default)

Ignored in draft mode, which always renders at medium.

Credits: together with resolution, it sets the price of the request.

Available options:

medium,

high

Example:

"high"

resolution

enum<string>

default:2k

Resolution tier of the image in quality mode. Combined with aspect_ratio it selects the exact pixel size.

Ignored in draft mode, which always renders its contact sheet at 2k.

Credits: together with quality, it sets the price of the request.

Available options:

1k,

2k,

4k

Example:

"2k"

tiles

enum<integer>

default:8

Number of individual images returned in draft mode. Ignored in quality mode.

8: a 2x4 sheet (default). May approximate aspect_ratio
16: a 4x4 sheet. Always preserves aspect_ratio exactly

Available options:

8,

16

Example:

8

reference_images

string[]

Optional reference images that guide the style of the result. Supported in both modes. They do not change the price.

Required array length: 1 - 10 elements

Publicly accessible image URL.

webhook_url

string<uri>

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example:

"https://www.example.com/webhook"

Response

OK - The request has succeeded and the Magnific One process has started.

data

object

required

Show child attributes

Example:

{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}

Get started

APIs

Create Image

Authorizations

Body

Response