Images

The image generation endpoint produces images from natural language prompts. It is OpenAI-compatible, so the openai SDK's images.generate call works without modification — just swap the base URL. It maps to POST /v1/images/generations.

Generate an image#

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://opendunes.com/api/v1",
  apiKey: process.env.OPENDUNES_API_KEY,
});

const resp = await client.images.generate({
  model: "google/gemini-2.5-flash-image",
  prompt: "An aerial view of the Sahara dunes at golden hour, photorealistic",
  size: "1024x1024",
  n: 1,
});

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

Images are stored on OpenDunes object storage and returned as a signed, time-limited URL in data[].url (not raw base64), so responses stay small. If the provider returns no image, the call fails with 502 no_image and you are not charged.

Editing and variations (images.edit, images.createVariation) are not yet supported — only generation is live.

Pricing#

Image generation is billed per output image — n images cost n × the model's per-image rate. Rates are shown in the model catalog. See the image API reference.