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

`aicontent` Генерация текста нейросетями

Ставит задачу ИИ-генератору текста: ответ на промпт, статья, план, FAQ, отзывы, описание товара или категории, Title/Description/H1, обработка длинного текста. Метод асинхронный: POST возвращает report_id, результат забирается тем же методом. Список доступных нейросетей отдаёт вызов с models=1.

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

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

GET /api/aicontent

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

Параметры query

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

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

Ответ

models[].name string

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

Значение для параметра model.
models[].promptLength int

Максимальная длина request_field; 0 — действует общий предел 10 000 символов.
models[].isChatBot bool

Модель доступна в режиме chat_bot.
models[].isVision bool

Принимает изображение: image_url или image_upload.
models[].isFile bool

Принимает документ file_upload.
models[].isWebSearch bool

Поддерживает поиск в интернете — web_search.
models[].forLargeText bool

Рассчитана на длинные тексты.
default string

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

GET /api/aicontent

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

<?php
$url = 'https://tools.pixelplus.ru/api/aicontent?' . 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/aicontent",
    params={
        "key": "ВАШ_КЛЮЧ",
        "models": 1,
    },
    timeout=60,
)
print(response.json())

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

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

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

{
    "models": [
        {
            "name": "GPT 4.1",
            "value": "gpt-4.1",
            "promptLength": 0,
            "isChatBot": true,
            "isVision": true,
            "isFile": true,
            "isWebSearch": false,
            "forLargeText": true
        },
        {
            "name": "Sonar Pro",
            "value": "sonar-pro",
            "promptLength": 0,
            "isChatBot": true,
            "isVision": false,
            "isFile": false,
            "isWebSearch": true,
            "forLargeText": false
        }
    ],
    "default": "gpt-4.1"
}

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

POST /api/aicontent

Параметры — полями формы (multipart/form-data, если прикладываете файл). JSON-тело метод не читает. Ключ остаётся в адресе. Дополнительные поля режимов — в таблице под операциями.

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

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

Режим генерации — вкладка инструмента. От него зависят дополнительные поля, см. таблицу ниже.

chat_bot
свободный ответ на промпт

article
статья

plan
план статьи

faq
вопросы и ответы

reviews
отзывы

listing_of_goods
текст для категории товаров или услуг

goods_card
описание товара или услуги

title_description_h1
мета-теги Title, Description, H1

large_texts
обработка длинного текста

complex
пакет по списку URL — отдельная страница
model string обязательный

value из справочника, например gpt-4.1, deepseek-chat, claude-sonnet-4-6.
request_field string

Промпт или тема. До promptLength модели (по умолчанию 10 000 символов), для large_texts — до 50 000. Не нужен для complex, title_description_h1 и plan по запросам. Ссылки и конструкции вида --param не допускаются.
mode string

Подрежим для plan, title_description_h1, listing_of_goods, goods_card, reviews, large_texts.
repeats int

Сколько независимых ответов сгенерировать, от 1 до 15. Значения вне диапазона приводятся к границе. Цена умножается на это число.

По умолчанию 1
web_search string

Поиск в интернете: 1, on или true. Только для моделей с isWebSearch; тарифицируется по отдельной цене модели.
creative string

on — более свободные формулировки (температура 0.7).
multiple_models string

on — один промпт сразу в нескольких моделях из models[]. Только part=chat_bot; цены моделей складываются.
models[] array

Список value для multiple_models=on.
image_url string

chat_bot: ссылка на изображение для анализа, окончание .png, .webp, .jpg или .jpeg. Нужна модель с isVision.
image_upload file

chat_bot: файл изображения вместо ссылки — PNG, JPEG, WebP, GIF до 20 МБ. Модель с isVision.
file_upload file

chat_bot: документ — TXT, PDF, HTML, CSV, XLS, XLSX, DOC, DOCX до 20 МБ. Модель с isFile.

POST /api/aicontent

curl -X POST 'https://tools.pixelplus.ru/api/aicontent?key=ВАШ_КЛЮЧ' \
  --data-urlencode 'part=chat_bot' \
  --data-urlencode 'model=gpt-4.1' \
  --data-urlencode 'request_field=Составь план статьи о выборе беговых кроссовок'

