Image Generation

POST/api/v1/images/generations

Generate images from text prompts using OpenAI image models via the Meridian proxy. The request and response format is compatible with the OpenAI Images API.

Authentication

Pass your Meridian proxy key as a Bearer token:

Header

Authorization: Bearer sk-mrd-your-proxy-key

Request body

Parameter	Type	Required	Description
`model`	string	Yes	`gpt-image-1`
`prompt`	string	Yes	Text description of the image to generate
`n`	integer	No	Number of images. Default: `1`.
`size`	string	No	`1024x1024`, `1792x1024`, or `1024x1792`. Default: `1024x1024`
`quality`	string	No	`standard` or `hd`. Default: `standard`.

Response

200 OK

{
  "created": 1709836800,
  "data": [
    {
      "url": "https://oaidalleapiprodscus.blob.core.windows.net/...",
      "revised_prompt": "A serene mountain landscape at sunset..."
    }
  ]
}

Examples

curl

curl -X POST https://your-meridian.vercel.app/api/v1/images/generations \
  -H "Authorization: Bearer sk-mrd-your-proxy-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A serene mountain landscape at sunset with a reflective lake",
    "size": "1792x1024",
    "quality": "hd"
  }'

JavaScript

JavaScript (fetch)

const response = await fetch(
  "https://your-meridian.vercel.app/api/v1/images/generations",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sk-mrd-your-proxy-key",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "gpt-image-1",
      prompt: "A serene mountain landscape at sunset",
      size: "1024x1024",
      quality: "standard",
    }),
  }
);

const data = await response.json();
console.log(data.data[0].url);

Python

Python (requests)

import requests

response = requests.post(
    "https://your-meridian.vercel.app/api/v1/images/generations",
    headers={
        "Authorization": "Bearer sk-mrd-your-proxy-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-image-1",
        "prompt": "A serene mountain landscape at sunset",
        "size": "1024x1024",
        "quality": "hd",
    },
)

data = response.json()
print(data["data"][0]["url"])

Supported models

Model	Provider	Max images	Sizes
`gpt-image-1`	OpenAI	1+	1024x1024, 1792x1024, 1024x1792