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"
  }
}
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. If not set, you need to call the fetch API 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 16, 2026