Image generation

diffusion-4-5-full uses the same parameter set as diffusion-4-5-curated: prompt, images, negative_prompt, n, size, seed, steps, scale, quality_toggle, sampler, noise_schedule, character_prompts, hook_url and response_format.

n is 1~4. A maximum of 1 ordinary image source image can be used; vibe_transfer and character_reference cannot be used at the same time. NovelAI does not have a standalone JSON editing endpoint, editing is still done through the images of this generated endpoint.

POST https://api.tikway.ai/v1/images/generations

cURL

Text to image

curl --request POST \
  --url https://api.tikway.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "diffusion-4-5-full",
  "prompt": "A serene Japanese garden at dawn, mist above a koi pond, cinematic lighting, highly detailed",
  "negative_prompt": "lowres, blurry, text, watermark",
  "size": "1024x1536",
  "n": 1,
  "steps": 28,
  "scale": 5,
  "sampler": "Euler Ancestral",
  "noise_schedule": "karras"
}
'

200

{
  "created": 1713833628,
  "background": "opaque",
  "data": [
    {
      "b64_json": "...",
      "index": 0
    }
  ],
  "output_format": "png",
  "size": "1024x768"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

NovelAI image generation Request Body. The unified reference image uses images; the gateway is responsible for converting to TTAPI NovelAI native parameters.

model · enum<string> · required

Required. The NovelAI Diffusion V4.5 model currently connected to TTAPI.

Available options: diffusion-4-5-full, diffusion-4-5-curated

Minimum string length: 1

Examples:

"diffusion-4-5-full"

"diffusion-4-5-curated"

prompt · string · required

Positive cue words.

Required string length: 1 - 32000

images · object[]

Optional. Unified reference map array. type=image (or omitted) is the source image of a single image; type=vibe_transfer is the atmosphere reference; type=character_reference is the precise character/style reference. There can only be one ordinary image source image, and vibe_transfer and character_reference cannot be mixed.

Maximum array length: 16

Hide child attributes

images. image_url · string<uri> · required

Minimum string length: 1

images. type · any

image or null is the image source image; the remaining values represent the NovelAI reference image type.

Available options: image, vibe_transfer, character_reference, null

images. strength · number

Reference strength. The maximum value of the plot is 0.99.

Required range: 0 <= x <= 1

images. fidelity · number

Fidelity. The graph is converted to noise = 1 - fidelity.

Required range: 0 <= x <= 1

images. ref_type · enum<string> · default: character&style

Only used by character_reference.

Available options: character, style, character&style

negative_prompt · string

Negative cue words.

n · integer · default: 1

Number of images generated.

Required range: 1 <= x <= 4

size · string · default: 1024x1024

Output dimensions, converted by gateway to width and height.

Pattern: ^[1-9][0-9]*x[1-9][0-9]*$

seed · string integer

Random seed.

steps · integer · default: 23

Number of sampling steps.

Required range: x >= 1

scale · number · default: 5

Cue words guide intensity.

quality_toggle · boolean · default: true

Quality switch.

sampler · enum<string> · default: Euler Ancestral

Available options: Euler Ancestral, Euler, DPM++ 2S Ancestral, DPM++ 2M SDE, DPM++ 2M, DPM++ SDE

noise_schedule · enum<string> · default: karras

Available options: karras, exponential, polyexponential

character_prompts · object[]

Hide child attributes

character_prompts. prompt · string

character_prompts. uc · string

character_prompts. center · object

Hide child attributes

character_prompts.center. x · number

Required range: 0 <= x <= 1

character_prompts.center. y · number

Required range: 0 <= x <= 1

response_format · enum<string> · default: b64_json

Fixed returning Base64 image so that the response conforms to the Response Schema of this interface.

Available options: b64_json, url

hook_url · string<uri>

Optional. The callback address when the TTAPI task completes or fails.

Response

200 - application/json

created · integer · required

The Unix timestamp (in seconds) when the gateway completed image conversion.

data · object[] · required

Generated image list.

Minimum array length: 1

Hide child attributes

data. b64_json · string · required

The gateway downloads and converts image data into Base64.

data. index · integer · required

The index of the image in the results list.

Required range: x >= 0

background · enum<string>

Background settings inferred from unified inbound requests; NovelAI raw responses are typically not echoed.

Available options: transparent, opaque

output_format · enum<string>

The format inferred from the downloaded image MIME type or request output_format.

Available options: png, jpeg, webp

quality · enum<string>

Unified quality field; if quality is requested, the gateway will map and echo it.

Available options: low, medium, high

size · string

The size of the original request; NovelAI's original response is usually not echoed.