Novel API

基于Stable Diffusion技术二次开发，专注动漫风格图像生成，支持文生图、草图转正稿、图片重绘等功能。

文生图

POST https://api.ttapi.io/novelai/text-to-image

使用novel产品文字生成图片

Headers

Name	Value
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: 角色信息 uc：不想要的内容 center：{ x：x轴,默认0.5 y：y轴,默认0.5 } }
hook_url	string	否	回调地址，任务完成或失败将通过请地址进行通知，通知数据结构与fetch结构一致。如果未设置，则需要请求fetch接口进行查询。

Response

200

{
    "data": {
        "jobId": "3b178ca1-78ee-41c1-94d7-3464b27a2439"
    },
    "message": "success",
    "status": "SUCCESS"
}

400

图生图

POST https://api.ttapi.io/novelai/image-to-image

使用novel产品文字生成图片

Headers

Name	Value
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
hook_url	string	否	回调地址，任务完成或失败将通过请地址进行通知，通知数据结构与fetch结构一致。如果未设置，则需要请求fetch接口进行查询。

Response

200

{
    "data": {
        "jobId": "3b178ca1-78ee-41c1-94d7-3464b27a2439"
    },
    "message": "success",
    "status": "SUCCESS"
}

400

查询任务结果

GET https://api.ttapi.io/novelai/fetch

通过jobId查询当前任务生成结果

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
jobId	String	是	生成的视频的jobId

Response

200

{
    "data": {
        "finishTime": "2026-02-12 09:09:11",
        "hookUrl": null,
        "imageUrl": [
            "https://cdn.ttapi.io/suno/2026-02-12/a5f6860a8e8243c0b57642871b3f1c44.png",
            "https://cdn.ttapi.io/suno/2026-02-12/b011be8e37e74f37b785fa49b9a4b278.png"
        ],
        "prompt": "1 young woman, professional talent service specialist, warm dark brown eyes, sleek black hair styled in a neat shoulder-length straight bob with soft side-swept bangs, wearing a tailored light blue blazer over a crisp white silk blouse, navy blue slim-fit dress pants, a small delicate silver wristwatch on the left wrist, a professional ID badge clipped to the lapel, black leather low-heeled pumps, gentle and approachable smile, friendly and professional appearance,solo,face front,full body,standing,full shot, white background, simple background, simple shadow,masterpiece, best quality,very aesthetic",
        "quota": "8.00"
    },
    "jobId": "3b178ca1-78ee-41c1-94d7-3464b27a2439",
    "message": "success",
    "status": "SUCCESS"
}

结果参数详解

参数	详解
status	结果状态， ON_QUEUE：执行中 SUCCESS：成功 FAILED：失败
message	成功失败信息
data.quota	实际消耗额度