# MixMedia API

> REST API for image generation and editing: Nano Banana 2, Nano Banana Pro, Nano Banana, GPT Image 2.5. Base URL: https://ai.aimixmedia.site/api/v1. Auth: Authorization: Bearer <API_KEY>. Flow: POST /jobs/createTask → GET /jobs/recordInfo?taskId= (or a callBackUrl signed with X-Signature). Pay per run in USD, refunded on failure.

Every page is available as Markdown at its URL + .md. All docs in one file: https://docs.aimixmedia.site/en/llms-full.txt
Russian version: https://docs.aimixmedia.site/llms.txt

## Getting started

- [Quick start](https://docs.aimixmedia.site/en/index.md): Your first image through the API in 3 steps: key → task → result.

## Models

- [All models](https://docs.aimixmedia.site/en/models.md): Available models, their API IDs and prices.
- [Nano Banana 2](https://docs.aimixmedia.site/en/models/nano-banana-2.md): Gemini 3.1 Flash Image: fast generation and editing, accurate text in images, up to 14 references.
- [Nano Banana Pro](https://docs.aimixmedia.site/en/models/nano-banana-pro.md): Gemini 3 Pro Image: top quality, complex compositions and infographics.
- [Nano Banana](https://docs.aimixmedia.site/en/models/nano-banana.md): Google's lightweight, fast model: text-to-image generation and instruction-based photo editing.
- [GPT Image 2.5](https://docs.aimixmedia.site/en/models/gpt-image-2.5.md): OpenAI GPT Image 2.5: photorealism, clean text, product shots and precise photo editing.

## API reference

- [POST /api/v1/jobs/createTask](https://docs.aimixmedia.site/en/endpoints/create-task.md): Creates a generation task and returns its ID (taskId) right away. The price is charged now and refunded on failure.
- [GET /api/v1/jobs/recordInfo](https://docs.aimixmedia.site/en/endpoints/record-info.md): Task status and result. Ask every 3–5 seconds until state becomes success or fail.
- [GET /api/v1/user/balance](https://docs.aimixmedia.site/en/endpoints/balance.md): Current account balance in USD.
- [POST /api/v1/files/upload](https://docs.aimixmedia.site/en/endpoints/upload.md): Uploads your photo and returns a link you can pass to the model input.
- [Other endpoints](https://docs.aimixmedia.site/en/endpoints/other.md): Task list and the model catalog as JSON.

## Callback

- [Callbacks](https://docs.aimixmedia.site/en/callbacks.md): We POST the result to your server when the task finishes — no recordInfo polling.

## Errors & limits

- [Errors & limits](https://docs.aimixmedia.site/en/errors.md): Response codes, task errors and rate limits.

## More

- [Keys & authentication](https://docs.aimixmedia.site/en/authentication.md): How to send the key and manage keys.
- [Idempotency](https://docs.aimixmedia.site/en/idempotency.md): The Idempotency-Key header: a retried request does not create a second task or charge twice.
- [Pricing & payment](https://docs.aimixmedia.site/en/pricing.md): Pay per run in USD, refunds on failure, top up in RUB.

## Optional

- [llms-full.txt](https://docs.aimixmedia.site/en/llms-full.txt): all docs in one file
- [Model catalog JSON](https://ai.aimixmedia.site/api/v1/models)