Что такое token (API KEY)
token — это ключ API, который вы используете для вызова APIYI, начиная сsk-. Это учетные данные для подтверждения вашей личности и прав доступа. Его основные функции включают:
Аутентификация
Каждый вызов API должен содержать token для проверки вашей личности и учетной записи.
Управление квотой и разрешениями
Назначайте отдельную квоту, дату истечения, разрешенные модели и группы для каждого token.
Статистика использования
Отслеживайте расходы каждого token, оставшуюся квоту и журналы вызовов независимо.
Гибкое распределение
Создавайте отдельные tokens для разных проектов или участников команды.
После регистрации система автоматически создает token по умолчанию, который готов к использованию сразу. Вы также можете создавать дополнительные tokens по мере необходимости.
Как создать token
1
Откройте страницу token
Откройте страницу «Token» в верхней навигации: https://api.apiyi.com/token
2
Нажмите «Создать»
Нажмите кнопку «Создать» в правом верхнем углу, чтобы открыть диалоговое окно создания token.
3
Заполните сведения о token
Укажите имя token, квоту (неограниченная — опционально), срок действия (без ограничения срока — опционально), режим тарификации и группу (см. ниже).
4
Сохраните и скопируйте KEY
После сохранения нажмите значок копирования справа от token, чтобы скопировать полный
sk- ключ.
Редактирование token и просмотр примеров кода
Нажмите меню управления (значок гаечного ключа) в столбце «Действия», чтобы развернуть все операции:
«Пример запроса» — это точка входа для примера кода. Он генерирует готовый к запуску код вызова с уже подставленным текущим token, поэтому вам не нужно вручную собирать KEY и эндпоинт — идеально для быстрого тестирования и интеграции.
Будет ли совместное использование одного token несколькими людьми приводить к лимиту запросов?
Частый вопрос от клиентов: «Если один token используют несколько человек, будет ли действовать лимит запросов?» Ответ: сам token не имеет лимита запросов. Лимит запросов определяется аккаунтом — независимо от того, сколько у вас token или сколько людей ими пользуются. Один token, которым пользуются 10 человек, работает точно так же, как 10 token, которые использует по одному человеку.RPM (запросов в минуту)
В общем, один аккаунт с нагрузкой до 100 RPM — это вполне нормально: этого хватает для подавляющего большинства команд и приложений.
TPM (tokens в минуту)
TPM не применяется, поэтому вам не нужно беспокоиться о длинных context window или большом объеме token при высокой параллельности, которые могут вызвать лимиты.
Что такое группа
Группа — это «ресурсный канал», который вы можете выбрать для token. Разные группы соответствуют разным upstream-ресурсам, доступным диапазонам моделей и коэффициентам тарифа и доступны для выбора пользователями. Иными словами: одна и та же модель может обслуживаться через несколько upstream-каналов, а группа позволяет вам выбрать, какой канал использовать. Для разных моделей могут требоваться разные группы, поэтому правильный выбор группы гарантирует, что вызов сработает и вы получите соответствующую скидку.В подавляющем большинстве случаев вам достаточно группы по умолчанию (Default) — она покрывает все модели, включая текстовые модели, серию NanoBanana, Veo 3.1 и большинство остальных.
Группа по умолчанию и резервные группы
Один token может иметь до 3 групп: 1 группу по умолчанию + 2 резервные группы.Группа по умолчанию (основная)
Группа, которую token использует первой; подходит для большинства моделей. У каждого token должна быть 1 группа по умолчанию.
Резервные группы (резерв)
Резервные каналы, которые автоматически активируются, когда группа по умолчанию не может обработать запрос. До 2, что повышает успешность вызовов.
- Выбрать группу: назначает группу по умолчанию (основную),
Defaultпо умолчанию - Резервная группа: добавьте 1–2 резервные группы, которые подхватывают обработку, когда основная недоступна
Разным моделям нужны разные группы
Группа по умолчанию подходит для большинства моделей, но некоторым моделям (особенно видео-моделям) требуется выделенная группа:Обзор групп
Ниже приведены группы и описания, предоставленные системой (отображение в консоли является авторитетным):
Столбец «Коэффициент группы» содержит относительное значение в юанях — это не прямой коэффициент скидки в долларах США, поэтому не нужно подвергать его чрезмерному анализу. Просто выберите группу, соответствующую вашей модели. Чтобы понять коэффициенты и пересчёт цены, см. Что такое коэффициент модели?.
Связанные документы
Режимы тарификации token
Узнайте о различиях между режимами оплаты за использование и оплаты за вызов.
Белый список моделей token
Узнайте, как ограничить модели, доступные для использования одним token.
Коэффициент модели
Узнайте, что означает коэффициент и как рассчитывается цена.
Журналы вызовов
Просматривайте записи о вызовах и сведения о расходах для каждого token.