星渊 API 指南

外观

NovelAI 绘图 ​

渊站的 NovelAI 走的是标准的图像生成接口，不需要单独学一套 SDK。

分组与模型 ​

Noveai 分组下现在有这些：

模型说明
nai-diffusion-5-fullV5 完整版
nai-diffusion-5-curatedV5 精选版，出图更稳
nai-diffusion-4-5-fullV4.5 完整版
nai-diffusion-4-5-curatedV4.5 精选版
nai-diffusion-4-fullV4 完整版
director-tools导演工具

请求 ​

POST /v1/images/generations

bash
curl https://api.syuan.org/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nai-diffusion-5-full",
    "prompt": "1girl, white hair, soft light",
    "n": 1
  }'

返回 ​

图片以 base64 返回，在 data[0].b64_json 里：

json
{
  "data": [
    {
      "url": "",
      "b64_json": "iVBORw0KGgoAAAANSUhEUg..."
    }
  ]
}

url 是空的——NovelAI 不提供图片链接，只有数据。所以你需要自己把 base64 解码存成文件：

bash
# 接上一条命令，把结果落成 png
... | jq -r '.data[0].b64_json' | base64 -d > out.png

提示词写法

NovelAI 用的是 Danbooru 标签，不是自然语言长句。

1girl, white hair, soft light 这样逗号分隔的标签效果最好；写成「一个白发女孩站在柔和的灯光下」反而会变差。

生图太慢怎么办 ​

图片生成通常要几十秒。客户端如果默认超时 30 秒，会看到超时错误——不是生成失败，是客户端等不及了。

先把超时调到 120 秒以上再判断。具体见排障指南。

想看更直观的界面 ​

渊站还有一个生图台，可以直接在网页上画：draw.syuan.org

它跟 API 用的是同一套额度，适合调提示词的时候用。