Перейти к основному содержанию
POST
/
v1
/
tokens
curl --request POST \
  --url 'https://toapis.com/v1/tokens' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Мой новый токен",
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false
  }'
{
  "success": true,
  "message": "",
  "data": {
    "id": 123,
    "user_id": 456,
    "key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": 1,
    "name": "Мой новый токен",
    "created_time": 1738483200,
    "accessed_time": 1738483200,
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false,
    "used_quota": 0,
    "model_limits_enabled": false,
    "model_limits": "",
    "group": "",
    "cross_group_retry": false
  }
}
  • Создание нового API токена через API
  • Настройка имени токена и времени истечения
  • Настройка лимитов квоты и ограничений моделей
  • Ключ токена возвращается только один раз при создании
Уведомление о безопасностиПожалуйста, надежно сохраните возвращенный ключ токена (поле key). Он отображается только один раз при создании и не может быть получен позже.

Авторизация

Authorization
string
обязательно
Все конечные точки требуют аутентификации Bearer TokenПолучите ваш API Key:Посетите страницу управления API Key чтобы получить ваш API KeyДобавьте его в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

Тело запроса

name
string
обязательно
Имя токена, максимум 50 символовПример: "Мой новый токен"
expired_time
integer
по умолчанию:"-1"
Время истечения токена (Unix timestamp в секундах)
  • Установите -1 для бессрочного токена
  • Установите конкретный timestamp для истечения в это время
Пример: 1738483200 (2025-02-02 00:00:00 UTC)
remain_quota
integer
по умолчанию:"0"
Оставшаяся квота токена (внутренние единицы)Конвертация: 500000 = $1 USDПример: 500000 (эквивалент $1)
unlimited_quota
boolean
по умолчанию:"false"
Имеет ли токен неограниченную квоту
  • true: Неограниченная квота, без ограничений
  • false: Ограниченная квота, используется значение remain_quota
Пример: false
model_limits_enabled
boolean
по умолчанию:"false"
Включить ли ограничения моделей
  • true: Включить ограничения, доступны только модели из model_limits
  • false: Без ограничений моделей
Пример: false
model_limits
string
по умолчанию:""
Список разрешенных моделей (через запятую)Действует только когда model_limits_enabled равно trueПример: "gpt-4o,gpt-4o-mini,claude-3-5-sonnet"
group
string
по умолчанию:""
Имя группы токенаИспользуется для указания группы каналов для этого токенаПример: "default"

Ответ

success
boolean
Успешен ли запрос
message
string
Сообщение об ошибке (возвращается только при неудаче)
data
object
Информация о созданном токене (возвращается при успехе)
curl --request POST \
  --url 'https://toapis.com/v1/tokens' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Мой новый токен",
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false
  }'
{
  "success": true,
  "message": "",
  "data": {
    "id": 123,
    "user_id": 456,
    "key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": 1,
    "name": "Мой новый токен",
    "created_time": 1738483200,
    "accessed_time": 1738483200,
    "expired_time": -1,
    "remain_quota": 500000,
    "unlimited_quota": false,
    "used_quota": 0,
    "model_limits_enabled": false,
    "model_limits": "",
    "group": "",
    "cross_group_retry": false
  }
}

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

  • Автоматизация создания нескольких API токенов
  • Создание отдельных токенов для разных приложений или сервисов
  • Пакетное управление жизненным циклом токенов через скрипты
Формат ключа токенаПоле key, возвращаемое при успехе - случайная строка из 48 символов. При использовании добавьте префикс sk- для полного формата: sk-xxxxxxxx...
Лучшие практики
  • Создавайте разные токены для разных целей для удобства отслеживания и управления
  • Устанавливайте разумное время истечения и регулярно ротируйте токены
  • Включайте ограничения моделей, если вам нужен доступ только к определенным моделям для повышения безопасности

Частые ошибки

Сообщение об ошибкеПричинаРешение
令牌名称过长Имя превышает 50 символовИспользуйте более короткое имя токена
生成令牌失败Внутренняя ошибка системыПовторите позже или обратитесь в поддержку
Ошибка аутентификацииAPI Key недействителен или истекПроверьте правильность API Key
Уведомление о безопасности
  • Созданный ключ токена возвращается только один раз в ответе, сохраните его немедленно
  • Не храните API Keys в клиентском коде
  • Всегда используйте HTTPS в продакшене
  • Создавайте отдельные токены для каждого приложения для удобства управления и отзыва