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