Generating Images - Routeway Docs

Basic Generation

Generate an image by providing a model and a text prompt.

Python
Node.js
cURL

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.routeway.ai/v1",
    api_key=os.getenv("ROUTEWAY_API_KEY"),
)

response = client.images.generate(
    model="gpt-image-1",
    prompt="A watercolor painting of a mountain lake at dawn",
)

print(response.data[0].url)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.routeway.ai/v1",
  apiKey: process.env.ROUTEWAY_API_KEY,
});

const response = await client.images.generate({
  model: "gpt-image-1",
  prompt: "A watercolor painting of a mountain lake at dawn",
});

console.log(response.data[0].url);

curl -X POST https://api.routeway.ai/v1/images/generations \
  -H "Authorization: Bearer $ROUTEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A watercolor painting of a mountain lake at dawn"
  }'

Image Sizes

Control the output dimensions with the size parameter.

Size	Aspect Ratio	Best For
`1024x1024`	1:1	Square images, avatars, icons
`1792x1024`	16:9	Landscape, banners, headers
`1024x1792`	9:16	Portrait, mobile wallpapers, stories

Python
Node.js
cURL

response = client.images.generate(
    model="gpt-image-1",
    prompt="A panoramic view of a tropical beach",
    size="1792x1024",
)

const response = await client.images.generate({
  model: "gpt-image-1",
  prompt: "A panoramic view of a tropical beach",
  size: "1792x1024",
});

curl -X POST https://api.routeway.ai/v1/images/generations \
  -H "Authorization: Bearer $ROUTEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A panoramic view of a tropical beach",
    "size": "1792x1024"
  }'

Quality Settings

The quality parameter controls the detail level and generation time.

Quality	Description
`auto`	Automatically selects the best quality for the prompt.
`low`	Fastest generation, lower detail.
`medium`	Balanced speed and detail.
`high`	Maximum detail, slower generation.

Use auto for most use cases. It provides the best balance without manual tuning.

Generating Multiple Images

Set n to generate multiple images in a single request.

Python
Node.js
cURL

response = client.images.generate(
    model="gpt-image-1",
    prompt="A minimalist logo for a coffee shop",
    n=4,
    size="1024x1024",
)

for i, image in enumerate(response.data):
    print(f"Image {i + 1}: {image.url}")

const response = await client.images.generate({
  model: "gpt-image-1",
  prompt: "A minimalist logo for a coffee shop",
  n: 4,
  size: "1024x1024",
});

response.data.forEach((image, i) => {
  console.log(`Image ${i + 1}: ${image.url}`);
});

curl -X POST https://api.routeway.ai/v1/images/generations \
  -H "Authorization: Bearer $ROUTEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A minimalist logo for a coffee shop",
    "n": 4,
    "size": "1024x1024"
  }'

Generating multiple images multiplies token/credit usage accordingly.

Response Format

Choose between a temporary URL or base64-encoded image data.

Format	Use Case
`url`	Default. Returns a short-lived URL to download the image.
`b64_json`	Returns the image as a base64-encoded string for direct embedding or saving.

URLs are temporary and expire after a short period. If you need to persist the image, download it immediately or use b64_json.

Saving Images Locally

Python
Node.js
cURL

import base64

response = client.images.generate(
    model="gpt-image-1",
    prompt="A detailed sketch of a cat wearing a top hat",
    response_format="b64_json",
)

image_data = base64.b64decode(response.data[0].b64_json)

with open("output.png", "wb") as f:
    f.write(image_data)

print("Image saved to output.png")

import fs from "fs";

const response = await client.images.generate({
  model: "gpt-image-1",
  prompt: "A detailed sketch of a cat wearing a top hat",
  response_format: "b64_json",
});

const imageBuffer = Buffer.from(response.data[0].b64_json, "base64");
fs.writeFileSync("output.png", imageBuffer);

console.log("Image saved to output.png");

curl -X POST https://api.routeway.ai/v1/images/generations \
  -H "Authorization: Bearer $ROUTEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A detailed sketch of a cat wearing a top hat",
    "response_format": "b64_json"
  }' | jq -r '.data[0].b64_json' | base64 -d > output.png

Tips for Better Prompts

Be specific and descriptive

Instead of “a dog”, try “a golden retriever sitting in a sunlit meadow, photorealistic, soft bokeh background”. More detail gives the model stronger guidance.

Specify a style

Include style cues like “watercolor”, “3D render”, “pixel art”, “oil painting”, or “studio photography” to steer the aesthetic.

Describe composition

Mention framing details such as “close-up”, “bird’s-eye view”, “centered”, or “rule of thirds” for more intentional compositions.

​Basic Generation

​Image Sizes

​Quality Settings

​Generating Multiple Images

​Response Format

​Saving Images Locally

​Tips for Better Prompts

Basic Generation

Image Sizes

Quality Settings

Generating Multiple Images

Response Format

Saving Images Locally

Tips for Better Prompts