Обзор Image API

APIMaster предоставляет image API по адресу https://apimaster.ai/v1. Преобразование изображения в изображение не использует единый универсальный формат ввода для всех моделей. Сначала выберите модель, затем используйте её документированный эндпоинт и поля для референсов.

Руководство по моделям и эндпоинтам

Модель	Текст-в-изображение	Изображение-в-изображение	Руководство
gpt-image-2	JSON /images/generations	Multipart /images/edits, файлы image / image[]	GPT Image 2 / 2.5
gpt-image-2.5-sunburst	JSON /images/generations	Multipart /images/edits, файлы image / image[]	GPT Image 2 / 2.5
gpt-image-2.5-flare	JSON /images/generations	Multipart /images/edits, файлы image / image[]	GPT Image 2 / 2.5
gemini-3.1-flash-image-preview	JSON /images/generations	JSON /images/generations с image_urls	Gemini Flash Image
gemini-nano-banana-2.1	JSON /images/generations	multipart /images/edits / JSON image_urls	Nano Banana 2.1
grok-imagine-image-2.0	JSON /images/generations	JSON /images/generations с image_urls (до 5)	Grok Imagine Image 2.0
doubao-seedream-5-0-pro-260628	JSON /images/generations	JSON /images/generations с image	Seedream 5.0 Pro
midjourney-v8.2	Асинхронный /midjourney/generations	JSON со ссылками image_urls	Midjourney v8.2 / Niji 7
midjourney-niji-7	Асинхронный /midjourney/generations	JSON со ссылками image_urls	Midjourney v8.2 / Niji 7

Для Grok Imagine Image 2.0 используйте синхронный /images/generations с image_urls. Клиентские асинхронные пути и /images/edits не поддерживаются; см. руководство по Grok Imagine Image 2.0.

Для референсных изображений GPT загружайте реальные файлы в /images/edits для ответа с изображением или в /images/edits/async для ответа с задачей; не копируйте JSON-формат Gemini или Seedream. Упоминание референсов в промпте не является загрузкой. GPT Image 2.5 — отдельное семейство моделей, а не псевдоним GPT Image 2.

Midjourney v8.2 и Niji 7 создают асинхронные задачи через /midjourney/generations; опрашивайте GET /tasks/{task_id}. Параметры и примеры см. в руководстве по Midjourney v8.2 / Niji 7.

Аутентификация и ответы

• Создайте ключ в консоли; отправляйте Authorization: Bearer YOUR_API_KEY.
• JSON-вызовы генерации используют Content-Type: application/json. Для multipart-запросов edits позвольте HTTP-клиенту сгенерировать Content-Type и boundary.
• Синхронные ответы с изображениями содержат data[] с url или b64_json; обрабатывайте оба формата. Своевременно скачивайте временные URL-адреса.
• Необязательные поля, ограничения на референсы, размеры и цены зависят от модели и доступного маршрута. Проверяйте руководство по модели и маркетплейс.

Асинхронная работа

POST /images/generations/async, POST /images/edits/async и GET /tasks/{task_id}?model=MODEL_ID обеспечивают рабочие процессы на основе задач для поддерживаемых моделей. Это не универсальный режим для всех операций с изображениями:

• Для GPT Image 2, Sunburst и Flare используйте JSON generations/async для текст-в-изображение и multipart edits/async для редактирования. Загружайте те же файлы, что и при синхронных edits, затем опрашивайте с той же учётной записи и с тем же ID модели.
• Генерация или редактирование могут завершиться до того, как асинхронная отправка вернёт ID задачи; не предполагайте, что отправка происходит мгновенно. Не отправляйте повторно уже существующую задачу, пока опрашиваете её. Завершение может быть succeeded, success или completed; отслеживаемые результаты используют строковый url, тогда как устаревшие результаты могут содержать массив URL-адресов.
• У Gemini собственный асинхронный поток генерации; следуйте его руководству для входных референсов.
• Seedream 5.0 Pro использует синхронные generations и не поддерживает /images/generations/async.

Полные примеры на cURL/Python, состояния опроса и устранение неполадок см. в руководствах по моделям. Ответ HTTP 200 сам по себе не подтверждает точность референсного изображения.