88API88API
Руководство пользователяAI-приложенияAPIПомощь и поддержка
Руководство по модулям API

пользовательский модуль

Описание функции

Префикс интерфейса: https://88api.ai

Интерфейсы, связанные с аккаунтом: регистрация и вход, личные данные, управление токенами, пополнение баланса и оплата, партнёрская программа. Поддерживаются 2FA, подтверждение электронной почты и несколько способов входа через OAuth.

Регистрация/вход в аккаунт

🔐 Аутентификация не требуется

Зарегистрируйте новый аккаунт

  • Имя интерфейса: зарегистрируйте новую учетную запись.
  • Метод HTTP: POST
  • Путь: /api/user/register
  • Требования аутентификации: общедоступно.
  • Введение в функцию: создание новой учетной записи пользователя, поддержка функций проверки электронной почты и кода рекомендации.

💡Пример запроса:

const response = await fetch('/api/user/register', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    username: "newuser",
    password: "password123",
    email: "user@example.com",
    verification_code: "123456",
    aff_code: "INVITE123"
  })
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "Регистрация пользователя прошла успешно"
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Администратор закрыл регистрацию нового пользователя"
}

🧾 Описание поля:

  • username (строка): имя пользователя, обязательно.
  • password (строка): требуется пароль.
  • email (строка): адрес электронной почты, требуется, если включена проверка электронной почты.
  • verification_code (строка): код подтверждения электронной почты, требуется, если включена проверка электронной почты.
  • aff_code (строка): код рекомендации, необязательно.

Вход пользователя

  • Имя интерфейса: Логин пользователя.
  • Метод HTTP: POST
  • Путь: /api/user/login
  • Требования аутентификации: общедоступно.
  • Введение в функцию: вход в учетную запись пользователя, поддержка двухэтапной проверки (2FA).

💡Пример запроса:

const response = await fetch('/api/user/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    username: "testuser",
    password: "password123"
  })
});
const data = await response.json();

✅ Пример успешного ответа (без 2FA):

{
  "success": true,
  "message": "Вход успешен",
  "data": {
    "token": "user_access_token",
    "user": {
      "id": 1,
      "username": "testuser",
      "role": 1,
      "quota": 1000000
    }
  }
}

✅ Пример успешного ответа (требуется 2FA):

{
  "success": true,
  "message": "Пожалуйста, введите код двухэтапной проверки",
  "data": {
    "require_2fa": true
  }
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Администратор отключил вход по паролю"
}

🧾 Описание поля:

  • username (строка): имя пользователя, обязательно.
  • password (строка): требуется пароль.
  • require_2fa (логическое значение): требуется ли двухэтапная проверка.

Обратный вызов платежа Epay

  • Имя интерфейса: обратный вызов платежа Epay.
  • Метод HTTP: GET
  • Путь: /api/user/epay/notify
  • Требования аутентификации: общедоступно.
  • Введение в функцию: обработка уведомлений об обратном платеже из системы EasyPay.

💡Пример запроса:

_// Обычно вызывается платёжной системой автоматически, вызывать вручную не нужно  _
_// Пример URL: /api/user/epay/notify?trade_no=USR1NO123456&money=10.00&trade_status=TRADE_SUCCESS_

✅ Пример успешного ответа:

{
  "success": true,
  "message": "Платеж успешен"
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Заказ не существует или был обработан"
}

🧾 Описание поля:

  • trade_no (строка): номер заказа транзакции.
  • money (строка): Сумма платежа
  • trade_status (строка): статус транзакции.
  • sign (строка): проверка подписи

Список всех групп (неаутентифицированная версия)

  • Имя интерфейса: список всех групп.
  • Метод HTTP: GET
  • Путь: /api/user/groups
  • Требования аутентификации: общедоступно.
  • Введение в функцию: получите всю информацию о группах пользователей в системе и получите к ней доступ без входа в систему.

💡Пример запроса:

