NNexithDocs
状态控制台 ↗
概览与快速开始模型目录指南API 参考集成OAuth2 / OIDC

Images

POST /v1/images/generations · POST /v1/images/edits 异步作业:提交返回 202,产物通过 /v1/jobs/:id 获取


POST /v1/images/generations#

提交图片生成作业。

POST /v1/images/generations
Authorization: Bearer nx-...
Content-Type: application/json

Body#

字段 类型 必填 说明
prompt string ✅ 提示词,空白会被拒绝
model string — 默认 nexith-image;白名单外返回 400
size string — 默认 1024x1024
idempotency_key string — 幂等键;同用户同键返回原作业

响应 202#

{
  "id": 123,
  "status": "pending",
  "idempotency_key": "0f3c…",
  "created_at": "2026-11-19T02:00:00Z"
}

错误#

状态 code 场景
400 invalid_request prompt 为空 / model 不在白名单
402 insufficient_balance 余额不足(入队前拦截)
429 rate_limit_exceeded RPM/TPM 超限(不锁资金)
502/503 inference_unavailable / model_overloaded 目录不可用

POST /v1/images/edits#

提交改图作业(img2img)。

仅接受 JWT(chat 站)。nx- API Key 调用返回 403 forbidden。

POST /v1/images/edits
Authorization: Bearer <JWT>
Content-Type: application/json

Body#

字段 类型 必填 说明
prompt string ✅ 改图指令
image string ✅ nx-file://<uuid> 引用(先经 POST /v1/files 上传)
size string — 默认 1024x1024
idempotency_key string — 幂等键

响应#

同样是 202 + 作业对象,后续流程与生成完全一致。

错误#

状态 code 场景
400 invalid_request image 不是合法 nx-file:// 引用,或不属于当前用户
403 forbidden 使用 nx- Key 调用
402 insufficient_balance 余额不足

产物#

作业完成后,GET /v1/jobs/:id 的 artifacts 数组包含预签名 URL:

https://nexith-artifacts-prod.s3.us-west-2.amazonaws.com/images/<user>/<uuid>.png?X-Amz-…

有效期 7 天。过期后需要重新生成;长期保存请在上线时自行转存到自己的存储。


计费#

项目 价格
生成 / 改图 $0.10 / 张

提交时预留,完成结算,失败/取消全额退款。详见 图片指南。