NovelAI 常见问题

原生和异步接口是否重复

它们提供相同的绘图能力，满足两类接入方式。原生接口兼容已有客户端的路径、官方请求体和 ZIP / 二进制响应；异步接口提供任务 ID、查询、费用与文件链接。选用一套提交方式即可，同一次生成不要同时提交两个入口。

绘图参数统一见模型与绘图参数。原生与异步各有完整请求示例，区别主要在路径、外层包装和响应格式。

是否能一次生成多张

当前 parameters.n_samples 仅支持 1，省略时也是 1。其它值在生成和预扣前返回 HTTP 400。需要多张时分别提交；服务端不会默默截成单张或自动拆分请求。

为什么客户端显示的 Anlas 与官网不同

本站账户兼容字段按 1000 个显示单位 = 1 美元表示本站可用额度，客户端可能将其标为 Anlas。它不是平台 NovelAI 账号的真实 Anlas、电量或会员余额。

任务里的 estimated_anlas / actual_anlas 与美元费用字段也不是同一个单位。上游免费额度不代表本站服务免费；准确估价和结算分别见 usage.estimated_cost_usd、usage.actual_cost_usd。完整显示规则见账户与报价。

只有普通提示词为什么也会报参数错误

普通 V5 Full、V5 Curated 和 V4.5 Full 文生图还需要 v4_prompt、v4_negative_prompt，没有角色也要提供空的 caption.char_captions: []。缺少这些结构曾会被上游报成 HTTP 500；现在提交前返回 HTTP 400，并指出缺失字段。节约模式的规则有所不同，详见必填结构与提交校验。

单纯省略 n_samples 不是本次 500 的原因：省略按单张估价，原生/异步透传不会自动补写该字段。工作台会提供完整结构，第三方客户端建议使用完整请求示例。400 参数错误应先修正，不应原样重试；其他上游 500 仍可能是不同原因，不能一概归因于参数缺失。

是否保留最终图片元数据

PNG 保留上游生成元数据，缺失时补充可再次导入的参数。显式请求 WebP 时保留原文件格式和已有元数据，不承诺为缺失元数据的 WebP 补写。

流式请求未指定 image_format 时默认请求 PNG，中间预览通常仍为 JPEG。收到完整成图即可展示；后台随后继续完成归档和结算。最终图入库，中间预览不入库。恢复规则见流式生成与恢复。

参考素材是否进入资产库

API 素材归当前 Key 所属用户所有；临时上传与长期文件的展示方式不同。

保存方式	用户资产库	任务详情
POST /v1/media/files 默认临时上传	不展示临时文件；用于任务并完成转存后展示长期参考文件	转存完成后展示长期文件地址
上传时显式 temporary=false	图片、视频、音频按普通参考素材展示	展示上传后的文件地址
已有的长期素材，或生成请求中的源图片经规范化保存	按普通文件规则展示；遮罩等内部辅助文件不列入资产库	展示保存后的文件地址，不展示 Base64

临时素材在转存前仍展示临时地址，默认有效期 24 小时，到期不能用于新任务；已接受任务的引用会受保护。删除长期素材后，用户任务详情也不再展示该文件地址。规则和上传示例统一见参考素材。

原生参考缓存与临时上传是否同一回事

不是。原生 cache_secret_key 是客户端减少重复上传的协议缓存，按用户隔离，通常一小时有效，也可能因容量或服务重启提前失效。临时上传 URL 的有效期由上传响应中的 expires_at 决定。

缓存失效要补传素材；临时 URL 过期要重新上传。缓存不会延长源文件的有效期。详细请求字段见参考素材缓存。

为什么收到成图后任务仍在进行

快速交付成图、长期存储和费用结算是不同阶段。收到 image / final 后可以使用该图片，但稳定文件链接和最终费用以查询任务的 completed 状态为准。若之后转存失败，保留已收到的图片并查看任务错误，不要自动重复付费生成。

客户端断开连接不会取消已接受任务。上游在完整成图到达前断流则不保证找回结果；先查已有任务，详见中断恢复。