const response = await fetch('/api/user/groups', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "",
  "data": {
    "default": {
      "ratio": 1.0,
      "desc": "Группировка по умолчанию"
    },
    "vip": {
      "ratio": 0.8,
      "desc": "VIPГруппа"
    },
    "auto": {
      "ratio": "автоматический",
      "desc": "Автоматически выбирать лучшую группировку"
    }
  }
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Не удалось получить информацию о группе."
}

🧾 Описание поля:

data (объект): отображение информации о группе.

  • ключ (строка): имя группы
  • ratio (число/строка): увеличение группировки, «авто» означает автоматический выбор.
  • desc (строка): описание группы.

🔐 Аутентификация пользователя

Выйти

  • Имя интерфейса: выход из системы.
  • Метод HTTP: GET
  • Путь: /api/user/logout
  • Требования аутентификации: Пользователь
  • Введение в функцию: очистить сеанс пользователя и выйти из системы.

💡Пример запроса:

const response = await fetch('/api/user/logout', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": ""
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Очистка сеанса не удалась"
}

🧾 Описание поля:

Нет параметров запроса

Собственная операция пользователя

🔐 Аутентификация пользователя

Узнайте, в какой группе вы состоите

  • Имя интерфейса: узнайте группу, в которой вы находитесь.
  • Метод HTTP: GET
  • Путь: /api/user/self/groups
  • Требования аутентификации: Пользователь
  • Введение в функцию: получение информации о группировке, доступной текущему вошедшему в систему пользователю, включая увеличение и описание группировки.

💡Пример запроса:

const response = await fetch('/api/user/self/groups', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "",
  "data": {
    "default": {
      "ratio": 1.0,
      "desc": "Группировка по умолчанию"
    },
    "vip": {
      "ratio": 0.8,
      "desc": "VIPГруппа"
    },
    "auto": {
      "ratio": "автоматический",
      "desc": "Автоматически выбирать лучшую группировку"
    }
  }
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Не удалось получить информацию о группе."
}

🧾 Описание поля:

data (объект): отображение информации о доступной пользователю группе

  • ключ (строка): имя группы
  • ratio (число/строка): увеличение группировки, «автоматический» означает автоматический выбор оптимальной группировки.
  • desc (строка): описание группы.

Получить личную информацию

  • Имя интерфейса: получение личной информации.
  • Метод HTTP: GET
  • Путь: /api/user/self
  • Требования аутентификации: Пользователь
  • Введение в функцию: получение подробной информации о текущем пользователе, включая разрешения, квоты, настройки и т. д.

💡Пример запроса:

const response = await fetch('/api/user/self', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "",
  "data": {
    "id": 1,
    "username": "testuser",
    "display_name": "Test User",
    "role": 1,
    "status": 1,
    "email": "user@example.com",
    "group": "default",
    "quota": 1000000,
    "used_quota": 50000,
    "request_count": 100,
    "aff_code": "ABC123",
    "aff_count": 5,
    "aff_quota": 10000,
    "aff_history_quota": 50000,
    "inviter_id": 0,
    "linux_do_id": "",
    "setting": "{}",
    "stripe_customer": "",
    "sidebar_modules": "{\"chat\":{\"enabled\":true}}",
    "permissions": {
      "can_view_logs": true,
      "can_manage_tokens": true
    }
  }
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Не удалось получить информацию о пользователе."
}

🧾 Описание поля:

  • id (числовой): идентификатор пользователя.
  • username (строка): имя пользователя
  • display_name (строка): отображаемое имя.
  • role (номер): роль пользователя, для обычного пользователя — 1.
  • status (номер): статус пользователя, 1 = нормально, 2 = отключено
  • email (строка): адрес электронной почты.
  • group (строка): группа, к которой он принадлежит.
  • quota (число): общая квота
  • used_quota (число): использованная квота.
  • request_count (число): количество запросов.
  • aff_code (строка): код рекомендации.
  • aff_count (число): количество рефералов.
  • aff_quota (число): квота реферального вознаграждения
  • aff_history_quota (число): историческая рекомендуемая квота.
  • inviter_id (номер): идентификатор приглашающего.
  • linux_do_id (строка): идентификатор учетной записи LinuxDo.
  • setting (строка): строка JSON пользовательских настроек.
  • stripe_customer (строка): идентификатор клиента Stripe.
  • sidebar_modules (строка): строка JSON конфигурации модуля боковой панели.
  • permissions (объект): информация о разрешениях пользователя.

