跳转到主要内容
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-full",
  "character_reference": [
    {
      "image": "https://example.com/ref2.jpg",
      "type": "character&style",
      "strength": 1,
      "fidelity": 0
    }
  ],
  "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": {
        "base_desc": "金发双马尾少女，日系动漫风格",
        "style_limit": "赛博朋克服饰，机械义肢",
        "feature_emphasis": "红色眼眸，微笑表情，手持樱花枝"
      },
      "uc": "模糊画质，多余饰品",
      "center": {
        "x": 0.5,
        "y": 0.5
      }
    }
  ],
  "vibe_transfer": [
    {
      "image": "https://example.com/ref1.jpg",
      "strength": 0.6
    }
  ],
  "hook_url": "https://example.com/callback"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "job_id"
  }
}
基于Stable Diffusion技术二次开发，专注动漫风格图像生成，支持文生图、草图转正稿、图片重绘等功能。

授权

​
TT-API-KEY
string
header
必填

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

请求体

application/json
​
prompt
string
必填

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

​
mode
enum<string>
必填

使用模型

可用选项:
nai-diffusion-4-5-full,
nai-diffusion-4-5-curated
​
character_reference
object[]
必填

精确参考

示例:
[
  {
    "image": "https://example.com/ref2.jpg",
    "type": "character&style",
    "strength": 1,
    "fidelity": 0
  }
]
​
n
integer
默认值:1

生成图片数量 1 - 4

示例:

1

​
width
integer
默认值:1024

图像宽度

​
height
integer
默认值:1024

图像高度

​
seed
string

种子

​
steps
integer
默认值:23

步骤数

​
scale
number
默认值:5

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

​
negative_prompt
string

不想要的内容

​
quality_toggle
boolean
默认值:true

质量开关

​
sampler
enum<string>
默认值:Euler Ancestral

采样器（枚举值）

可用选项:
Euler Ancestral,
Euler,
DPM++ 2S Ancestral,
DPM++ 2M SDE,
DPM++ 2M,
DPM++ SDE
​
noise_schedule
enum<string>
默认值:karras

噪声曲线（枚举值）

可用选项:
karras,
exponential,
polyexponential
​
character_prompts
object[]

角色列表

示例:
[
  {
    "prompt": {
      "base_desc": "金发双马尾少女，日系动漫风格",
      "style_limit": "赛博朋克服饰，机械义肢",
      "feature_emphasis": "红色眼眸，微笑表情，手持樱花枝"
    },
    "uc": "模糊画质，多余饰品",
    "center": { "x": 0.5, "y": 0.5 }
  }
]
​
vibe_transfer
object[]

氛围转移参考

示例:
[
  {
    "image": "https://example.com/ref1.jpg",
    "strength": 0.6
  }
]
​
hook_url
string

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

示例:

"https://example.com/callback"

响应

请求成功

​
status
string
必填
示例:

"SUCCESS"

​
message
string
必填
示例:

"success"

​
data
object
必填
示例:
{ "job_id": "job_id" }
Last modified on March 12, 2026