Документация API

В этом руководстве вы найдете основные команды для взаимодействия с Mitup AI.

Следующие нейросети в настоящее время доступны через API. Вы можете использовать их имена при создании запроса.

Gemini

Другие нейросети на данный момент пока что недоступны

Параметры запроса

Параметр	Тип	Обязательный	Описание
ai	object	Да	Информация о AI
content	object	Да	Данные о продукте
name (внутри content)	object	Да	Название продукта
brand (внутри content)	object	Нет	Информация о бренде
category (внутри content)	object	Нет	Категория товара
specs (внутри content)	object	Нет	Характеристики товара (Лимит 20 шт)

Примеры запросов

1. Генерация описаний для товаров

Генерация описания для товаров на основании переданных параметров. Для генерации описания могут быть выбраны любые сущности, которые вы передаете. Чем больше параметров вы передаете, тем качественней результат вы получите.

POST /api/v1/products/text

curl -X POST "https://ai.mitup.ru/api/v1/products/text" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-d '{
    "ai": {
         "name": "gemini"
    },
    "content": {
        "name": "Мини диктофон Ambertek VR125",
        "brand": "Apelline",
        "specs": {
            "city": "Москва",
            "USB": "USB 2.0 тип A",
            "USB-кабель": "Есть"
        },
        "category": "Диктофоны"
    }
}'

import requests
url = "https://ai.mitup.ru/api/v1/products/text"
api_key = "YOUR_ACCESS_TOKEN"
params = {
    "ai": {
        "name": "gemini"
    },
    "content": {
        "name": "Мини диктофон Ambertek VR125",
        "brand": "Apelline",
        "specs": {
            "city": "Москва",
            "USB": "USB 2.0 тип A",
            "USB-кабель": "Есть"
        },
        "category": "Диктофоны"
    }
}

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {api_key}"
}

response = requests.post(url, json=params, headers=headers)
print(response.json())

<?php
$url = "https://ai.mitup.ru/api/v1/products/text";
$api_key = "YOUR_ACCESS_TOKEN";

$params = array(
    "ai" => array(
        "name" => "gemini"
    ),
    "content" => array(
            "name" => "Мини диктофон Ambertek VR125",
            "brand" => "Apelline",
            "specs" => array(
            "city" => "Москва",
            "USB" => "USB 2.0 тип A",
            "USB-кабель" => "Есть"
        ),
        "category" => "Диктофоны"
    )
);

$headers = array(
    "Content-Type: application/json",
    "Authorization: Bearer " . $api_key
);

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_USERAGENT, "Opera/10.00 (Windows NT 5.1; U; ru) Presto/2.2.0");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($params));

$response = curl_exec($curl);
curl_close($curl);
$response = json_decode($response, true);
print_r($response);
?>

2. Генерация отзывов для товаров

Генерация отзывов для товаров на основании переданных параметров. Для генерации отзывов могут использоваться прошлые оставленные отзывы.

POST /api/v1/products/review

curl -X POST "https://ai.mitup.ru/api/v1/products/review" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-d '{
    "ai": {
         "name": "gemini"
    },
    "content": {
        "name": "Мини диктофон Ambertek VR125",
        "brand": "Apelline",
        "specs": {
            "city": "Москва",
            "USB": "USB 2.0 тип A",
            "USB-кабель": "Есть"
        },
        "category": "Диктофоны",
        "reviews": [
            "1 отзыв",
            "2 отзыв",
            …
        ]
    }
}'

import requests
url = "https://ai.mitup.ru/api/v1/products/review"
api_key = "YOUR_ACCESS_TOKEN"
params = {
    "ai": {
        "name": "gemini"
    },
    "content": {
        "name": "Мини диктофон Ambertek VR125",
        "brand": "Apelline",
        "specs": {
            "city": "Москва",
            "USB": "USB 2.0 тип A",
            "USB-кабель": "Есть"
        },
        "category": "Диктофоны",
        "reviews": [
            "1 отзыв",
            "2 отзыв",
            …
        ]
    }
}

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {api_key}"
}

response = requests.post(url, json=params, headers=headers)
print(response.json())

<?php
$url = "https://ai.mitup.ru/api/v1/products/review";
$api_key = "YOUR_ACCESS_TOKEN";

$params = array(
    "ai" => array(
        "name" => "gemini"
    ),
    "content" => array(
            "name" => "Мини диктофон Ambertek VR125",
            "brand" => "Apelline",
            "specs" => array(
            "city" => "Москва",
            "USB" => "USB 2.0 тип A",
            "USB-кабель" => "Есть"
        ),
        "category" => "Диктофоны"
        "reviews": [
            "1 отзыв",
            "2 отзыв",
            …
        ]
    )
);

$headers = array(
    "Content-Type: application/json",
    "Authorization: Bearer " . $api_key
);

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_USERAGENT, "Opera/10.00 (Windows NT 5.1; U; ru) Presto/2.2.0");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($params));

$response = curl_exec($curl);
curl_close($curl);
$response = json_decode($response, true);
print_r($response);
?>

Коды ответов

Код	Описание
200	Успешный запрос
400	Неверный запрос. Ошибка в параметрах запроса
401	Не авторизован. Неверный или отсутствующий токен
500	Внутренняя ошибка сервера

REST API

Генерация описания товара

POST /api/v1/products/text

Генерация отзыва товара

POST /api/v1/products/review