概览

本文档描述了基于 NovelAI 扩散模型的图像生成接口。接口协议完全兼容 OpenAI Chat Completions API 标准，支持流式 (SSE) 返回，并提供了原生的图片生成参数控制能力。

模型列表

当前支持以下模型 ID，每个模型都有其独特的风格：

API 端点

请求参数详解

以下参数适用于 /v1/chat/completions 接口。

进阶玩法

1. 图片尺寸控制

您可以通过两种方式指定尺寸。如果指定的尺寸不在支持列表中，将返回错误。

• 832:1216 - 竖版（适合人像、手机壁纸）
• 1216:832 - 横版（适合风景、桌面壁纸，默认值）
• 1024:1024 - 正方形（适合头像）

方式一：使用 size 参数（推荐）

{
  "model": "nai-diffusion-4-5-full",
  "size": "1024:1024",
  "messages": [...]
}

方式二：在提示词中直接指定

支持使用 : 或 * 分隔。尺寸信息会自动从提示词中移除。

"content": "beautiful landscape 1024:1024"
"content": "portrait 832*1216"

2. 反向提示词 (Negative Prompt)

用于排除画面中的负面元素。支持在 JSON 顶层字段中设置。

{
  "negative_prompt": "blurry, lowres, bad quality, worst quality, ugly, deformed, text, watermark"
}

3. Parameter{...} 高级语法

您可以在提示词内容中使用 Parameter{...} 语法一次性指定所有生成参数。这在某些无法修改 JSON 结构的客户端中非常有用。

语法格式： Parameter{key:value,key2:value}

优先级说明： Parameter{...} > JSON 请求参数 > 默认值。

支持的参数键：

• size / width / height
• negative_prompt
• sampler
• scale (CFG Scale)
• steps (采样步数)
• seed (随机种子)
• model (可在此处覆盖请求体中的模型)

示例：

"content": "anime girl Parameter{size:832:1216,sampler:Euler Ancestral,scale:7,steps:28,negative_prompt:blurry,low quality}"

响应结构

1. 非流式响应 (Stream: false)

{
  "id": "nai-img-123",
  "object": "chat.completion",
  "created": 1700000000,
  "model": "nai-diffusion-4-5-full",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "/img/generated_image.png"
      },
      "finish_reason": "stop"
    }
  ]
}

2. 流式响应 (Stream: true)

返回 SSE (Server-Sent Events) 事件流。主要包含三个阶段：

1. 排队/进度：通过 reasoning_content 字段返回进度文本。
2. 结果：通过 content 字段返回 Markdown 格式图片链接。
3. 结束：发送 [DONE]。

// 阶段 1: 进度更新
data: {"choices":[{"delta":{"reasoning_content":"🎨 正在生成图片，进度 30%"}}]}

// 阶段 2: 返回图片
data: {"choices":[{"delta":{"content":"![image](http://url.com/img.png)\n"},"finish_reason":"stop"}]}

// 阶段 3: 完成
data: {"choices":[{"delta":{"content":"✅ 图片生成完成！"}}]}

data: [DONE]

代码示例

Python (Requests)

import requests
import json

url = "/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-your-key"
}
data = {
    "model": "nai-diffusion-4-5-full",
    "messages": [{"role": "user", "content": "beautiful landscape, best quality"}],
    "size": "1216:832",
    "stream": True
}

response = requests.post(url, json=data, headers=headers, stream=True)

for line in response.iter_lines():
    if line:
        line_str = line.decode('utf-8')
        if line_str.startswith('data: '):
            print(line_str)

cURL

curl -X POST /v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-key" \
  -d '{
    "model": "nai-diffusion-4-5-full",
    "messages": [{"role": "user", "content": "1girl, solo, portrait"}],
    "size": "832:1216",
    "negative_prompt": "lowres, bad quality"
  }'

错误处理

API 使用标准 HTTP 状态码和 JSON 错误对象。