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

`complex` Тексты и мета-теги для карточек товаров, услуг и листингов

Пакетный режим ИИ-генератора текста: по списку страниц — до 250 за задачу — нейросеть пишет мета-теги Title, Description, H1 и/или продающее описание для карточки товара, карточки услуги, листинга товаров или листинга услуг. Это метод aicontent с part=complex; отдельного адреса /api/complex нет. Метод асинхронный: report_id, затем опрос.

Адрес: /api/aicontent, part=complex
Режим: асинхронный: report_id
Стоимость: цена модели × число страниц
За задачу: от 1 до 250 страниц

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

POST /api/aicontent

Параметры — полями формы. Страницы передаются как file_data[N][поле], где N — номер страницы с нуля. Ниже поля первой страницы; у второй те же поля с file_data[1] и так далее.

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

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

Всегда complex.
model string обязательный

value модели из справочника aicontent, например gpt-4.1 или deepseek-chat.
metatags string

on — сгенерировать Title, Description и H1. Нужен хотя бы один из metatags и text.
text string

on — сгенерировать описание страницы.
emoji string

on — эмодзи в Title и Description.

По умолчанию off
creative string

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

По умолчанию off
file_data[0][url] string обязательный

URL страницы. Служит ключом результата — URL в одной задаче не должны повторяться.
file_data[0][method] string обязательный

Тип страницы — одно из четырёх значений ровно в таком написании.

карточка товара
описание товара: суть, преимущества, характеристики

карточка услуги
описание услуги: суть, как оказывается, результат

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

листинг услуг
текст для раздела услуг
file_data[0][name] string

Название товара, услуги или категории. Нужно name или queries.
file_data[0][queries] string

Поисковые запросы через запятую; в промпт идут первые 10.
file_data[0][length] int

Объём описания в символах, до 5000. Без значения или больше 5000 — «1000–2000».

POST /api/aicontent

curl -X POST 'https://tools.pixelplus.ru/api/aicontent?key=ВАШ_КЛЮЧ' \
  --data-urlencode 'part=complex' \
  --data-urlencode 'model=gpt-4.1' \
  --data-urlencode 'metatags=on' \
  --data-urlencode 'text=on' \
  --data-urlencode 'file_data[0][url]=https://example.com/catalog/kompyutery/' \
  --data-urlencode 'file_data[0][method]=листинг товаров' \
  --data-urlencode 'file_data[0][name]=Компьютеры' \
  --data-urlencode 'file_data[0][queries]=купить компьютер,компьютеры москва,компьютер цена' \
  --data-urlencode 'file_data[0][length]=1500'

<?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' => 'complex',
        'model' => 'gpt-4.1',
        'metatags' => 'on',
        'text' => 'on',
        'file_data[0][url]' => 'https://example.com/catalog/kompyutery/',
        'file_data[0][method]' => 'листинг товаров',
        'file_data[0][name]' => 'Компьютеры',
        'file_data[0][queries]' => 'купить компьютер,компьютеры москва,компьютер цена',
        'file_data[0][length]' => 1500,
    ]),
]);
$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": "complex",
        "model": "gpt-4.1",
        "metatags": "on",
        "text": "on",
        "file_data[0][url]": "https://example.com/catalog/kompyutery/",
        "file_data[0][method]": "листинг товаров",
        "file_data[0][name]": "Компьютеры",
        "file_data[0][queries]": "купить компьютер,компьютеры москва,компьютер цена",
        "file_data[0][length]": 1500,
    },
    timeout=60,
)
print(response.json())

part обязательный Всегда complex model обязательный value модели из справочника aicontent, например gpt-4.1 или deepseek-chat metatags on — сгенерировать Title, Description и H1 text on — сгенерировать описание страницы file_data[0][url] обязательный URL страницы file_data[0][method] обязательный Тип страницы — одно из четырёх значений ровно в таком написании file_data[0][name] Название товара, услуги или категории file_data[0][queries] Поисковые запросы через запятую; в промпт идут первые 10 file_data[0][length] Объём описания в символах, до 5000

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

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

{
    "report_id": 18452301
}

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

GET /api/aicontent

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

Параметры query

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

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

Ответ

request object

Параметры задачи, страницы — в file_data.
response object

Сырой ответ нейросети по каждой странице: ключ — URL, значение — текст с метками Title:, Description:, H1:, Детальное описание:.
response_parsed object

Тот же результат, разобранный по полям. Ключ — URL.
Вложенные поля
- url string
  
  URL страницы.
- title, description, h1 string
  
  Мета-теги; есть, если в запросе был параметр metatags.
- text string
  
  Описание в HTML (<p>, списки — <ul>); есть, если в запросе был параметр text.
part string

complex.
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": "complex",
        "model": "gpt-4.1",
        "metatags": "on",
        "text": "on",
        "file_data": [
            {
                "url": "https://example.com/catalog/kompyutery/",
                "method": "листинг товаров",
                "name": "Компьютеры",
                "queries": "купить компьютер,компьютеры москва,компьютер цена",
                "length": "1500"
            }
        ]
    },
    "response": {
        "https://example.com/catalog/kompyutery/": "Title: Купить компьютер в Москве — цены в каталоге\n\nDescription: Компьютеры для дома и офиса…\n\nH1: Компьютеры\n\nДетальное описание: В каталоге — готовые системные блоки…\n\n"
    },
    "response_parsed": {
        "https://example.com/catalog/kompyutery/": {
            "url": "https://example.com/catalog/kompyutery/",
            "title": "Купить компьютер в Москве — цены в каталоге",
            "description": "Компьютеры для дома и офиса…",
            "h1": "Компьютеры",
            "text": "<p> В каталоге — готовые системные блоки…</p>\n"
        }
    },
    "part": "complex",
    "image_url": null,
    "json_data": [],
    "time": "2026-10-06 14:41:05",
    "cost": 115
}

Ошибки

Код	Сообщение	Когда
`-100`	`tools errors`	Задача не поставлена, причины в `details`: нет ни `metatags`, ни `text` («Выберите тип контента»); у страницы нет `url`, `method` или одновременно `name` и `queries`, либо `method` не из списка; больше 250 страниц; неизвестная модель; бесплатный тариф; не хватает лимитов; фильтр 18+.
`-60`	`tools errors`	Уже 5 незавершённых задач ИИ-генератора текста (`MAX_PARALLEL_TASKS_FAIL`).
`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"
}

metatags и text: передавайте только нужное

Значение off работает не так, как ожидается. Валидация и разбор ответа проверяют только наличие параметра, а промпт — значение on. Поэтому metatags=off&text=on сгенерирует только текст, но в response_parsed всё равно появятся пустые title, description, h1; а metatags=off&text=off пройдёт проверку и сгенерирует мета-теги. Ненужный параметр просто не передавайте.

Стоимость

Цена модели (та же, что у одиночной генерации в aicontent) × число страниц в file_data, списывается при постановке. Цены моделей задаются в настройках инструмента, а не в коде, и видны в интерфейсе.

Ограничения

Не больше 250 страниц за задачу — большие списки разбивайте.
Без name мета-теги пишутся только по запросам: название страницы в промпт мета-тегов не попадает. Передавайте queries, если нужны только мета-теги.
Повторяющийся URL перезапишет результат предыдущей страницы с тем же адресом.
Режим api-complex с полем data из старой документации не работает — используйте part=complex и file_data.