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>",
  "mode": "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": "模糊画质,多余饰品"
    }
  ],
  "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": "https://example.com/callback"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}
基于Stable Diffusion技术二次开发,专注动漫风格图像生成,支持文生图、草图转正稿、图片重绘等功能。

Authorizations

TT-API-KEY
string
header
required

授权字段,控制台获取授权信息

Body

application/json
prompt
string
required

生成图像或修改图像描述词

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

使用模型

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

生成图片数量 1 - 4

width
integer
default:1024

图像宽度

height
integer
default:1024

图像高度

seed
string

种子

steps
integer
default:23

采样数

scale
number
default:5

人工智能对提示的响应程度较低的指导值可以产生更具绘画感和柔和的效果,而较高的指导值可以提供更精细的细节和更清晰的效果

negative_prompt
string

不想要的内容

quality_toggle
boolean
default:true

质量开关

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[]

角色列表

vibe_transfer
object[]

氛围转移参考

character_reference
object[]

精确参考

hook_url
string

回调地址,任务完成或失败将通过请地址进行通知,通知数据结构与fetch结构一致。如果未设置,则需要请求fetch接口进行查询

Example:

"https://example.com/callback"

Response

请求成功

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

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