---
title: "Generate images with an image model"
method: POST
path: "/api/models/image/generations"
tags: ["Models"]
---

# Generate images with an image model

`POST /api/models/image/generations`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `x-sixb-csrf`
  - HTTP bearer
  - HTTP bearer

## Request body

- object
  - `model` object
    - `provider` string, required
    - `modelId` string, required
  - `prompt` string, required
  - `n` integer
  - `size` string
  - `aspectRatio` string
  - `quality` string
  - `style` string
  - `seed` integer
  - `images` object[]
    - `blobId` string, required
    - `digest` string, required
    - `sizeBytes` integer, required
    - `fileName` string
    - `mediaType` string
    - `logicalPath` string

## Response `200`

Response for status 200

- object
  - `callId` string, required
  - `model` object, required
    - `provider` string, required
    - `modelId` string, required
  - `usage` object, required
    - `inputTokens` integer
    - `outputTokens` integer
    - `uncachedInputTokens` integer
    - `cacheReadInputTokens` integer
    - `cacheWriteInputTokens` integer
    - `textOutputTokens` integer
    - `reasoningOutputTokens` integer
    - `imageOutputTokens` integer
    - `audioOutputTokens` integer
    - `outputImages` integer
    - `inputCharacters` integer
    - `audioDurationMs` integer
  - `cost` object, required
    - `status` 'reported' | 'rated' | 'unpriceable', required
    - `money` object
      - `currency` 'USD', required
      - `amountNanos` string, required
    - `reason` string
  - `files` object[], required
    - `blobId` string, required
    - `digest` string, required
    - `sizeBytes` integer, required
    - `fileName` string
    - `mediaType` string
    - `logicalPath` string
  - `warnings` string[], required

## Other responses

- `400`: Response for status 400
- `403`: Response for status 403
- `404`: Response for status 404
- `429`: Response for status 429
- `502`: Response for status 502

## Changes

- **2026-10-21** `54deed43546b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sixb-ai/apis/sixb-api/changes/api/models/image/generations/post.md)

---

[API](https://skmtc.dev/sixb-ai/apis/sixb-api.md) - [All operations](https://skmtc.dev/sixb-ai/apis/sixb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sixb-ai/apis/sixb-api/revisions/a227d682eaa2?raw)