Novel API
基于Stable Diffusion技术二次开发，专注动漫风格图像生成，支持文生图、草图转正稿、图片重绘等功能。
此文档已停止维护，最新文档地址：https://docs.ttapi.io
文生图
POST https://api.ttapi.io/novelai/text-to-image
使用novel产品文字生成图片
Headers
Content-Type
application/json
TT-API-KEY
用于请求授权 TT-API 的API密钥
Body
prompt
string
是
生成图像的提示词
model
string
是
使用模型：
nai-diffusion-4-5-full
nai-diffusion-4-5-curated
n
integer
否
生成图片数量 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
string
否
采样器（枚举值）
可选：
Euler Ancestral
Euler
DPM++ 2S Ancestral
DPM++ 2M SDE
DPM++ 2M
DPM++ SDE
默认：Euler Ancestral
noise_schedule
string
否
噪声曲线（枚举值）
可选：
karras exponential polyexponential
默认：karras
character_prompts
array[object]
否
角色列表，示例值： [ { "prompt": "string", "uc": "string", "center": { "x": 0.5, "y": 0.5 } } ]
character_prompts.prompt
string
否
角色信息
character_prompts.uc
string
否
不想要的内容
character_prompts.center
object
否
坐标
character_prompts.center.x
number
否
x轴
character_prompts.center.y
number
否
y轴
vibe_transfer
array[object]
否
氛围转移参考，示例值： [ { "image": "string", "strength": 0.6 } ]
vibe_transfer.image
string
图像，url或base64
vibe_transfer.strength
number
参考强度 ≥ 0 <= 1, 默认值0.6
character_reference
array[object]
否
精确参考，示例值 [ { "image": "string", "type": "character&style", "strength": 1, "fidelity": 0 } ]
character_reference.image
string
是
图像，url或base64
character_reference.type
string
否
参考类型，可选范围：character&style character style
默认值 character&style
character_reference.strength
number
否
参考强度 ≥ 0 <= 1, 默认值1 AI 会越来越依赖于参考图像中的风格特征、配色方案和其他视觉特征。此设置值越低，AI 的创作自由度就越大。相反，值越高，参考图像对输出的影响就越大，这可能导致面部表情、角度和人物姿势与参考图像过于相似
character_reference.fidelity
number
否
保真度 ≥ 0 <= 1, 默认值0
Response
图生图
POST https://api.ttapi.io/novelai/image-to-image
使用novel产品文字生成图片
Headers
Content-Type
application/json
TT-API-KEY
用于请求授权 TT-API 的API密钥
Body
prompt
string
是
生成图像的提示词
model
string
是
使用模型：
nai-diffusion-4-5-full
nai-diffusion-4-5-curated
image
string
是
垫图地址 图片url地址或者base64编码
n
integer
否
生成图片数量 1 - 4 默认 1
width
integer
否
图像宽度
默认 1024
height
integer
否
图像高度
默认 1024
seed
string
否
种子
step
integer
否
步骤数 默认值：23
scale
number
否
人工智能对提示的响应程度 较低的指导值可以产生更具绘画感和柔和的效果，而较高的指导值可以提供更精细的细节和更清晰的效果
默认值: 5
negative_prompt
string
否
不想要的内容
quality_toggle
boolean
否
质量开关
默认 true
sampler
string
否
采样器（枚举值）
可选：
Euler Ancestral
Euler
DPM++ 2S Ancestral
DPM++ 2M SDE
DPM++ 2M
DPM++ SDE
默认：Euler Ancestral
noise_schedule
string
否
噪声曲线（枚举值）
可选：
karras exponential polyexponential
默认：karras
character_prompts
array[object]
否
{ prompt: 角色信息 uc：不想要的内容 center：{ x：x轴,默认0.5 y：y轴,默认0.5
} }
noise
number
否
图片噪声
>=0 <=0.99 默认值：0
strength
number
否
图片强度
>=0.01 <=0.99 默认值：0.7
Response
查询任务结果
GET https://api.ttapi.io/novelai/fetch
通过jobId查询当前任务生成结果
Headers
Content-Type
application/json
TT-API-KEY
用于请求授权 TT-API 的API密钥
Body
jobId
String
是
生成的视频的jobId
Response
结果参数详解
status
结果状态， ON_QUEUE：执行中 SUCCESS：成功 FAILED：失败
message
成功失败信息
data.quota
实际消耗额度
Last updated