---
title: "POST /flux/generate"
method: POST
path: "/flux/generate"
---

# POST /flux/generate

`POST /flux/generate`

Generate images using Flux.1 model based on text prompts. Note: Unlike Midjourney, this endpoint can only generate one image at a time

## Request body

- GenerateRequest
  - `prompt` string, required — Image description for generation or modification
  - `model` 'nai-diffusion-4-5-full' | 'nai-diffusion-4-5-curated', required — Model to use
  - `n` integer — Number of images to generate 1 - 4
  - `width` integer — Image width
  - `height` integer — Image height
  - `seed` string — Seed
  - `steps` integer — Number of sampling steps
  - `scale` number — A lower guidance scale produces softer, more painterly results. A higher guidance scale produces finer details and sharper effects.
  - `negative_prompt` string — Unwanted content
  - `quality_toggle` boolean — Quality toggle
  - `sampler` 'Euler Ancestral' | 'Euler' | 'DPM++ 2S Ancestral' | 'DPM++ 2M SDE' | 'DPM++ 2M' | 'DPM++ SDE' — Sampler
  - `noise_schedule` 'karras' | 'exponential' | 'polyexponential' — Noise schedule
  - `character_prompts` object[] — Character list
    - `prompt` string, required — Character information
    - `uc` string — Unwanted character content
    - `center` object, required — Character center coordinates in the frame
      - `x` number, required — X-axis coordinate (between 0-1)
      - `y` number, required — Y-axis coordinate (between 0-1)
  - `vibe_transfer` object[] — Atmosphere transfer reference
    - `image` string, required — Image, URL or base64
    - `strength` number — Reference strength >= 0 <= 1
  - `character_reference` object[] — Precise reference
    - `image` string, required — Image, URL or base64
    - `type` 'character&style' | 'character' | 'style' — Reference type
    - `strength` number — Reference strength >= 0 <= 1. A lower value gives the AI more creative freedom, a higher value makes AI follow the reference more closely, possibly replicating facial expressions, angles, and poses.
    - `fidelity` number — Fidelity >= 0 <= 1
  - `hook_url` string — Callback URL. The task completion or failure will be sent to this URL. The data structure is consistent with the <a href="fetch" target="_self">fetch structure</a>. If not set, you need to call the <a href="fetch" target="_self">fetch API</a> to query.

## Response `200`

Request successful

- object
  - `status` string, required
  - `message` string, required
  - `data` object, required

## Other responses

- `400` — Parameter error
- `401` — Authorization failed

---

[API](https://skmtc.net/ttapi/apis/flowmusic-api-docs.md) · [All operations](https://skmtc.net/ttapi/apis/flowmusic-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ttapi/flowmusic-api-docs/versions/f27f8a59dbd0/schema)