API Reference

Base URL

https://api.eggapi.ai

Authentication

Use an API key from the dashboard:

Authorization: Bearer YOUR_API_KEY

Public Model Scope

The current published public catalog exposes only nano-banana. Use nanobanana as the model value in API requests.

Request Format

Use HTTPS.
Send JSON bodies with Content-Type: application/json.
Include Authorization: Bearer YOUR_API_KEY.

Response Envelope

Success:

{
  "data": {},
  "error": null
}

Error:

{
  "data": null,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "request validation failed"
  }
}

Status Codes

Status	Meaning
`200`	Request succeeded.
`202`	Async generation task was created.
`400`	Bad request or validation error.
`401`	Missing or invalid credentials.
`403`	Forbidden or insufficient balance.
`404`	Resource not found.
`429`	Rate limited.
`500`	Internal backend error.
`502`	Upstream provider error.
`503`	Service unavailable.

Pagination

List endpoints use:

Parameter	Default	Max
`page`	`1`	-
`per_page`	`20`	`100`

Paginated responses return data.items and data.pagination.

Endpoints

POST /v1/generate

Create a nano-banana image generation or image editing task.

GET /v1/tasks/{id}

Get one task by ID.

GET /v1/tasks

List your generation tasks.

GET /v1/usage

List usage records.

Overview

Generation

Tasks

Usage

Base URL

Authentication

Public Model Scope

Request Format

Response Envelope

Status Codes

Endpoints

POST /v1/generate

GET /v1/tasks/{id}

GET /v1/tasks

GET /v1/usage

​Base URL

​Authentication

​Public Model Scope

​Request Format

​Response Envelope

​Status Codes

​Pagination

​Endpoints

POST /v1/generate

GET /v1/tasks/{id}

GET /v1/tasks

GET /v1/usage

Base URL

Authentication

Public Model Scope

Request Format

Response Envelope

Status Codes

Pagination

Endpoints