跳转到主要内容
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>",
  "mode": "nai-diffusion-4-5-full",
  "image": [
    "1",
    "2",
    "3",
    "4"
  ],
  "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",
  "character_prompts": "<array>",
  "noise": "0.7",
  "hook_url": "<string>"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "job_id"
  }
}

授权

​
TT-API-KEY
string
header
必填

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

请求体

application/json
​
prompt
string
必填

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

​
mode
enum<string>
必填

使用模型

可用选项:
nai-diffusion-4-5-full,
nai-diffusion-4-5-curated
​
image
string
默认值:1
必填

垫图地址
图片url地址或者base64编码

示例:
["1", "2", "3", "4"]
​
n
integer
默认值:1

生成图片数量 1 - 4

示例:
["1", "2", "3", "4"]
​
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
array

角色列表 ，示例值：[{'prompt': 'string','uc': 'string','center': {'x': 0.5,'y': 0.5}}]

​
noise
number
默认值:0.7

图片噪声>=0 <=0.99

​
hook_url
string

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

响应

请求成功

​
status
string
必填
示例:

"SUCCESS"

​
message
string
必填
示例:

"success"

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