# МиксМедиа API (MixMedia API)

> REST API для генерации и редактирования изображений: 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>. Поток: POST /jobs/createTask → GET /jobs/recordInfo?taskId= (или callBackUrl с подписью X-Signature). Оплата в USD за запуск, возврат при ошибке.

Каждая страница доступна как Markdown: адрес страницы + .md. Вся документация одним файлом: https://docs.aimixmedia.site/llms-full.txt
English version: https://docs.aimixmedia.site/en/llms.txt

## Начало

- [Быстрый старт](https://docs.aimixmedia.site/index.md): Первая картинка через API за 3 шага: ключ → задача → результат.

## Модели

- [Все модели](https://docs.aimixmedia.site/models.md): Какие модели доступны, их ID для API и цены.
- [Nano Banana 2](https://docs.aimixmedia.site/models/nano-banana-2.md): Gemini 3.1 Flash Image: быстрая генерация и редактирование, точный текст на картинке, до 14 референсов.
- [Nano Banana Pro](https://docs.aimixmedia.site/models/nano-banana-pro.md): Gemini 3 Pro Image: максимальное качество, сложные композиции и инфографика.
- [Nano Banana](https://docs.aimixmedia.site/models/nano-banana.md): Лёгкая и быстрая модель Google: генерация по тексту и редактирование фото по инструкции.
- [GPT Image 2.5](https://docs.aimixmedia.site/models/gpt-image-2.5.md): OpenAI GPT Image 2.5: фотореализм, чистый текст, продуктовые кадры и точное редактирование фото.

## Справочник API

- [POST /api/v1/jobs/createTask](https://docs.aimixmedia.site/endpoints/create-task.md): Создаёт задачу генерации и сразу возвращает её номер (taskId). Цена списывается сразу и возвращается при ошибке.
- [GET /api/v1/jobs/recordInfo](https://docs.aimixmedia.site/endpoints/record-info.md): Статус задачи и результат. Спрашивайте раз в 3–5 секунд, пока state не станет success или fail.
- [GET /api/v1/user/balance](https://docs.aimixmedia.site/endpoints/balance.md): Текущий баланс аккаунта в долларах.
- [POST /api/v1/files/upload](https://docs.aimixmedia.site/endpoints/upload.md): Загружает ваше фото и возвращает ссылку, которую можно передать в input модели.
- [Другие методы](https://docs.aimixmedia.site/endpoints/other.md): Список задач и каталог моделей в JSON.

## Callback

- [Callback](https://docs.aimixmedia.site/callbacks.md): Мы сами пришлём результат на ваш сервер, когда задача завершится, — без опроса recordInfo.

## Ошибки и лимиты

- [Ошибки и лимиты](https://docs.aimixmedia.site/errors.md): Коды ответов, ошибки задач и лимиты запросов.

## Дополнительно

- [Ключи и авторизация](https://docs.aimixmedia.site/authentication.md): Как передавать ключ и управлять ключами.
- [Защита от дублей](https://docs.aimixmedia.site/idempotency.md): Заголовок Idempotency-Key: повтор запроса не создаст вторую задачу и не спишет деньги дважды.
- [Цены и оплата](https://docs.aimixmedia.site/pricing.md): Оплата за каждый запуск в долларах, возврат при ошибке, пополнение в рублях.

## Optional

- [llms-full.txt](https://docs.aimixmedia.site/llms-full.txt): вся документация одним файлом
- [Каталог моделей JSON](https://ai.aimixmedia.site/api/v1/models)