Получите видимость модели

  • Имя интерфейса: получение видимости модели.
  • Метод HTTP: GET
  • Путь: /api/user/models
  • Требования аутентификации: Пользователь
  • Введение в функцию: получение списка моделей ИИ, доступных текущему пользователю.

💡Пример запроса:

const response = await fetch('/api/user/models', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "",
  "data": [
    "gpt-5.5",
    "claude-sonnet-5-5",
    "gemini-3.5-flash",
    "deepseek-v4-flash"
  ]
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Не удалось получить список моделей."
}

🧾 Описание поля:

data (массив): список названий моделей, доступных пользователю.

Изменение личной информации

  • Имя интерфейса: изменение личной информации.
  • Метод HTTP: PUT
  • Путь: /api/user/self
  • Требования аутентификации: Пользователь
  • Введение в функцию: обновление личной информации пользователя или настроек боковой панели.

💡 Пример запроса (обновление личной информации):

const response = await fetch('/api/user/self', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    display_name: "New Display Name",
    email: "newemail@example.com"
  })
});
const data = await response.json();

💡 Пример запроса (обновление настроек боковой панели):

const response = await fetch('/api/user/self', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    sidebar_modules: JSON.stringify({
      chat: { enabled: true, playground: true },
      console: { enabled: true, token: true }
    })
  })
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "Обновление успешно выполнено"
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Ввод незаконен"
}

🧾 Описание поля:

  • display_name (строка): отображаемое имя, необязательно.
  • email (строка): адрес электронной почты, необязательно.
  • password (строка): новый пароль, необязательно.
  • sidebar_modules (строка): строка JSON конфигурации модуля боковой панели, необязательно.

Отменить учетную запись

  • Имя интерфейса: выход из учетной записи.
  • Метод HTTP: DELETE
  • Путь: /api/user/self
  • Требования аутентификации: Пользователь
  • Введение в функцию: удаление текущей учетной записи пользователя.

💡Пример запроса:

const response = await fetch('/api/user/self', {
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": ""
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Не могу удалить учетную запись суперадминистратора"
}

🧾 Описание поля:

Нет параметров запроса

Создать токен доступа уровня пользователя

  • Имя интерфейса: создать токен доступа на уровне пользователя.
  • Метод HTTP: GET
  • Путь: /api/user/token
  • Требования аутентификации: Пользователь
  • Введение в функцию: создание нового токена доступа для текущего пользователя для вызовов API.

💡Пример запроса:

const response = await fetch('/api/user/token', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "",
  "data": "`<YOUR_API_KEY>`"
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Не удалось сгенерировать токен"
}

🧾 Описание поля:

data (строка): созданный токен доступа.

Получите информацию о промокоде

  • Имя интерфейса: получение информации о промокоде.
  • Метод HTTP: GET
  • Путь: /api/user/aff
  • Требования аутентификации: Пользователь
  • Введение в функцию: получите или сгенерируйте промокод пользователя, который используется для приглашения новых пользователей зарегистрироваться.

💡Пример запроса:

const response = await fetch('/api/user/aff', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  }
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "",
  "data": "ABC123"
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Не удалось получить промокод"
}

🧾 Описание поля:

data (строка): промокод пользователя. Если он не существует, автоматически будет сгенерирована случайная строка из 4 цифр.

Прямое пополнение баланса

  • Название интерфейса: прямое пополнение баланса.
  • Метод HTTP: POST
  • Путь: /api/user/topup
  • Требования аутентификации: Пользователь
  • Введение в функцию: используйте код погашения для пополнения квоты аккаунта.

