Image

OpenAI Image Generation

Generate images using OpenAI's DALL·E and GPT-Image models through the Metriqual gateway.

POST/v1/images/generations

Supported Models

ModelProvider
gpt-image-1OpenAI
dall-e-3OpenAI
dall-e-2OpenAI

Request

Body Parameters

modelstringrequired

Model ID for image generation

promptstringrequired

Text description of the desired image

ninteger

Number of images to generate (1-10)

Default: 1

sizestring

Image dimensions

Default: 1024x1024

Options: 1024x1024, 1024x1792, 1792x1024

qualitystring

Image quality level

Default: auto

Options: auto, high, medium, low

stylestring

Visual style

Options: natural, vivid

output_formatstring

Image file format

Options: png, jpeg, webp

response_formatstring

Return format

Default: url

Options: url, b64_json

backgroundstring

Background transparency

Options: auto, transparent, opaque

cURL
curl https://api.metriqual.com/v1/images/generations \
  -H "Authorization: Bearer mql_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A serene mountain lake at dawn",
    "size": "1024x1024",
    "quality": "high"
  }'
TypeScript SDK
const result = await mql.images.generate({
  model: 'gpt-image-1',
  prompt: 'A serene mountain lake at dawn',
  size: '1024x1024',
  quality: 'high'
});

console.log(result.data[0].url);
Python SDK
result = mql.images.generate(
    model="gpt-image-1",
    prompt="A serene mountain lake at dawn",
    size="1024x1024",
    quality="high",
)
print(result["data"][0]["url"])

# Convenience: get URLs directly
urls = mql.images.generate_urls(
    model="gpt-image-1",
    prompt="A serene mountain lake at dawn",
)
print(urls[0])

Response

200
{
  "created": 1705320000,
  "data": [
    {
      "url": "https://oaidalleapiprodscus.blob.core.windows.net/...",
      "revised_prompt": "A serene mountain lake at dawn..."
    }
  ]
}
Next
Quick Start