Skip to main content
POST
/
novelai
/
text-to-image
cURL
curl --request POST \
  --url https://api.ttapi.io/novelai/text-to-image \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "model": "nai-diffusion-4-5-curated",
  "n": 1,
  "width": 1024,
  "height": 1024,
  "seed": "<string>",
  "steps": 23,
  "scale": 5,
  "negative_prompt": "<string>",
  "quality_toggle": true,
  "sampler": "Euler Ancestral",
  "noise_schedule": "karras",
  "character_prompts": [
    {
      "prompt": "<string>",
      "center": {
        "x": 0.5,
        "y": 0.5
      },
      "uc": "blurred, extra accessories"
    }
  ],
  "vibe_transfer": [
    {
      "image": "https://example.com/ref1.jpg",
      "strength": 0.6
    }
  ],
  "character_reference": [
    {
      "image": "https://example.com/ref2.jpg",
      "type": "character&style",
      "strength": 1,
      "fidelity": 0
    }
  ],
  "hook_url": "<string>"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt

Use this file to discover all available pages before exploring further.

Focused on anime-style image generation, supporting text-to-image, sketch-to-final, and image redraw functionalities.

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
​
prompt
string
required

Image description for generation or modification

​
model
enum<string>
default:nai-diffusion-4-5-curated
required

Model to use

Available options:
nai-diffusion-4-5-full,
nai-diffusion-4-5-curated
​
n
integer
default:1

Number of images to generate 1 - 4

​
width
integer
default:1024

Image width

​
height
integer
default:1024

Image height

​
seed
string

Seed

​
steps
integer
default:23

Number of sampling steps

​
scale
number
default:5

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
default:true

Quality toggle

​
sampler
enum<string>
default:Euler Ancestral

Sampler

Available options:
Euler Ancestral,
Euler,
DPM++ 2S Ancestral,
DPM++ 2M SDE,
DPM++ 2M,
DPM++ SDE
​
noise_schedule
enum<string>
default:karras

Noise schedule

Available options:
karras,
exponential,
polyexponential
​
character_prompts
object[]

Character list

​
vibe_transfer
object[]

Atmosphere transfer reference

​
character_reference
object[]

Precise reference

​
hook_url
string

Callback URL. The task completion or failure will be sent to this URL. The data structure is consistent with the fetch structure [blocked]. If not set, you need to call the fetch API [blocked] to query.

Response

Request successful

​
status
string
required
Example:

"SUCCESS"

​
message
string
required
Example:

"success"

​
data
object
required
Example:
{
  "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
Last modified on March 21, 2026