프로필

프로필 엔드포인트를 사용하여 API 키 소유자의 계정 ID, 계층, 크레딧 및 남은 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"
}

업데이트 가능한 필드는 서버에 의해 제어됩니다. 알 수 없는 필드는 무시되거나 거부될 수 있습니다. 프로필 유효성 검사 오류로 인해 관련 없는 생성 작업이 차단되지 않도록 프로필 업데이트를 미디어 작업 생성과 별도로 유지하세요.

청구 및 크레딧

프로필 끝점은 배치 이전에 가장 안전한 경량 검사입니다. 계정에 다음 작업을 위한 충분한 크레딧이나 할당량이 있는지 여부를 표시할 수 있지만 예약 시스템은 아닙니다. 귀하의 수표와 미디어 요청 사이에 다른 작업자가 잔액을 소비할 수 있습니다.

중요한 작업 흐름의 경우 프로필 스냅샷을 배치 ID와 함께 저장하세요. 나중에 할당량 문제로 인해 작업이 실패하는 경우 해당 스냅샷은 기존의 낮은 잔액을 다른 프로세스의 동시 사용과 구별하는 데 도움이 됩니다.

오류