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

送信時に予約し、完了時に精算、失敗/キャンセル時は全額返金します。詳細は画像ガイドを参照してください。