Инструменты · key

`aiimages` Генерация изображений нейросетями

Ставит задачу ИИ-генератору изображений: картинка по текстовому описанию (по желанию — с референсом), удаление фона или апскейл готового изображения. Метод асинхронный: POST возвращает report_id, ссылки на картинки забираются тем же методом. Список нейросетей и их настроек отдаёт вызов с models=1.

Режим: асинхронный: report_id
Стоимость: зависит от модели, режима и разрешения; списывается при постановке
Тариф: только платные тарифы
Одновременно: не больше 5 активных задач

Справочник моделей

GET /api/aiimages

Нейросети, доступные вашему ключу, с допустимыми соотношениями сторон и разрешениями. Задача не ставится, лимиты не списываются. Состав меняется без предупреждения — берите значения отсюда.

Параметры query

models int обязательный

Любое непустое значение — вернуть справочник.

Ответ

models[].name string

Название модели в интерфейсе.
models[].value string

Значение для modelName. У Midjourney и Niji включает версию, например midjourney --v 6.1.
models[].promptLength int

Максимальная длина request_field; 0 — общий предел 2000 символов.
models[].aspect_ratios array

Допустимые aspect_ratio. Пустой — значение не проверяется.
models[].resolutions array

Допустимые resolution, например 1K, 2K, 4K. Пустой — выбора разрешения нет.
models[].supports_image_input bool

Принимает референс в image_url.
models[].supports_multi_image_input bool

Принимает несколько референсов (в интерфейсе инструмента).
models[].supports_native_lang bool

Понимает промпт на русском; иначе промпт перед генерацией переводится на английский.
default string

Модель, выбранная в инструменте по умолчанию.

GET /api/aiimages

curl -G 'https://tools.pixelplus.ru/api/aiimages' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'models=1'

<?php
$url = 'https://tools.pixelplus.ru/api/aiimages?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'models' => 1,
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/api/aiimages",
    params={
        "key": "ВАШ_КЛЮЧ",
        "models": 1,
    },
    timeout=60,
)
print(response.json())

models обязательный Любое непустое значение — вернуть справочник

Запрос настоящий — выполнится с вашим ключом

Пример ответа

{
    "models": [
        {
            "name": "Nano Banana Pro",
            "value": "nano-banana-pro",
            "promptLength": 0,
            "aspect_ratios": [
                "auto",
                "1:1",
                "3:4",
                "4:3",
                "9:16",
                "16:9"
            ],
            "resolutions": [
                "1K",
                "2K",
                "4K"
            ],
            "supports_image_input": true,
            "supports_multi_image_input": true,
            "supports_native_lang": true
        },
        {
            "name": "Midjourney 6.1",
            "value": "midjourney --v 6.1",
            "promptLength": 0,
            "aspect_ratios": [
                "1:1",
                "16:9",
                "9:16"
            ],
            "resolutions": [],
            "supports_image_input": true,
            "supports_multi_image_input": false,
            "supports_native_lang": false
        }
    ],
    "default": "nano-banana-pro"
}

Постановка задачи

POST /api/aiimages

Параметры — полями формы, ключ — в адресе. Файлы через API не загружаются: исходное изображение передаётся публичной ссылкой.

Параметры query и тело формы

modelName string обязательный

value из справочника, например nano-banana-pro, gpt-image-2, flux-pro-1.1. Короткое midjourney заменяется на midjourney --v 6.0. Для удаления фона и апскейла — stableDiffusion3.
part string

Режим работы.

chat_bot
генерация изображения

remove_background
удаление фона

upscale
увеличение разрешения

По умолчанию chat_bot
request_field string

Промпт: что изобразить. Обязателен при генерации, до promptLength модели (по умолчанию 2000 символов). Без ссылок и параметров вида --ar, --v — их задают modelName и aspect_ratio.
image_url string

Публичная ссылка на изображение (.png, .jpg, .jpeg, .webp): референс при генерации для моделей с supports_image_input или исходник для remove_background и upscale, где она обязательна.
aspect_ratio string

Соотношение сторон из aspect_ratios модели.
resolution string

Разрешение из resolutions модели. У моделей с выбором разрешения влияет на цену.
img_ref string

Только Midjourney с image_url: как использовать референс.

img
композиция, стиль и цвет

cref
персонаж в новой сцене

sref
только стиль

По умолчанию img

POST /api/aiimages

curl -X POST 'https://tools.pixelplus.ru/api/aiimages?key=ВАШ_КЛЮЧ' \
  --data-urlencode 'modelName=nano-banana-pro' \
  --data-urlencode 'part=chat_bot' \
  --data-urlencode 'request_field=Витрина пекарни, тёплый утренний свет' \
  --data-urlencode 'aspect_ratio=16:9' \
  --data-urlencode 'resolution=2K'

<?php
$url = 'https://tools.pixelplus.ru/api/aiimages?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => http_build_query([
        'modelName' => 'nano-banana-pro',
        'part' => 'chat_bot',
        'request_field' => 'Витрина пекарни, тёплый утренний свет',
        'aspect_ratio' => '16:9',
        'resolution' => '2K',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.post(
    "https://tools.pixelplus.ru/api/aiimages",
    params={
        "key": "ВАШ_КЛЮЧ",
    },
    data={
        "modelName": "nano-banana-pro",
        "part": "chat_bot",
        "request_field": "Витрина пекарни, тёплый утренний свет",
        "aspect_ratio": "16:9",
        "resolution": "2K",
    },
    timeout=60,
)
print(response.json())

