Get Started

What is Banatie?

Banatie is an image generation API for developers. Send a text prompt, get a production-ready image delivered via CDN.

Simple REST API. Optimized AI models that deliver consistent results. Images ready for production use immediately.

Set Up Your Account & Project

Four short steps and you'll hold a working API key. Full details live in the authentication walkthrough and the CLI reference.

1. Log in. Request a login email straight from the terminal:

npx @banatie/cli signup [email protected]

The email contains a one-time login command with your organization slug and a bnt_boot_ token. Run it as-is:

npx @banatie/cli org acme login <bnt_boot-token>

2. Create a project:

npx @banatie/cli org acme project new my-app

3. Connect a local directory (new or existing: it just links the directory to your project):

mkdir my-app && cd my-app
npx @banatie/cli org acme project connect my-app --project-root .

4. Get your API key: written straight into your env file:

npx @banatie/cli issue-api-key --write-env .env

Your First Image

Your key now lives in .env as BANATIE_API_KEY. Export it and generate an image with a single request:

export BANATIE_API_KEY="$(grep '^BANATIE_API_KEY=' .env | cut -d= -f2-)"

curl -X POST https://api.banatie.app/api/v1/generations \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $BANATIE_API_KEY" \
  -d '{"prompt": "a friendly robot waving hello"}'

That's it. The response contains your image:

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "success",
    "outputImage": {
      "storageUrl": "https://cdn.banatie.app/my-org/my-project/img/8a3b2c1d-4e5f-6789-abcd-ef0123456789",
      "width": 1792,
      "height": 1008
    }
  }
}

Open storageUrl in your browser: there's your robot.

Production Ready

The image URL is permanent and served via global CDN. What this means for you:

• •Fast access: images load in milliseconds
• •Edge cached: served from locations closest to your users
• •Global distribution: works fast everywhere in the world

One request. Production-ready result. Drop the URL into your app and ship.

Live URLs

Want to skip the API call entirely? Generate images directly from a URL:

https://cdn.banatie.app/my-org/my-project/live/demo?prompt=a+friendly+robot+waving+hello

Put this in an <img src="..."> tag. First request generates the image, all subsequent requests serve it from cache instantly.

Learn more about Live URLs →

Next Steps