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 / 장 |
제출 시 예약하고 완료 시 정산하며, 실패/취소 시 전액 환불합니다. 자세한 내용은 이미지 가이드를 참고하세요.