Профиль

Используйте конечные точки профиля, чтобы проверить идентификатор учетной записи, уровень, кредиты и оставшуюся квоту API владельца ключа API. Вызовите эту конечную точку перед большими пакетами, после важных заданий и во время операционных проверок.

Получить профиль

GET /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY

Запрос

Запрос не требует тела.

curl https://kittaai.com/api/open/v1/profile \
  -H "Authorization: Bearer KITTA_API_KEY"

Ответ

{
  "user_id": "user_123",
  "api_quota_remaining": 988000,
  "tier": "pro",
  "credits": 1200
}

Рассматривайте неизвестные поля как дополнительные и избегайте сбоев строгих анализаторов, когда ответ получает новые метаданные учетной записи или платежных данных.

Обновить профиль

POST /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY
Content-Type: application/json

{
  "webhookUrl": "https://example.com/webhooks/fishspeech"
}

Обновляемые поля контролируются сервером. Неизвестные поля могут быть проигнорированы или отклонены. Держите обновления профиля отдельно от создания заданий мультимедиа, чтобы ошибка проверки профиля не могла блокировать несвязанную работу по созданию.

Выставление счетов и кредиты

Конечная точка профиля — это самая безопасная упрощенная проверка перед пакетной передачей. Она может показать, будет ли на учетной записи достаточно кредитов или квоты для следующей операции, но это не система резервирования. Между вашим чеком и медиа-запросом другие работники могут использовать баланс.

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

Ошибки