Skip to main content
POST
/
api
/
v1
/
images
curl --request POST \
  --url https://ninjachat.ai/api/v1/images \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A cyberpunk cityscape at night with neon signs and rain, photorealistic, 8k detail"
}
'
{
  "model": "flux-1-pro-ultra",
  "images": [
    {
      "url": "<string>",
      "revised_prompt": "<string>"
    }
  ],
  "usage": {
    "images_generated": 123
  },
  "cost": {
    "this_request": "$0.10",
    "per_image": "$0.10",
    "images": 1
  },
  "metadata": {
    "latency_ms": 123,
    "size": "<string>"
  }
}

Authorizations

Authorization
string
header
required

API key starting with nj_sk_

Body

application/json
prompt
string
required

Image description.

Required string length: 1 - 4000
model
enum<string>
default:flux-2-klein

Image model to use. $0.10/img: flux-kontext-max. $0.08/img: flux-2-flex, flux-1-pro-ultra, recraft-v3, google-imagen-4, nano-banana-pro, seedream. $0.05/img: flux-2-pro, flux-kontext-pro, nano-banana-2, flux-1-fill. $0.03/img: flux-2-klein, nano-banana.

Available options:
flux-kontext-max,
flux-2-flex,
flux-1-pro-ultra,
recraft-v3,
google-imagen-4,
nano-banana-pro,
seedream,
flux-2-pro,
flux-kontext-pro,
nano-banana-2,
flux-1-fill,
flux-2-klein,
nano-banana
size
enum<string>
default:1920x1920

Output size: 1920x1920 (square, 1:1), 2560x1440 (landscape, 16:9), or 1440x2560 (portrait, 9:16).

Available options:
1920x1920,
2560x1440,
1440x2560
n
integer
default:1

Number of images to generate.

Required range: 1 <= x <= 4
image
string<uri>

Reference image URL for image-to-image editing. Must be a publicly accessible HTTPS URL.

Response

Generated images.

model
string
Example:

"flux-1-pro-ultra"

images
object[]
usage
object
cost
object
metadata
object