Skip to main content
POST
/
v2
/
images
/
generations
Node.js
import GetimgAI from "getimg-ai";

const client = new GetimgAI();

const result = await client.images.generate({
  model: "seedream-5-lite",
  prompt: "A cinematic portrait of a cat astronaut",
  aspect_ratio: "1:1",
  resolution: "2K",
  output_format: "jpeg",
});
{
  "id": "req-01HXYZABCD1234",
  "status": "completed",
  "model": "seedream-5-lite",
  "data": [
    {
      "url": "https://api.getimg.ai/v2/downloads/req-01HXYZABCD1234/0?exp=1760000000&sig=1d9c2f6f4f7f6c03e5c58a4e6fd8b5b8e2d0c2f5f9e1a4cfe8c0e9d9a8b7c6d5",
      "width": 1024,
      "height": 1024,
      "mime_type": "image/png",
      "deletes_at": "2026-05-02T12:30:00.000Z"
    }
  ],
  "usage": {
    "total_cost": 0.04,
    "billable_unit": "image",
    "unit_price": 0.04,
    "quantity": 1
  }
}

Authorizations

​
Authorization
string
header
required

Send your API key as a bearer token: Authorization: Bearer sk_<secret>.

Body

application/json
​
model
string
required

AI model ID. See supported models.

​
prompt
string
required

Description of the image to generate or an editing instruction.

Required string length: 1 - 4096
​
images
object[]
Maximum array length: 8
​
aspect_ratio
string

Optional output aspect ratio. See supported values by model.

​
resolution
string

Optional output resolution. See supported values by model.

​
output_format
enum<string>
default:jpeg

Output image format.

Available options:
png,
jpeg,
webp

Response

Image generation completed.

​
id
string
required

The ID of the generation request.

​
status
string
required
Allowed value: "completed"
​
model
string
required

The model used for the generation.

​
data
object[]
required

The media items for the generation.

​
usage
object
required