> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eggapi.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Public Model

> The single model currently published for public EggAPI generation

The current published public catalog contains one visible model: **nano-banana**. In API requests, use the backend model ID `nanobanana`.

| Public catalog name | API `model` value | Type  | Task types                     | Base unit cost             |
| ------------------- | ----------------- | ----- | ------------------------------ | -------------------------- |
| `nano-banana`       | `nanobanana`      | Image | `image_generate`, `image_edit` | `$0.0100` per output image |

<Note>
  The backend code still contains older fallback configuration for additional internal models, but they are not public in the current published catalog and are intentionally not documented as public API options.
</Note>

## Routing and Providers

The Go backend is the gateway, scheduler, ledger, and task center. A generation request is authenticated, queued, routed to the active upstream provider configuration, billed, recorded in usage, and optionally sent to your webhook.

Runtime provider routes are managed through the admin system. At the time this documentation was rewritten, the published public catalog contains only nano-banana and the runtime route table is empty, so docs should not advertise other public models.

## Parameters

<ParamField body="model" type="string" required>
  Use `nanobanana`.
</ParamField>

<ParamField body="prompt" type="string" required>
  Prompt text. Minimum 1 character, maximum 2000 characters.
</ParamField>

<ParamField body="negative_prompt" type="string">
  Optional text describing what to avoid. Maximum 1000 characters.
</ParamField>

<ParamField body="aspect_ratio" type="string">
  `16:9` or `9:16`. Defaults to `16:9`.
</ParamField>

<ParamField body="num_outputs" type="integer">
  Number of output images, from `1` to `4`. Defaults to `1`. Billing multiplies by the number of returned images.
</ParamField>

<ParamField body="resolution" type="string">
  Optional `1k`, `2k`, or `4k`. The backend accepts this field; public nano-banana usage should treat it as provider-dependent.
</ParamField>

<ParamField body="image_urls" type="string[]">
  Supplying one or more image URLs switches the request into `image_edit` mode. Up to 9 URLs are accepted.
</ParamField>

<ParamField body="webhook_url" type="string">
  Optional HTTPS callback URL. EggAPI sends `task.completed` or `task.failed` events after the worker finishes.
</ParamField>

## Model Guide

<CardGroup cols={1}>
  <Card title="nanobanana" icon="image" href="/docs/en/guides/models/nanobanana">
    Image generation and image editing with the public nano-banana model.
  </Card>
</CardGroup>