Документация на метод "aicontent"

Как это работает

• 1 Берём модель из справочника — вызываем метод с models=1 и выбираем value. Список моделей меняется без предупреждения и зависит от тарифа, поэтому хардкодить его в своём коде не нужно.
• 2 Ставим задачу — POST с промптом и моделью. В ответ приходит report_id. Лимиты списываются в момент создания задачи.
• 3 Забираем результат — периодически (раз в 5–10 секунд) запрашиваем метод с report_id, пока вместо In progress не придёт готовый ответ.

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

/api/aicontent?models=1 — возвращает нейросети, доступные вашему ключу, и их возможности. Задача не создаётся, лимиты не списываются.

Ответ

{
  "models": [
    {
      "name": "GPT 5.4 Thinking",
      "value": "gpt-5.4",
      "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-5.4"
}

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

POST /api/aicontent — параметры передаются телом запроса (multipart/form-data, если прикладываете файл).

Общие параметры

Параметры отдельных режимов

Ответ

{
  "report_id": 18452301
}

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

GET /api/aicontent?report_id={id} — вызывается, пока задача не завершится. Повторные запросы бесплатны.

Задача ещё выполняется

{
  "error": "In progress",
  "code": 50,
  "progress": 64,
  "time": "2026-02-11 14:32:07"
}

Пример результата

{
  "request": {
    "part": "chat_bot",
    "model": "gpt-5.4",
    "request_field": "Составь план статьи про выбор беговых кроссовок"
  },
  "response": "1. Как подобрать кроссовки под тип пронации...",
  "part": "chat_bot",
  "image_url": null,
  "json_data": [],
  "time": "2026-02-11 14:33:12",
  "cost": 90
}

Тарификация

Итоговая стоимость собирается так:

• базовая цена зависит от выбранной модели — у каждой нейросети своя;
• для part=article действует отдельная цена модели «для статей», для web_search=1 — отдельная цена с поиском;
• repeats умножает стоимость: 5 повторов — пятикратная цена;
• в режиме multiple_models цены выбранных моделей суммируются;
• large_texts тарифицируется по числу частей (каждые 10 000 символов — отдельная генерация);
• api-complex — по числу элементов в data.

Если доступных лимитов не хватает, задача не создаётся: в ответе придут код ошибки и точные значения available / need. Фактическое списание всегда возвращается в поле cost вместе с результатом.

Коды ошибок

Пример ошибки валидации

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

Примеры

cURL

# 1. Справочник моделей
curl 'https://tools.pixelplus.ru/api/aicontent?key={ключ-api}&models=1'

# 2. Постановка задачи
curl -X POST 'https://tools.pixelplus.ru/api/aicontent?key={ключ-api}' \
  -d 'part=chat_bot' \
  -d 'model=gpt-5.4' \
  --data-urlencode 'request_field=Составь план статьи про выбор беговых кроссовок'

# 3. Результат
curl 'https://tools.pixelplus.ru/api/aicontent?key={ключ-api}&report_id=18452301'

PHP

<?php

$key = '{ключ-api}';
$base = 'https://tools.pixelplus.ru/api';

function apiRequest(string $url, array $data = null): array
{
    $curl = curl_init();
    $options = [
        CURLOPT_URL => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 120,
    ];
    if ($data !== null) {
        $options[CURLOPT_POST] = true;
        $options[CURLOPT_POSTFIELDS] = $data;
    }
    curl_setopt_array($curl, $options);
    $response = curl_exec($curl);
    curl_close($curl);

    return json_decode($response, true) ?: [];
}

// 1. Берём модель из справочника
$catalog = apiRequest("{$base}/aicontent?key={$key}&models=1");
$model = $catalog['default'];

// 2. Ставим задачу
$task = apiRequest("{$base}/aicontent?key={$key}", [
    'part'          => 'chat_bot',
    'model'         => $model,
    'request_field' => 'Составь план статьи про выбор беговых кроссовок',
]);

if (empty($task['report_id'])) {
    exit('Ошибка: ' . json_encode($task, JSON_UNESCAPED_UNICODE));
}

// 3. Ждём результат
do {
    sleep(10);
    $result = apiRequest("{$base}/aicontent?key={$key}&report_id={$task['report_id']}");
} while (($result['code'] ?? null) === 50);

echo $result['response'] ?? '';

Python

import time
import requests

KEY = '{ключ-api}'
BASE = 'https://tools.pixelplus.ru/api'

# 1. Модель с поиском в интернете, если такая доступна
catalog = requests.get(f'{BASE}/aicontent', params={'key': KEY, 'models': 1}).json()
model = next(
    (m['value'] for m in catalog['models'] if m['isWebSearch']),
    catalog['default'],
)

# 2. Ставим задачу
task = requests.post(
    f'{BASE}/aicontent',
    params={'key': KEY},
    data={
        'part': 'chat_bot',
        'model': model,
        'request_field': 'Какие тренды в беговой обуви появились за последний год?',
        'web_search': 1,
    },
).json()

# 3. Ждём результат
while True:
    result = requests.get(
        f'{BASE}/aicontent',
        params={'key': KEY, 'report_id': task['report_id']},
    ).json()
    if result.get('code') != 50:
        break
    time.sleep(10)

print(result['response'])
print('Списано лимитов:', result['cost'])

Изображение и файл в чат-боте

<?php
// Файл прикладывается только к part=chat_bot и только к модели
// с соответствующим флагом из справочника: isVision — изображение, isFile — документ.

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://tools.pixelplus.ru/api/aicontent?key={ключ-api}",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => [
        'part'          => 'chat_bot',
        'model'         => 'gpt-5.4',
        'request_field' => 'Проанализируй скриншот страницы и дай рекомендации по конверсии',
        'image_upload'  => new CURLFile('/path/to/screenshot.png'),
        // либо ссылкой:
        // 'image_url' => 'https://example.com/screenshot.png',
        // документ вместо картинки:
        // 'file_upload' => new CURLFile('/path/to/brief.pdf'),
    ],
]);
echo curl_exec($curl);
curl_close($curl);

Ограничения и рекомендации

• Модель берите из справочника models=1: список зависит от тарифа ключа и меняется с релизами инструмента.
• Опрашивайте результат не чаще одного раза в 5 секунд — генерация занимает от нескольких секунд до нескольких минут.
• Не больше 5 одновременно выполняющихся задач на пользователя; шестая вернёт MAX_PARALLEL_TASKS_FAIL.
• Ссылки и параметры вида --param в промпте запрещены, текст проходит фильтр 18+.
• Изображение анализируют только модели с isVision, документы — только с isFile. Вложение без нужного флага не вызовет ошибку, но и учтено не будет.
• Готовый результат хранится в истории инструмента: один и тот же report_id можно запрашивать сколько угодно раз бесплатно.
• Пакетные задания (api-complex) ограничены 250 элементами — большие объёмы разбивайте на несколько задач.