---
title: "Generate image"
method: POST
path: "/job/add/paperoffice_imagestudio___generate"
tags: ["Media AI — Image Studio"]
---

# Generate image

`POST /job/add/paperoffice_imagestudio___generate`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/job/add/paperoffice_imagestudio___generate`
- Auth: HTTP bearer

Image generate: POST /job/add/paperoffice_imagestudio___generate. Requires prompt. model basic|premium|ultra sets max size. output inline|base64|url (Postman default inline). precompile_prompt, inject_weather, force_location, num_images...

## Response `200`

Success

- object: Bild-Generierung Premium (max 1280x1280)
  - `status` 'success' | 'error', required: HTTP-Level Status
  - `job_id` string, required
  - `message` string: Human-readable status message
  - `pipeline` string: Name of the executed pipeline
  - `operation` string: Executed operation
  - `processing_time` string: Total processing time including queue (format: 123.45ms)
  - `result` object, required: The actual processing result
    - `status` 'completed' | 'failed' | 'timeout': Job-Level Status
    - `message` string: Pipeline-specific status message
    - `duration_ms` string: Pure pipeline processing time in ms
    - `output_files` object: Generated images as download URLs
    - `output` object: Output
      - `width` number
      - `height` number
      - `seed` number: Seed used for reproducibility
      - `steps` number
      - `guidance_scale` number

## Other responses

- `202`: Accepted — job continues in the background
- `4XX`: Error
- `5XX`: Error

---

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