💡Пример запроса:

const response = await fetch('/api/user/topup', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    key: "REDEEM123456"
  })
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "Погашение успешно",
  "data": 100000
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Код активации недействителен или уже использован."
}

🧾 Описание поля:

  • key (строка): требуется код активации.
  • data (число): возвращает сумму квоты, погашенную в случае успеха.

Отправьте платежное поручение

  • Имя интерфейса: Отправить платежное поручение
  • Метод HTTP: POST
  • Путь: /api/user/pay
  • Требования аутентификации: Пользователь
  • Введение в функцию: создание онлайн-платежных поручений с поддержкой нескольких способов оплаты.

💡Пример запроса:

const response = await fetch('/api/user/pay', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    amount: 10000,
    payment_method: "alipay",
    top_up_code: ""
  })
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "success",
  "data": {
    "pid": "12345",
    "type": "alipay",
    "out_trade_no": "USR1NO123456",
    "notify_url": "https://example.com/notify",
    "return_url": "https://example.com/return",
    "name": "TUC10000",
    "money": "10.00",
    "sign": "abc123def456"
  },
  "url": "https://pay.example.com/submit"
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Сумма пополнения не может быть меньше 1000"
}

🧾 Описание поля:

  • amount (число): сумма пополнения должна быть больше или равна минимальной сумме пополнения
  • payment_method (строка): способ оплаты, например «alipay», «wxpay» и т. д.
  • top_up_code (строка): код пополнения, необязательно.
  • data (объект): параметры формы оплаты.
  • url (строка): адрес отправки платежа

Расчёт суммы платежа

  • Имя интерфейса: расчёт суммы платежа.
  • Метод HTTP: POST
  • Путь: /api/user/amount
  • Требования аутентификации: Пользователь
  • Введение в функцию: расчет фактической суммы платежа, соответствующей указанной сумме пополнения счета.

💡Пример запроса:

const response = await fetch('/api/user/amount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    amount: 10000,
    top_up_code: ""
  })
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "success",
  "data": "10.00"
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Сумма пополнения не может быть меньше 1000"
}

🧾 Описание поля:

  • amount (число): сумма пополнения должна быть больше или равна минимальной сумме пополнения.
  • top_up_code (строка): код пополнения, необязательно.
  • data (строка): фактическая сумма к оплате (юани)

Перевод рекламного кредита

  • Название интерфейса: Перевод рекламного кредита.
  • Метод HTTP: POST
  • Путь: /api/user/aff_transfer
  • Требования аутентификации: Пользователь
  • Введение в функцию: конвертируйте сумму вознаграждения по акции в доступную квоту.

💡Пример запроса:

const response = await fetch('/api/user/aff_transfer', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    quota: 50000
  })
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "Перенос успешен"
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "邀请额度不足!"
}

🧾 Описание поля:

quota (число): сумма конвертируемой квоты должна быть больше или равна минимальной квоте единицы.

Обновить настройки пользователя

  • Имя интерфейса: обновить настройки пользователя.
  • Метод HTTP: PUT
  • Путь: /api/user/setting
  • Требования аутентификации: Пользователь
  • Введение в функцию: обновление конфигурации личных настроек пользователя.

💡Пример запроса:

const response = await fetch('/api/user/setting', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_user_token',
    'New-Api-User': 'your_user_id'
  },
  body: JSON.stringify({
    theme: "dark",
    language: "zh-CN",
    notifications: {
      email: true,
      browser: false
    }
  })
});
const data = await response.json();

✅ Пример успешного ответа:

{
  "success": true,
  "message": "Настройки успешно обновлены"
}

❗ Пример реакции на ошибку:

{
  "success": false,
  "message": "Ошибка формата установки"
}

🧾 Описание поля:

  • Тело запроса может содержать любые поля пользовательских настроек и отправляется в формате JSON.