Example Usage
import { ImageGenerationRequest } from "@openrouter/sdk/models";
let value: ImageGenerationRequest = {
model: "bytedance-seed/seedream-4.5",
prompt: "a red panda astronaut floating in space, studio lighting",
};
Fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
aspectRatio | models.ImageGenerationRequestAspectRatio | :heavy_minus_sign: | Normalized aspect ratio of the generated image. Providers clamp to their supported subset. | 16:9 |
background | models.ImageGenerationRequestBackground | :heavy_minus_sign: | Background treatment. transparent requires an output_format that supports alpha (png or webp). | auto |
inputReferences | models.ContentPartImage[] | :heavy_minus_sign: | Reference images to guide image-to-image generation, as base64 data URLs or HTTP(S) URLs. | |
model | string | :heavy_check_mark: | The image generation model to use | bytedance-seed/seedream-4.5 |
n | number | :heavy_minus_sign: | Number of images to generate (1-10). Providers that only support single-image generation reject n > 1. | 1 |
outputCompression | number | :heavy_minus_sign: | Compression level (0-100) for webp/jpeg output. Ignored for png and by providers without a compression knob. | 100 |
outputFormat | models.ImageGenerationRequestOutputFormat | :heavy_minus_sign: | Encoding of the returned image bytes. Most models produce raster formats (png, jpeg, webp). SVG is supported by vectorization models (e.g. Quiver) — the SVG markup is UTF-8 base64-encoded in b64_json. | png |
prompt | string | :heavy_check_mark: | Text description of the desired image | a red panda astronaut floating in space, studio lighting |
provider | models.ImageGenerationProviderPreferences | :heavy_minus_sign: | Provider routing preferences and provider-specific passthrough configuration. | { “allow_fallbacks”: false, “only”: [ “google-ai-studio” ] } |
quality | models.ImageGenerationRequestQuality | :heavy_minus_sign: | Rendering quality. Providers without a quality knob ignore this. | high |
resolution | models.ImageGenerationRequestResolution | :heavy_minus_sign: | Normalized resolution tier of the generated image. Concrete pixel dimensions are derived per-provider. | 2K |
seed | number | :heavy_minus_sign: | If specified, the generation will sample deterministically, such that repeated requests with the same seed and parameters should return the same result. Determinism is not guaranteed for all providers. | |
size | string | :heavy_minus_sign: | Optional. A convenience shorthand for output dimensions — pass a tier (“2K”, “4K”) or explicit pixels (“2048x2048”) and we normalize it to the right dimensions for the chosen provider. A tier size is equivalent to setting resolution and combines with aspect_ratio. An explicit pixel size is authoritative: a mismatched resolution or aspect_ratio alongside it is rejected with a 400. | 2K |
stream | boolean | :heavy_minus_sign: | If true, partial images are streamed as SSE events as they become available. Only supported by providers with native streaming (currently OpenAI). Non-streaming providers ignore this flag and return a buffered response. |