<?php
$url = 'https://tools.pixelplus.ru/api/aicontent?' . 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([
        'part' => 'chat_bot',
        'model' => 'gpt-4.1',
        'request_field' => 'Составь план статьи о выборе беговых кроссовок',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

print_r($response);

import requests

response = requests.post(
    "https://tools.pixelplus.ru/api/aicontent",
    params={
        "key": "ВАШ_КЛЮЧ",
    },
    data={
        "part": "chat_bot",
        "model": "gpt-4.1",
        "request_field": "Составь план статьи о выборе беговых кроссовок",
    },
    timeout=60,
)
print(response.json())

part обязательный Режим генерации — вкладка инструмента model обязательный value из справочника, например gpt-4.1, deepseek-chat, claude-sonnet-4-6 request_field Промпт или тема

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

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

{
    "report_id": 18452301
}

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

GET /api/aicontent

Повторяйте раз в 5–10 секунд, пока вместо In progress не придёт результат. Повторные запросы готового отчёта бесплатны.

Параметры query

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

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

Ответ

request object

Параметры, с которыми ставилась задача.
response string|array

Результат: текст; при multiple_models — ответы по моделям; при complex — тексты по URL.
response_parsed object

Только для complex — см. complex.
part string

Режим задачи.
image_url string|null

Изображение, если передавалось.
json_data object

Служебные данные модели: источники веб-поиска, метаданные.
time string

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

Цена задачи, пересчитанная по текущему прайсу при чтении отчёта. Если цены моделей менялись после постановки, может не совпасть со списанным.

GET /api/aicontent

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

<?php
$url = 'https://tools.pixelplus.ru/api/aicontent?' . 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/aicontent",
    params={
        "key": "ВАШ_КЛЮЧ",
        "report_id": 18452301,
    },
    timeout=60,
)
print(response.json())

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

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

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

{
    "request": {
        "part": "chat_bot",
        "model": "gpt-4.1",
        "request_field": "Составь план статьи о выборе беговых кроссовок"
    },
    "response": "1. Как определить тип пронации\n2. Амортизация и drop…",
    "part": "chat_bot",
    "image_url": null,
    "json_data": [],
    "time": "2026-10-06 14:33:12",
    "cost": 90
}

Ошибки

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

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

{
    "error": "tools errors",
    "details": [
        "Ошибка - неправильно выбранная модель нейросети!.",
        "Уменьшите размер запроса до 10000 символов."
    ],
    "code": "-100"
}

Поля режимов

part	Что передать
`chat_bot`	`request_field`; по желанию изображение, документ, `web_search`, `multiple_models`.
`article`	`request_field` — тема, `article_length` — длина в символах (целое, обязательно). Цена — отдельная «цена статьи» модели.
`plan`	`mode=plan_by_theme` + `request_field` или `mode=plan_by_queries` + `queries[]`.
`title_description_h1`	`mode`: `by_requests` (`queries[]`), `by_text` (текст в `queries`, по желанию `lemmas[]`), `by_url` (`url_input_field`). `emoji=on` — с эмодзи.
`listing_of_goods`	`mode`: `goods` или `services`; `request_field` — название группы; `length` — объём до 5000 (иначе 1000).
`goods_card`	`mode`: `card_goods` или `card_services`; `request_field`; `length`; `characteristics=on` — добавить характеристики (для товара).
`reviews`	`mode`: `for_goods` или `for_service`; `request_field` — товар или услуга; `tone` — тональность словом, например `положительный`.
`faq`	`request_field`.
`large_texts`	`request_field` — текст до 50 000 символов; `mode` обязателен: `uniqueness` (рерайт), `translation` (перевод, язык — `language`, slug языка), `editing` (корректура). Текст режется на части по 10 000 символов, каждая оплачивается как отдельная генерация.
`complex`	Пакет по списку URL — отдельная страница.

queries[] — до 25 запросов, массивом полей формы.

Стоимость

У каждой модели своя цена в лимитах — она видна в интерфейсе инструмента и хранится в настройках, а не в коде, поэтому меняется без релиза. Отдельные цены: для article («цена статьи») и с web_search. Итог умножается на repeats; при multiple_models цены моделей складываются; large_texts — цена × число частей по 10 000 символов; complex — цена × число URL. Лимиты списываются при постановке. Если их не хватает на задачу, придёт -100 с текстом в details, а не -80…-83.

Подводные камни

Файл, приложенный к модели без флага isVision/isFile или не в режиме chat_bot, молча игнорируется.
Промпт проходит фильтр 18+ — на большинстве тарифов.
Когда лимиты закончились, метод отвечает ошибкой лимитов (-68, -80…-83) на любой вызов, включая справочник и чтение готового отчёта.
api-complex со старой страницы документации не используйте: задача с ним ставится бесплатно и завершается ошибкой. Пакетная генерация — part=complex.

aicontent Генерация текста нейросетями

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

Параметры query

Ответ

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

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

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

Параметры query

Ответ

Ошибки

Поля режимов

Стоимость

Подводные камни

`aicontent` Генерация текста нейросетями