Skip to content
Developers
API docs / Features

MAKEUGC PLATFORM API · DOCS V2

Image Generation & Editing

Create images from text or edit existing product and character references.

Workflow

  1. Choose a text-to-image model or its edit variant.
  2. For editing, provide the image reference fields required by that model and describe the intended change.
  3. Submit and poll with media=image. Download every completed URL from output.output_link.
Model IDs ending in -edit accept image references. Supported reference count, image size and output settings vary; use the exact model reference.
These workflows use the public model generation endpoints. The selected model controls available parameters and billing.
For /enterprise/generate, save request_id and poll /enterprise/status/{request_id}?media=video (or image for image models). Status 0 is processing, 1 is completed and 2 is failed. Video output is video_url; image output is output.output_link.
For /seedance/generate, save data.id and poll /seedance/status?id=ID. Read data.status and the completed data.url. Keep these two response formats separate.

Example IDs and media URLs are placeholders. Replace them with values from your account and accessible media files.

Choose a model

Nano Banana Pro

Text-to-image generation for single-image output.

nano-banana-pro
GPT Image 2

OpenAI image generation model.

gpt-image-2
FLUX.2 Pro

Flux text-to-image generation.

flux-2-pro
Grok Imagine Image

Grok text-to-image generation.

grok-imagine-image
Nano Banana Pro · Edit

Edit model that accepts up to 2 source images.

nano-banana-pro-edit
GPT Image 2 · Edit

OpenAI edit model with up to 2 source images.

gpt-image-2-edit
FLUX.2 Pro · Edit

Flux edit model with up to 2 source images.

flux-2-pro-edit
Grok Imagine Image · Edit

Grok edit model with up to 2 source images.

grok-imagine-image-edit
Seedream 5.0 Pro

Generate images with Seedream 5.0 Pro.

seedream-v5.0
Seedream 5.0 Pro · Edit

Edit or blend up to ten source images with Seedream 5.0 Pro.

seedream-v5.0-edit
GPT Image 1.5

Generate images with GPT Image 1.5.

gpt-image-1.5
GPT Image 1.5 · Edit

Edit images with GPT Image 1.5.

gpt-image-1.5-edit
GPT Image 2.5 Flare

Generate images with GPT Image 2.5 Flare.

gpt-image-2.5-flare
GPT Image 2.5 Flare · Edit

Edit images with GPT Image 2.5 Flare.

gpt-image-2.5-flare-edit
GPT Image 2.5 Sunburst

Generate images with GPT Image 2.5 Sunburst.

gpt-image-2.5-sunburst
GPT Image 2.5 Sunburst · Edit

Edit images with GPT Image 2.5 Sunburst.

gpt-image-2.5-sunburst-edit
Banana

Generate an image from text with Banana.

banana
Banana · Edit

Edit a source image with Banana.

banana-edit
Nano Banana 2

Generate an image from text with Nano Banana 2.

banana-2
Nano Banana 2 · Edit

Edit a source image with Nano Banana 2.

banana-2-edit
FLUX 2

Generate an image from text with FLUX 2.

flux-2
FLUX 2 · Edit

Edit a source image with FLUX 2.

flux-2-edit
Seedream 4.5

Generate an image from text with Seedream 4.5.

seedream-v4.5
Seedream 4.5 · Edit

Edit a source image with Seedream 4.5.

seedream-v4.5-edit
WAN 2.6 Image

Generate an image from text with WAN 2.6 Image.

wan-v2.6
WAN 2.6 Image · Edit

Edit a source image with WAN 2.6 Image.

wan-v2.6-edit
Recraft v3

Generate an image from text with Recraft v3.

recraft-v3
Recraft v3 · Edit

Edit a source image with Recraft v3.

recraft-v3-edit
Imagen 4 Preview

Generate an image from text with Imagen 4 Preview.

imagen4-preview
Imagen 4 Fast

Generate an image from text with Imagen 4 Fast.

imagen4-preview-fast
Imagen 4 Ultra

Generate an image from text with Imagen 4 Ultra.

imagen4-preview-ultra

Example request

This example uses Nano Banana Pro. Replace media URLs with your own files. The model reference documents all options and the matching status request.

cURL
curl --fail-with-body --max-time 120 -X POST "https://app.makeugc.ai/api/platform/enterprise/generate" \
  -H "X-Api-Key: $MAKEUGC_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "nano-banana-pro",
  "params": {
    "prompt": "A studio photograph of a ceramic coffee cup on a warm neutral background.",
    "resolution": "1k"
  }
}'
JavaScript
// Run on your server with Node.js 20+.
const apiKey = process.env.MAKEUGC_API_KEY;
if (!apiKey) throw new Error("Set MAKEUGC_API_KEY first");

const response = await fetch("https://app.makeugc.ai/api/platform/enterprise/generate", {
  method: "POST",
  headers: {
    "X-Api-Key": apiKey,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "nano-banana-pro",
  "params": {
    "prompt": "A studio photograph of a ceramic coffee cup on a warm neutral background.",
    "resolution": "1k"
  }
}),
  signal: AbortSignal.timeout(120000),
});
const text = await response.text();
if (!response.ok) {
  throw new Error(`HTTP ${response.status}: ${text} (request ${response.headers.get("x-request-id")})`);
}
const result = JSON.parse(text);
console.log(result);
Python
# Install the requests package before running.
import os
import requests

payload = {
    "model": "nano-banana-pro",
    "params": {
        "prompt": "A studio photograph of a ceramic coffee cup on a warm neutral background.",
        "resolution": "1k"
    }
}

response = requests.post(
    "https://app.makeugc.ai/api/platform/enterprise/generate",
    headers={"X-Api-Key": os.environ["MAKEUGC_API_KEY"]},
    json=payload,
    timeout=120,
)
if not response.ok:
    raise RuntimeError(f"HTTP {response.status_code}: {response.text} "
                       f"(request {response.headers.get('x-request-id')})")
print(response.json())

See Jobs & status for polling and result formats.