Image Generation - NinjaChat Developers

curl --request POST \
  --url https://www.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>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  },
  "message": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  },
  "message": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  },
  "message": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  },
  "message": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  },
  "message": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

POST

/

api

/

v1

/

images

curl --request POST \
  --url https://www.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>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  },
  "message": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  },
  "message": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  },
  "message": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  },
  "message": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  },
  "message": "<string>",
  "code": "<string>",
  "request_id": "<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[]

Show child attributes

usage

object

Show child attributes

cost

object

Show child attributes

metadata

object

Show child attributes