图片生成

diffusion-4-5-full 与 diffusion-4-5-curated 使用相同参数集：prompt、images、negative_prompt、n、size、seed、steps、scale、quality_toggle、sampler、noise_schedule、character_prompts 和 response_format。

n 为 1～4。普通图生图源图最多 1 张；vibe_transfer 与 character_reference 不能同时使用。图生图通过本生成接口的 images 传入源图。

POST https://api.tikway.ai/v1/images/generations

cURL

文生图

curl --request POST \ --url https://api.tikway.ai/v1/images/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "diffusion-4-5-full", "prompt": "A serene Japanese garden at dawn, mist above a koi pond, cinematic lighting, highly detailed", "negative_prompt": "lowres, blurry, text, watermark", "size": "1024x1536", "n": 1, "steps": 28, "scale": 5, "sampler": "Euler Ancestral", "noise_schedule": "karras" } '

200

{
  "created": 1713833628,
  "background": "opaque",
  "data": [
    {
      "b64_json": "...",
      "index": 0
    }
  ],
  "output_format": "png",
  "size": "1024x768"
}

授权

Authorization · string · header · 必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

NovelAI 图片生成 Request Body。统一参考图使用 images；使用统一 images 传入参考图。

model · string · 必填

必填。使用 Get Models 返回的模型 ID 或可用别名。

Minimum string length: 1

示例:

"diffusion-4-5-full"

"diffusion-4-5-curated"

prompt · string · 必填

正向提示词。

Required string length: 1 - 32000

images · object[]

可选。统一参考图数组。type=image（或省略）为单张图生图源图；type=vibe_transfer 为氛围参考；type=character_reference 为精确角色/风格参考。只能有 1 张普通图生图源图，vibe_transfer 与 character_reference 不能混用。

Maximum array length: 16

Hide child attributes

images. image_url · string<uri> · 必填

Minimum string length: 1

images. type · any

image 或 null 为图生图源图；其余值表示 NovelAI 参考图类型。

可用选项: image, vibe_transfer, character_reference, null

images. strength · number

参考强度。图生图最大值为 0.99。

必填范围: 0 <= x <= 1

images. fidelity · number

保真度。图生图会转换为 noise = 1 - fidelity。

必填范围: 0 <= x <= 1

images. ref_type · enum<string> · 默认值: character&style

仅 character_reference 使用。

可用选项: character, style, character&style

negative_prompt · string

负向提示词。

n · integer · 默认值: 1

生成图片数量。

必填范围: 1 <= x <= 4

size · string · 默认值: 1024x1024

输出尺寸，网关转换为 width 和 height。

Pattern: ^[1-9][0-9]*x[1-9][0-9]*$

seed · string integer

随机种子。

steps · integer · 默认值: 23

采样步数。

必填范围: x >= 1

scale · number · 默认值: 5

提示词引导强度。

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

Hide child attributes

character_prompts. prompt · string

character_prompts. uc · string

character_prompts. center · object

Hide child attributes

character_prompts.center. x · number

必填范围: 0 <= x <= 1

character_prompts.center. y · number

必填范围: 0 <= x <= 1

response_format · enum<string> · 默认值: url

Tikway 图片交付格式，url 返回图片链接，b64_json 返回纯 Base64。默认 url；该字段由网关消费，不作为上游模型参数。

可用选项: b64_json, url

响应

200 - application/json

created · integer · 必填

网关完成图片转换时的 Unix 时间戳（秒）。

data · object[] · 必填

生成的图片列表。

Minimum array length: 1

Hide child attributes

data. b64_json · string · 必填

网关下载并转成 Base64 的图片数据。

data. index · integer · 必填

图片在结果列表中的索引。

必填范围: x >= 0

background · enum<string>

根据统一入站请求推断的背景设置；NovelAI 原始响应通常不回显。

可用选项: transparent, opaque

output_format · enum<string>

从下载图片 MIME 类型或请求 output_format 推断出的格式。

可用选项: png, jpeg, webp

quality · enum<string>

统一质量字段；若请求提供 quality，网关会映射后回显。

可用选项: low, medium, high

size · string

原始请求的 size；NovelAI 原始响应通常不回显。