Skip to main content
POST
/
novelai
/
image-to-image
cURL
curl --request POST \
  --url https://api.ttapi.io/novelai/image-to-image \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "model": "nai-diffusion-4-5-full",
  "image": "https://xxx.png",
  "n": [
    "1",
    "2",
    "3",
    "4"
  ],
  "width": "1024",
  "height": "1024",
  "seed": "<string>",
  "steps": "23",
  "scale": "5",
  "negative_prompt": "<string>",
  "quality_toggle": "true",
  "sampler": "Euler Ancestral",
  "noise_schedule": "karras",
  "noise": 0,
  "strength": 0.7,
  "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"
  }
}

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>
required

Model to use

Available options:
nai-diffusion-4-5-full,
nai-diffusion-4-5-curated
​
image
string
required

Reference image URL or base64

Example:

"https://xxx.png"

​
n
integer
default:1

Number of images to generate 1 - 4

Example:
["1", "2", "3", "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
​
noise
number
default:0

Image noise, 0 <= noise <= 0.99

​
strength
number
default:0.7

Strength, 0.01 <= strength <= 0.99

​
character_prompts
object[]

Character list

​
vibe_transfer
object[]

Atmosphere transfer reference

​
character_reference
object[]

Precise reference

​
hook_url
string

Callback URL. Task completion or failure will be sent to this URL. Data structure matches the fetch structure.

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