Перейти к основному содержанию
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"
  }
}
Ориентирован на генерацию изображений в аниме-стиле и поддерживает сценарии text-to-image, sketch-to-final и перерисовки изображения.

Авторизации

TT-API-KEY
string
header
обязательно

Вы можете получить API-ключ в TTAPI Dashboard.

Тело

application/json
prompt
string
обязательно

Описание изображения для генерации или изменения

model
enum<string>
по умолчанию:nai-diffusion-4-5-curated
обязательно

Model to use

Доступные опции:
nai-diffusion-4-5-full,
nai-diffusion-4-5-curated
n
integer
по умолчанию:1

Number of images to generate 1 - 4

width
integer
по умолчанию:1024

Image width

height
integer
по умолчанию:1024

Image height

seed
string

Seed

steps
integer
по умолчанию:23

Number of sampling steps

scale
number
по умолчанию: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
по умолчанию:true

Quality toggle

sampler
enum<string>
по умолчанию:Euler Ancestral

Sampler

Доступные опции:
Euler Ancestral,
Euler,
DPM++ 2S Ancestral,
DPM++ 2M SDE,
DPM++ 2M,
DPM++ SDE
noise_schedule
enum<string>
по умолчанию:karras

Noise schedule

Доступные опции:
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.

Ответ

Запрос выполнен успешно

status
string
обязательно
Пример:

"SUCCESS"

message
string
обязательно
Пример:

"success"

data
object
обязательно
Пример:
{
"job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
Last modified on March 25, 2026