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 / 장

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