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/jsonBody#
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
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/jsonBody#
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
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 / 张 |
提交时预留,完成结算,失败/取消全额退款。详见 图片指南。