---
title: "POST /novelai/image-to-image"
method: POST
path: "/novelai/image-to-image"
---

# POST /novelai/image-to-image

`POST /novelai/image-to-image`

## Request body

- ImageRequest
  - `prompt` string, required — Image description for generation or modification
  - `model` 'nai-diffusion-4-5-full' | 'nai-diffusion-4-5-curated', required — Model to use
  - `image` string, required — Reference image URL or base64
  - `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
  - `noise` number — Image noise, 0 <= noise <= 0.99
  - `strength` number — Strength, 0.01 <= strength <= 0.99
  - `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. Task completion or failure will be sent to this URL. Data structure matches the <a href="fetch" target="_self">fetch structure</a>.

## 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)