Image Generation

Generate images from text prompts using models like FLUX.1, FLUX.2, and others.

Endpoint

POST https://api.runcrate.ai/v1/images/generations

Basic Usage

curl https://api.runcrate.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer rc_live_YOUR_API_KEY" \
  -d '{
    "model": "black-forest-labs/FLUX.1-schnell",
    "prompt": "A futuristic cityscape at sunset, cyberpunk style",
    "aspect_ratio": "16:9"
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.runcrate.ai/v1",
    api_key="rc_live_YOUR_API_KEY",
)

response = client.images.generate(
    model="black-forest-labs/FLUX.1-schnell",
    prompt="A futuristic cityscape at sunset, cyberpunk style",
)
print(response.data[0].url)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.runcrate.ai/v1",
  apiKey: "rc_live_YOUR_API_KEY",
});

const response = await client.images.generate({
  model: "black-forest-labs/FLUX.1-schnell",
  prompt: "A futuristic cityscape at sunset, cyberpunk style",
});
console.log(response.data[0].url);

Parameters

Parameters vary by model. Common parameters include:

Parameter	Type	Description
`model`	string	Model ID (required)
`prompt`	string	Text description of the image (required)
`aspect_ratio`	string	Output ratio: `1:1`, `16:9`, `9:16`, `4:3`, `3:2`, etc.
`num_inference_steps`	integer	Number of diffusion steps (higher = more detail, slower)
`guidance`	number	How closely to follow the prompt
`seed`	integer	Reproducibility seed (omit for random)
`negative_prompt`	string	What to avoid in the image

Model-Specific Parameters

Some models support additional inputs:

FLUX Kontext models: Accept input_image for image editing
FLUX Canny: Requires control_image for edge-guided generation
FLUX.2 Pro: Accepts up to 8 input_images for reference-based generation
FLUX Dev/Krea: Accept image for img2img mode with prompt_strength control

Check the Playground to see the exact parameters available for each model.

Response

{
  "data": [
    {
      "url": "https://...",
      "b64_json": "..."
    }
  ]
}

The response includes either a url to the generated image or b64_json base64-encoded image data.

Available Image Models

Model	Speed	Quality	Notes
FLUX.1 Schnell	Fast	Good	Best for rapid prototyping
FLUX.1 Dev	Medium	High	Open-weights, img2img support
FLUX.1 Pro	Medium	Very High	Production-grade
FLUX.1.1 Pro	Medium	Very High	Updated Pro model
FLUX.2 Pro	Medium	Highest	Up to 4MP, multi-reference
FLUX Kontext	Medium	High	Image editing and generation

Welcome

SDKs

CLI

Inference

Compute

Storage

Dedicated Clusters

Billing

Account

FAQ

Endpoint

Basic Usage

Parameters

Model-Specific Parameters

Response

Available Image Models

​Endpoint

​Basic Usage

​Parameters

​Model-Specific Parameters

​Response

​Available Image Models

Endpoint

Basic Usage

Parameters

Model-Specific Parameters

Response

Available Image Models