Image generation and editing APIs

Use GPT Image, Google Nano Banana, or Grok to generate and edit images. Choose the model family, then follow its request format and image response handling.

Choose an image API

Generate GPT images

Generate GPT images and read the Base64 image data.

Edit GPT images

Upload source images and request a prompt-driven edit.

Generate Nano Banana images

Generate or edit images with Gemini generateContent.

Generate Grok images

Generate Grok images with URL or Base64 results.

Edit Grok images

Send source image URLs or data URIs in a JSON request.

Retrieve a GPT image task

Poll a GPT image request submitted with async enabled.

Generate an image

The examples below generate one GPT image with gpt-image-2. For Nano Banana or Grok, use the corresponding reference above.

Open Create an image to use the playground and endpoint schema.

import os
import requests

response = requests.post(
    "https://api.runbridge.ai/v1/images/generations",
    headers={
        "Authorization": "Bearer " + os.environ["RUNBRIDGE_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-image-2",
        "prompt": "A clean product photo of a glass teapot on a white table",
        "quality": "low",
        "size": "1024x1024",
        "output_format": "jpeg",
    },
    timeout=120,
)

response.raise_for_status()
result = response.json()
print(result["data"][0].keys())

const response = await fetch("https://api.runbridge.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RUNBRIDGE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2",
    prompt: "A clean product photo of a glass teapot on a white table",
    quality: "low",
    size: "1024x1024",
    output_format: "jpeg",
  }),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const result = await response.json();
console.log(Object.keys(result.data[0]));

curl https://api.runbridge.ai/v1/images/generations \
  -H "Authorization: Bearer $RUNBRIDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean product photo of a glass teapot on a white table",
    "quality": "low",
    "size": "1024x1024",
    "output_format": "jpeg"
  }'

Response example

GPT Image returns Base64 image data in data[].b64_json. Decode that value and save the image bytes. The response uses this shape:

{
  "created": 1779872000,
  "background": "opaque",
  "data": [
    {
      "b64_json": "<base64-encoded-jpeg>"
    }
  ],
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 19,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 19
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 215
  }
}

Common errors

Invalid model ID

Choose an image-capable model from the Models page.

Unsupported size

Use a size that the selected image endpoint accepts.

Expired result URL

Download Grok URL results promptly after generation completes.

Upload too large

Reduce the source image file size before sending the request again.

Missing image data

Read b64_json for GPT Image, final inlineData for Nano Banana, or the requested URL or Base64 field for Grok.

Error codes and retry strategy

400

Do not retry until the prompt, size, or image input is fixed.

401

Do not retry until the API key is present and valid.

404

Check the base URL, path, and model ID before retrying.

413

Reduce upload size before retrying.

429

Retry with exponential backoff and reduce concurrency.

500 or 503

Retry with backoff for transient service errors.

For implementation patterns, see Error codes and retry strategy and Rate limits and concurrency.

Pricing and model directory

Models page

Read how RunBridge AI exposes model IDs in the docs.

Model directory

Browse model availability and capabilities.

Pricing

Check pricing before you call a model.

​Choose an image API

Generate GPT images

Edit GPT images

Generate Nano Banana images

Generate Grok images

Edit Grok images

Retrieve a GPT image task

​Generate an image

​Response example

​Common errors

​Error codes and retry strategy

​Pricing and model directory

Models page

Model directory

Pricing

Choose an image API

Generate an image

Response example

Common errors

Error codes and retry strategy

Pricing and model directory