modelName обязательный value из справочника, например nano-banana-pro, gpt-image-2, flux-pro-1.1 part Режим работы request_field Промпт: что изобразить aspect_ratio Соотношение сторон из aspect_ratios модели resolution Разрешение из resolutions модели

Запрос настоящий — выполнится с вашим ключом

Пример ответа

{
    "report_id": 18452301
}

Получение результата

GET /api/aiimages

Повторяйте раз в 5–10 секунд, пока вместо In progress не придут ссылки. Задача, которую нейросеть не смогла выполнить, тоже завершается — с текстом в response.errors; лимиты за неё возвращаются.

Параметры query

report_id int обязательный

ID задачи из ответа на постановку.

Ответ

request object

Параметры задачи.
response.data array

Готовые изображения: у большинства моделей — объекты со ссылкой (url) и полем errors, у Midjourney — массив ссылок.
response.errors string

Текст ошибки генерации; пустая строка — ошибок нет.
response.errorType string|null

IMAGE_GENERATION_FAILED, если генерация не удалась.
time string

Время готовности.
cost int

Цена задачи по текущему прайсу. При неудачной генерации лимиты возвращаются, но поле показывает цену.

GET /api/aiimages

curl -G 'https://tools.pixelplus.ru/api/aiimages' \
  --data-urlencode 'key=ВАШ_КЛЮЧ' \
  --data-urlencode 'report_id=18452301'

<?php
$url = 'https://tools.pixelplus.ru/api/aiimages?' . http_build_query([
    'key' => 'ВАШ_КЛЮЧ',
    'report_id' => 18452301,
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.get(
    "https://tools.pixelplus.ru/api/aiimages",
    params={
        "key": "ВАШ_КЛЮЧ",
        "report_id": 18452301,
    },
    timeout=60,
)
print(response.json())

report_id обязательный ID задачи из ответа на постановку

Запрос настоящий — выполнится с вашим ключом

Пример ответа

{
    "request": {
        "modelName": "nano-banana-pro",
        "part": "chat_bot",
        "request_field": "Витрина пекарни, тёплый утренний свет",
        "aspect_ratio": "16:9",
        "resolution": "2K"
    },
    "response": {
        "data": [
            {
                "url": "https://example.com/ai-images/img_65f2c1a9.png",
                "errors": ""
            }
        ],
        "errors": "",
        "errorType": null
    },
    "time": "2026-10-06 14:33:12",
    "cost": 450
}

Ошибки

Код	Сообщение	Когда
`-100`	`tools errors`	Задача не поставлена, причины в `details`: модель не из справочника, недопустимые `part`, `aspect_ratio` или `resolution`, пустой или длинный промпт, ссылки или `--параметры` в промпте, фильтр 18+, неверный `img_ref`, бесплатный тариф, не хватает лимитов.
`-60`	`tools errors`	Уже 5 незавершённых задач (`MAX_PARALLEL_TASKS_FAIL`).
`-51`	`No requests data`	Задача ставится не POST-запросом.
`50`	`In progress`	Задача ещё идёт; `progress` — процент готовности.
`-4`	`Access denied`	`report_id` чужой или другого инструмента.
`-104…-107, -125`	`Processing error и др.`	Задача завершилась сбоем — см. асинхронные задачи.
`-68, -80…-83`	`Not enough … limits`	Лимиты закончились — метод не отвечает даже на справочник и чтение отчёта.
`-1, -2`	`Access denied`	Ключ не передан или не найден.

Ответ с ошибкой

{
    "error": "tools errors",
    "details": [
        "Ошибка — неправильно выбрано соотношение сторон!"
    ],
    "code": "-100"
}

Стоимость

Цена задаётся правилами в настройках инструмента, а не в коде: своя у каждой модели, у удаления фона и апскейла — отдельные фиксированные. У моделей с выбором разрешения (например, nano-banana-2 и GPT Image 2.5) цена растёт с resolution. Актуальные цены — в интерфейсе инструмента. Лимиты списываются при постановке и возвращаются, если генерация не удалась.

Удаление фона и апскейл

Передайте part=remove_background или part=upscale, modelName=stableDiffusion3 и image_url; промпт не нужен. Ссылка при постановке не проверяется: без неё или с недоступным файлом задача завершится ошибкой.

Ограничения

Промпт для моделей, которые не понимают русский, автоматически переводится на английский — пишите так, чтобы перевод не терял смысл.
Параметр imagesCount со старой страницы документации не передавайте: генерация всегда отдаёт одно изображение за задачу.
Ссылки на результат не вечны — скачивайте файлы сразу.

aiimages Генерация изображений нейросетями

Справочник моделей

Параметры query

Ответ

Постановка задачи

Параметры query и тело формы

Получение результата

Параметры query

Ответ

Ошибки

Стоимость

Удаление фона и апскейл

Ограничения

`aiimages` Генерация изображений нейросетями