API reference

Images

POSThttps://api.oneover.com/functions/v1/api-v1-imagesScope: images

Generate images via Flux, GPT Image, Gemini, Ideogram, Grok Imagine, and more.

Request body

Parameters

Name	Type	Required	Description
`model`	`string`	Yes	Image model ID (Flux, GPT Image, Ideogram, Gemini, Grok Imagine, etc.).
`prompt`	`string`	Yes	Image description.
`negative_prompt`	`string`	No	What to avoid in the image.
`aspect_ratio`	`string`	No	e.g. 1:1, 16:9, 9:16.
`resolution_tier`	`string`	No	1k, 2k, or 4k where supported by the model.

Examples

Request

curl -X POST "https://api.oneover.com/functions/v1/api-v1-images" \
  -H "Authorization: Bearer oo_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-pro",
    "prompt": "Minimal hero illustration",
    "aspect_ratio": "16:9"
  }'

Response

200 OK

{
  "request_id": "uuid",
  "model": "flux-2-pro",
  "image_url": "https://...",
  "credits_charged": 6,
  "balance": { "subscription": 14994, "anytime": 5000 }
}

Playground supports live image generation with inline preview.