데이터 스키마

대시보드 API 객체의 필드와 타입입니다.

전체 가이드

대시보드 API 객체의 필드와 타입입니다. omitempty는 응답에 필드가 없을 수 있다는 뜻이며 null 전송을 허용한다는 뜻이 아닙니다. PLACEHOLDER 문자열은 실제 응답이 아니라 타입을 나타냅니다.

APIKey

필드	타입	필수	검증 / 설명
`id`	`integer`	아니요
`user_id`	`integer`	아니요
`key`	`string`	아니요
`name`	`string`	아니요
`status`	`string`	아니요
`ip_whitelist`	`array` · `items: string`	아니요
`ip_blacklist`	`array` · `items: string`	아니요
`last_used_at`	`string`	아니요	; null 가능
`last_used_ip`	`string`	아니요	; null 가능
`quota`	`number`	아니요	; 키의 USD 지출 한도. 0은 무제한
`quota_used`	`number`	아니요	; 키 한도에서 사용한 금액, USD
`expires_at`	`string`	아니요	; 유효기간. null이면 만료 없음. null 가능
`created_at`	`string`	아니요
`updated_at`	`string`	아니요
`current_concurrency`	`integer`	아니요
`rate_limit_5h`	`number`	아니요
`rate_limit_1d`	`number`	아니요
`rate_limit_7d`	`number`	아니요
`usage_5h`	`number`	아니요
`usage_1d`	`number`	아니요
`usage_7d`	`number`	아니요
`window_5h_start`	`string`	아니요	; null 가능
`window_1d_start`	`string`	아니요	; null 가능
`window_7d_start`	`string`	아니요	; null 가능
`reset_5h_at`	`string`	아니요	; null 가능
`reset_1d_at`	`string`	아니요	; null 가능
`reset_7d_at`	`string`	아니요	; null 가능
`user`	object · User	아니요	; null 가능

객체 필드

{
  "id": "PLACEHOLDER_ID (integer)",
  "user_id": "PLACEHOLDER_USER_ID (integer)",
  "key": "PLACEHOLDER_KEY (string)",
  "name": "PLACEHOLDER_NAME (string)",
  "status": "PLACEHOLDER_STATUS (string)",
  "ip_whitelist": "PLACEHOLDER_IP_WHITELIST (array)",
  "ip_blacklist": "PLACEHOLDER_IP_BLACKLIST (array)",
  "last_used_at": "PLACEHOLDER_LAST_USED_AT (string)",
  "last_used_ip": "PLACEHOLDER_LAST_USED_IP (string)",
  "quota": "PLACEHOLDER_QUOTA (number)",
  "quota_used": "PLACEHOLDER_QUOTA_USED (number)",
  "expires_at": "PLACEHOLDER_EXPIRES_AT (string)",
  "created_at": "PLACEHOLDER_CREATED_AT (string)",
  "updated_at": "PLACEHOLDER_UPDATED_AT (string)",
  "current_concurrency": "PLACEHOLDER_CURRENT_CONCURRENCY (integer)",
  "rate_limit_5h": "PLACEHOLDER_RATE_LIMIT_5H (number)",
  "rate_limit_1d": "PLACEHOLDER_RATE_LIMIT_1D (number)",
  "rate_limit_7d": "PLACEHOLDER_RATE_LIMIT_7D (number)",
  "usage_5h": "PLACEHOLDER_USAGE_5H (number)",
  "usage_1d": "PLACEHOLDER_USAGE_1D (number)",
  "usage_7d": "PLACEHOLDER_USAGE_7D (number)",
  "window_5h_start": "PLACEHOLDER_WINDOW_5H_START (string)",
  "window_1d_start": "PLACEHOLDER_WINDOW_1D_START (string)",
  "window_7d_start": "PLACEHOLDER_WINDOW_7D_START (string)",
  "reset_5h_at": "PLACEHOLDER_RESET_5H_AT (string)",
  "reset_1d_at": "PLACEHOLDER_RESET_1D_AT (string)",
  "reset_7d_at": "PLACEHOLDER_RESET_7D_AT (string)",
  "user": "PLACEHOLDER_USER (object)"
}

APIKeyDailyUsagePoint

필드	타입	필수	검증 / 설명
`date`	`string`	아니요
`requests`	`integer`	아니요
`input_tokens`	`integer`	아니요
`output_tokens`	`integer`	아니요
`cache_read_tokens`	`integer`	아니요
`cache_write_tokens`	`integer`	아니요
`total_tokens`	`integer`	아니요
`cost`	`number`	아니요	; 기본 요금으로 계산한 비용
`actual_cost`	`number`	아니요	; 실제 차감액

객체 필드

{
  "date": "PLACEHOLDER_DATE (string)",
  "requests": "PLACEHOLDER_REQUESTS (integer)",
  "input_tokens": "PLACEHOLDER_INPUT_TOKENS (integer)",
  "output_tokens": "PLACEHOLDER_OUTPUT_TOKENS (integer)",
  "cache_read_tokens": "PLACEHOLDER_CACHE_READ_TOKENS (integer)",
  "cache_write_tokens": "PLACEHOLDER_CACHE_WRITE_TOKENS (integer)",
  "total_tokens": "PLACEHOLDER_TOTAL_TOKENS (integer)",
  "cost": "PLACEHOLDER_COST (number)",
  "actual_cost": "PLACEHOLDER_ACTUAL_COST (number)"
}

AuthResponse

필드	타입	필수	검증 / 설명
`access_token`	`string`	아니요
`refresh_token`	`string`	아니요	; 세션 갱신 토큰
`expires_in`	`integer`	아니요	; 접근 토큰 유효기간(초)
`token_type`	`string`	아니요
`user`	object · User	아니요	; null 가능

객체 필드

{
  "access_token": "PLACEHOLDER_ACCESS_TOKEN (string)",
  "refresh_token": "PLACEHOLDER_REFRESH_TOKEN (string)",
  "expires_in": "PLACEHOLDER_EXPIRES_IN (integer)",
  "token_type": "PLACEHOLDER_TOKEN_TYPE (string)",
  "user": "PLACEHOLDER_USER (object)"
}

BatchAPIKeysUsageRequest

필드	타입	필수	검증 / 설명
`api_key_ids`	`array` · `items: integer (int64)`	예	required

객체 필드

{
  "api_key_ids": "PLACEHOLDER_API_KEY_IDS (array)"
}

BatchAPIKeyUsageStats

필드	타입	필수
`api_key_id`	`integer`	아니요
`today_actual_cost`	`number`	아니요
`total_actual_cost`	`number`	아니요

객체 필드

{
  "api_key_id": "PLACEHOLDER_API_KEY_ID (integer)",
  "today_actual_cost": "PLACEHOLDER_TODAY_ACTUAL_COST (number)",
  "total_actual_cost": "PLACEHOLDER_TOTAL_ACTUAL_COST (number)"
}

ChangePasswordRequest

필드	타입	필수	검증 / 설명
`old_password`	`string`	예	required
`new_password`	`string`	예	required,min=6

객체 필드

{
  "old_password": "PLACEHOLDER_OLD_PASSWORD (string)",
  "new_password": "PLACEHOLDER_NEW_PASSWORD (string)"
}

CreateAPIKeyRequest

필드	타입	필수	검증 / 설명
`name`	`string`	예	required
`custom_key`	`string`	아니요	; 선택 사항인 사용자 지정 키 값. null 가능
`ip_whitelist`	`array` · `items: string`	아니요	; 허용 IP 목록
`ip_blacklist`	`array` · `items: string`	아니요	; 차단 IP 목록
`quota`	`number`	아니요	; 키의 USD 지출 한도. null 가능
`expires_in_days`	`integer`	아니요	; 유효기간(일). null 가능
`rate_limit_5h`	`number`	아니요	; null 가능
`rate_limit_1d`	`number`	아니요	; null 가능
`rate_limit_7d`	`number`	아니요	; null 가능

객체 필드

{
  "name": "PLACEHOLDER_NAME (string)",
  "custom_key": "PLACEHOLDER_CUSTOM_KEY (string)",
  "ip_whitelist": "PLACEHOLDER_IP_WHITELIST (array)",
  "ip_blacklist": "PLACEHOLDER_IP_BLACKLIST (array)",
  "quota": "PLACEHOLDER_QUOTA (number)",
  "expires_in_days": "PLACEHOLDER_EXPIRES_IN_DAYS (integer)",
  "rate_limit_5h": "PLACEHOLDER_RATE_LIMIT_5H (number)",
  "rate_limit_1d": "PLACEHOLDER_RATE_LIMIT_1D (number)",
  "rate_limit_7d": "PLACEHOLDER_RATE_LIMIT_7D (number)"
}

ForgotPasswordRequest

필드	타입	필수	검증 / 설명
`email`	`string`	예	required,email
`turnstile_token`	`string`	아니요

객체 필드

{
  "email": "PLACEHOLDER_EMAIL (string)",
  "turnstile_token": "PLACEHOLDER_TURNSTILE_TOKEN (string)"
}

ForgotPasswordResponse

필드	타입	필수	검증 / 설명
`message`	`string`	아니요

객체 필드

{
  "message": "PLACEHOLDER_MESSAGE (string)"
}

Login2FARequest

필드	타입	필수	검증 / 설명
`temp_token`	`string`	예	required
`totp_code`	`string`	예	required,len=6

객체 필드

{
  "temp_token": "PLACEHOLDER_TEMP_TOKEN (string)",
  "totp_code": "PLACEHOLDER_TOTP_CODE (string)"
}

LoginRequest

필드	타입	필수	검증 / 설명
`email`	`string`	예	required,email
`password`	`string`	예	required
`turnstile_token`	`string`	아니요

객체 필드

{
  "email": "PLACEHOLDER_EMAIL (string)",
  "password": "PLACEHOLDER_PASSWORD (string)",
  "turnstile_token": "PLACEHOLDER_TURNSTILE_TOKEN (string)"
}

LogoutRequest

필드	타입	필수	검증 / 설명
`refresh_token`	`string`	아니요	; 선택 사항: 지정된 갱신 토큰 폐기

객체 필드

{
  "refresh_token": "PLACEHOLDER_REFRESH_TOKEN (string)"
}

LogoutResponse

필드	타입	필수	검증 / 설명
`message`	`string`	아니요

객체 필드

{
  "message": "PLACEHOLDER_MESSAGE (string)"
}

PasskeyBeginLoginRequest

필드	타입	필수	검증 / 설명
`turnstile_token`	`string`	아니요

객체 필드

{
  "turnstile_token": "PLACEHOLDER_TURNSTILE_TOKEN (string)"
}

PasskeyCredentialSummary

필드	타입	필수	검증 / 설명
`id`	`integer`	아니요
`name`	`string`	아니요
`created_at`	`string`	아니요
`last_used_at`	`string`	아니요	; null 가능
`backup`	`boolean`	아니요

객체 필드

{
  "id": "PLACEHOLDER_ID (integer)",
  "name": "PLACEHOLDER_NAME (string)",
  "created_at": "PLACEHOLDER_CREATED_AT (string)",
  "last_used_at": "PLACEHOLDER_LAST_USED_AT (string)",
  "backup": "PLACEHOLDER_BACKUP (boolean)"
}

PasskeyFinishRequest

필드	타입	필수	검증 / 설명
`session_token`	`string`	예	required
`name`	`string`	아니요
`credential`	`object` · `WebAuthn PublicKeyCredential JSON`	예	required

객체 필드

{
  "session_token": "PLACEHOLDER_SESSION_TOKEN (string)",
  "name": "PLACEHOLDER_NAME (string)",
  "credential": "PLACEHOLDER_CREDENTIAL (object)"
}

PasskeyOptionsResponse

필드	타입	필수	검증 / 설명
`session_token`	`string`	아니요
`options`	`any`	아니요

객체 필드

{
  "session_token": "PLACEHOLDER_SESSION_TOKEN (string)",
  "options": "PLACEHOLDER_OPTIONS (any)"
}

RedeemCode

필드	타입	필수	검증 / 설명
`id`	`integer`	아니요
`code`	`string`	아니요
`type`	`string`	아니요
`value`	`number`	아니요
`status`	`string`	아니요
`used_by`	`integer`	아니요	; null 가능
`used_at`	`string`	아니요	; null 가능
`created_at`	`string`	아니요
`expires_at`	`string`	아니요	; null 가능
`validity_days`	`integer`	아니요
`notes`	`string`	아니요	; null 가능
`user`	object · User	아니요	; null 가능

객체 필드

{
  "id": "PLACEHOLDER_ID (integer)",
  "code": "PLACEHOLDER_CODE (string)",
  "type": "PLACEHOLDER_TYPE (string)",
  "value": "PLACEHOLDER_VALUE (number)",
  "status": "PLACEHOLDER_STATUS (string)",
  "used_by": "PLACEHOLDER_USED_BY (integer)",
  "used_at": "PLACEHOLDER_USED_AT (string)",
  "created_at": "PLACEHOLDER_CREATED_AT (string)",
  "expires_at": "PLACEHOLDER_EXPIRES_AT (string)",
  "validity_days": "PLACEHOLDER_VALIDITY_DAYS (integer)",
  "notes": "PLACEHOLDER_NOTES (string)",
  "user": "PLACEHOLDER_USER (object)"
}

RedeemRequest

필드	타입	필수	검증 / 설명
`code`	`string`	예	required

객체 필드

{
  "code": "PLACEHOLDER_CODE (string)"
}

RefreshTokenRequest

필드	타입	필수	검증 / 설명
`refresh_token`	`string`	예	required

객체 필드

{
  "refresh_token": "PLACEHOLDER_REFRESH_TOKEN (string)"
}

RefreshTokenResponse

필드	타입	필수	검증 / 설명
`access_token`	`string`	아니요
`refresh_token`	`string`	아니요
`expires_in`	`integer`	아니요	; 접근 토큰 유효기간(초)
`token_type`	`string`	아니요

객체 필드

{
  "access_token": "PLACEHOLDER_ACCESS_TOKEN (string)",
  "refresh_token": "PLACEHOLDER_REFRESH_TOKEN (string)",
  "expires_in": "PLACEHOLDER_EXPIRES_IN (integer)",
  "token_type": "PLACEHOLDER_TOKEN_TYPE (string)"
}

RegisterRequest

필드	타입	필수	검증 / 설명
`email`	`string`	예	required,email
`password`	`string`	예	required,min=6
`verify_code`	`string`	아니요
`turnstile_token`	`string`	아니요
`promo_code`	`string`	아니요	; 회원가입 프로모션 코드
`invitation_code`	`string`	아니요	; 초대 코드

객체 필드

{
  "email": "PLACEHOLDER_EMAIL (string)",
  "password": "PLACEHOLDER_PASSWORD (string)",
  "verify_code": "PLACEHOLDER_VERIFY_CODE (string)",
  "turnstile_token": "PLACEHOLDER_TURNSTILE_TOKEN (string)",
  "promo_code": "PLACEHOLDER_PROMO_CODE (string)",
  "invitation_code": "PLACEHOLDER_INVITATION_CODE (string)"
}

ResetPasswordRequest

필드	타입	필수	검증 / 설명
`email`	`string`	예	required,email
`token`	`string`	예	required
`new_password`	`string`	예	required,min=6

객체 필드

{
  "email": "PLACEHOLDER_EMAIL (string)",
  "token": "PLACEHOLDER_TOKEN (string)",
  "new_password": "PLACEHOLDER_NEW_PASSWORD (string)"
}

ResetPasswordResponse

필드	타입	필수	검증 / 설명
`message`	`string`	아니요

객체 필드

{
  "message": "PLACEHOLDER_MESSAGE (string)"
}

RevokeAllSessionsResponse

필드	타입	필수	검증 / 설명
`message`	`string`	아니요

객체 필드

{
  "message": "PLACEHOLDER_MESSAGE (string)"
}

SendVerifyCodeRequest

필드	타입	필수	검증 / 설명
`email`	`string`	예	required,email
`turnstile_token`	`string`	아니요

객체 필드

{
  "email": "PLACEHOLDER_EMAIL (string)",
  "turnstile_token": "PLACEHOLDER_TURNSTILE_TOKEN (string)"
}

SendVerifyCodeResponse

필드	타입	필수	검증 / 설명
`message`	`string`	아니요
`countdown`	`integer`	아니요	; 대기 시간(초)

객체 필드

{
  "message": "PLACEHOLDER_MESSAGE (string)",
  "countdown": "PLACEHOLDER_COUNTDOWN (integer)"
}

TotpLoginResponse

필드	타입	필수
`requires_2fa`	`boolean`	아니요
`temp_token`	`string`	아니요
`user_email_masked`	`string`	아니요

객체 필드

{
  "requires_2fa": "PLACEHOLDER_REQUIRES_2FA (boolean)",
  "temp_token": "PLACEHOLDER_TEMP_TOKEN (string)",
  "user_email_masked": "PLACEHOLDER_USER_EMAIL_MASKED (string)"
}

TotpStatusResponse

필드	타입	필수	검증 / 설명
`enabled`	`boolean`	아니요
`enabled_at`	`integer`	아니요	; Unix 타임스탬프. null 가능
`feature_enabled`	`boolean`	아니요

객체 필드

{
  "enabled": "PLACEHOLDER_ENABLED (boolean)",
  "enabled_at": "PLACEHOLDER_ENABLED_AT (integer)",
  "feature_enabled": "PLACEHOLDER_FEATURE_ENABLED (boolean)"
}

UpdateAPIKeyRequest

필드	타입	필수	검증 / 설명
`name`	`string`	아니요
`status`	`string`	아니요	omitempty,oneof=active inactive
`ip_whitelist`	`array` · `items: string`	아니요	; 허용 IP: null은 목록을 변경하지 않고 빈 배열은 목록을 비웁니다. null 가능
`ip_blacklist`	`array` · `items: string`	아니요	; 차단 IP: null은 목록을 변경하지 않고 빈 배열은 목록을 비웁니다. null 가능
`quota`	`number`	아니요	; 키의 USD 지출 한도. 0은 무제한. null 가능
`expires_at`	`string`	아니요	; ISO 8601 형식의 만료 시각. null 가능
`reset_quota`	`boolean`	아니요	; 지출 한도에서 사용한 금액 초기화. null 가능
`rate_limit_5h`	`number`	아니요	; null 가능
`rate_limit_1d`	`number`	아니요	; null 가능
`rate_limit_7d`	`number`	아니요	; null 가능
`reset_rate_limit_usage`	`boolean`	아니요	; 시간 창별 한도에 누적된 지출 초기화. null 가능

객체 필드

{
  "name": "PLACEHOLDER_NAME (string)",
  "status": "PLACEHOLDER_STATUS (string)",
  "ip_whitelist": "PLACEHOLDER_IP_WHITELIST (array)",
  "ip_blacklist": "PLACEHOLDER_IP_BLACKLIST (array)",
  "quota": "PLACEHOLDER_QUOTA (number)",
  "expires_at": "PLACEHOLDER_EXPIRES_AT (string)",
  "reset_quota": "PLACEHOLDER_RESET_QUOTA (boolean)",
  "rate_limit_5h": "PLACEHOLDER_RATE_LIMIT_5H (number)",
  "rate_limit_1d": "PLACEHOLDER_RATE_LIMIT_1D (number)",
  "rate_limit_7d": "PLACEHOLDER_RATE_LIMIT_7D (number)",
  "reset_rate_limit_usage": "PLACEHOLDER_RESET_RATE_LIMIT_USAGE (boolean)"
}

UpdateProfileRequest

필드	타입	필수	검증 / 설명
`username`	`string`	아니요	; null 가능
`avatar_url`	`string`	아니요	; null 가능
`balance_notify_enabled`	`boolean`	아니요	; null 가능
`balance_notify_threshold`	`number`	아니요	; null 가능

객체 필드

{
  "username": "PLACEHOLDER_USERNAME (string)",
  "avatar_url": "PLACEHOLDER_AVATAR_URL (string)",
  "balance_notify_enabled": "PLACEHOLDER_BALANCE_NOTIFY_ENABLED (boolean)",
  "balance_notify_threshold": "PLACEHOLDER_BALANCE_NOTIFY_THRESHOLD (number)"
}

UsageLog

필드	타입	필수	검증 / 설명
`id`	`integer`	아니요
`user_id`	`integer`	아니요
`api_key_id`	`integer`	아니요
`request_id`	`string`	아니요
`model`	`string`	아니요
`service_tier`	`string`	아니요	; null 가능
`reasoning_effort`	`string`	아니요	; null 가능
`input_tokens`	`integer`	아니요
`output_tokens`	`integer`	아니요
`cache_creation_tokens`	`integer`	아니요
`cache_read_tokens`	`integer`	아니요
`cache_creation_5m_tokens`	`integer`	아니요
`cache_creation_1h_tokens`	`integer`	아니요
`input_cost`	`number`	아니요
`output_cost`	`number`	아니요
`cache_creation_cost`	`number`	아니요
`cache_read_cost`	`number`	아니요
`total_cost`	`number`	아니요
`actual_cost`	`number`	아니요
`long_context_billing_applied`	`boolean`	아니요
`request_type`	`string`	아니요
`stream`	`boolean`	아니요
`duration_ms`	`integer`	아니요	; null 가능
`first_token_ms`	`integer`	아니요	; null 가능
`image_count`	`integer`	아니요
`image_size`	`string`	아니요	; null 가능
`image_input_size`	`string`	아니요	; null 가능
`image_output_size`	`string`	아니요	; null 가능
`image_input_tokens`	`integer`	아니요
`image_input_cost`	`number`	아니요
`image_output_tokens`	`integer`	아니요
`image_output_cost`	`number`	아니요
`image_size_breakdown`	`object` · `additionalProperties: integer`	아니요
`media_type`	`string`	아니요	; null 가능
`ip_address`	`string`	아니요	; null 가능
`session_id`	`string`	아니요	; null 가능
`created_at`	`string`	아니요
`user`	object · User	아니요	; null 가능
`api_key`	object · APIKey	아니요	; null 가능

객체 필드

{
  "id": "PLACEHOLDER_ID (integer)",
  "user_id": "PLACEHOLDER_USER_ID (integer)",
  "api_key_id": "PLACEHOLDER_API_KEY_ID (integer)",
  "request_id": "PLACEHOLDER_REQUEST_ID (string)",
  "model": "PLACEHOLDER_MODEL (string)",
  "service_tier": "PLACEHOLDER_SERVICE_TIER (string)",
  "reasoning_effort": "PLACEHOLDER_REASONING_EFFORT (string)",
  "input_tokens": "PLACEHOLDER_INPUT_TOKENS (integer)",
  "output_tokens": "PLACEHOLDER_OUTPUT_TOKENS (integer)",
  "cache_creation_tokens": "PLACEHOLDER_CACHE_CREATION_TOKENS (integer)",
  "cache_read_tokens": "PLACEHOLDER_CACHE_READ_TOKENS (integer)",
  "cache_creation_5m_tokens": "PLACEHOLDER_CACHE_CREATION_5M_TOKENS (integer)",
  "cache_creation_1h_tokens": "PLACEHOLDER_CACHE_CREATION_1H_TOKENS (integer)",
  "input_cost": "PLACEHOLDER_INPUT_COST (number)",
  "output_cost": "PLACEHOLDER_OUTPUT_COST (number)",
  "cache_creation_cost": "PLACEHOLDER_CACHE_CREATION_COST (number)",
  "cache_read_cost": "PLACEHOLDER_CACHE_READ_COST (number)",
  "total_cost": "PLACEHOLDER_TOTAL_COST (number)",
  "actual_cost": "PLACEHOLDER_ACTUAL_COST (number)",
  "long_context_billing_applied": "PLACEHOLDER_LONG_CONTEXT_BILLING_APPLIED (boolean)",
  "request_type": "PLACEHOLDER_REQUEST_TYPE (string)",
  "stream": "PLACEHOLDER_STREAM (boolean)",
  "duration_ms": "PLACEHOLDER_DURATION_MS (integer)",
  "first_token_ms": "PLACEHOLDER_FIRST_TOKEN_MS (integer)",
  "image_count": "PLACEHOLDER_IMAGE_COUNT (integer)",
  "image_size": "PLACEHOLDER_IMAGE_SIZE (string)",
  "image_input_size": "PLACEHOLDER_IMAGE_INPUT_SIZE (string)",
  "image_output_size": "PLACEHOLDER_IMAGE_OUTPUT_SIZE (string)",
  "image_input_tokens": "PLACEHOLDER_IMAGE_INPUT_TOKENS (integer)",
  "image_input_cost": "PLACEHOLDER_IMAGE_INPUT_COST (number)",
  "image_output_tokens": "PLACEHOLDER_IMAGE_OUTPUT_TOKENS (integer)",
  "image_output_cost": "PLACEHOLDER_IMAGE_OUTPUT_COST (number)",
  "image_size_breakdown": "PLACEHOLDER_IMAGE_SIZE_BREAKDOWN (object)",
  "media_type": "PLACEHOLDER_MEDIA_TYPE (string)",
  "ip_address": "PLACEHOLDER_IP_ADDRESS (string)",
  "session_id": "PLACEHOLDER_SESSION_ID (string)",
  "created_at": "PLACEHOLDER_CREATED_AT (string)",
  "user": "PLACEHOLDER_USER (object)",
  "api_key": "PLACEHOLDER_API_KEY (object)"
}

UsageStats

필드	타입	필수
`total_requests`	`integer`	아니요
`total_input_tokens`	`integer`	아니요
`total_output_tokens`	`integer`	아니요
`total_cache_tokens`	`integer`	아니요
`total_cache_creation_tokens`	`integer`	아니요
`total_cache_read_tokens`	`integer`	아니요
`total_tokens`	`integer`	아니요
`total_cost`	`number`	아니요
`total_actual_cost`	`number`	아니요
`average_duration_ms`	`number`	아니요
`endpoints`	`array` · `items: EndpointStat` · EndpointStat	아니요

객체 필드

{
  "total_requests": "PLACEHOLDER_TOTAL_REQUESTS (integer)",
  "total_input_tokens": "PLACEHOLDER_TOTAL_INPUT_TOKENS (integer)",
  "total_output_tokens": "PLACEHOLDER_TOTAL_OUTPUT_TOKENS (integer)",
  "total_cache_tokens": "PLACEHOLDER_TOTAL_CACHE_TOKENS (integer)",
  "total_cache_creation_tokens": "PLACEHOLDER_TOTAL_CACHE_CREATION_TOKENS (integer)",
  "total_cache_read_tokens": "PLACEHOLDER_TOTAL_CACHE_READ_TOKENS (integer)",
  "total_tokens": "PLACEHOLDER_TOTAL_TOKENS (integer)",
  "total_cost": "PLACEHOLDER_TOTAL_COST (number)",
  "total_actual_cost": "PLACEHOLDER_TOTAL_ACTUAL_COST (number)",
  "average_duration_ms": "PLACEHOLDER_AVERAGE_DURATION_MS (number)",
  "endpoints": "PLACEHOLDER_ENDPOINTS (array)"
}

User

필드	타입	필수	검증 / 설명
`id`	`integer`	아니요
`email`	`string`	아니요
`username`	`string`	아니요
`role`	`string`	아니요
`balance`	`number`	아니요
`frozen_balance`	`number`	아니요
`concurrency`	`integer`	아니요
`status`	`string`	아니요
`last_active_at`	`string`	아니요	; null 가능
`created_at`	`string`	아니요
`updated_at`	`string`	아니요
`deleted_at`	`string`	아니요	; null 가능
`balance_notify_enabled`	`boolean`	아니요
`balance_notify_threshold_type`	`string`	아니요
`balance_notify_threshold`	`number`	아니요	; null 가능
`balance_notify_extra_emails`	`array` · `items: NotifyEmailEntry` · NotifyEmailEntry	아니요
`total_recharged`	`number`	아니요
`rpm_limit`	`integer`	아니요
`api_keys`	`array` · `items: APIKey` · APIKey	아니요

객체 필드

{
  "id": "PLACEHOLDER_ID (integer)",
  "email": "PLACEHOLDER_EMAIL (string)",
  "username": "PLACEHOLDER_USERNAME (string)",
  "role": "PLACEHOLDER_ROLE (string)",
  "balance": "PLACEHOLDER_BALANCE (number)",
  "frozen_balance": "PLACEHOLDER_FROZEN_BALANCE (number)",
  "concurrency": "PLACEHOLDER_CONCURRENCY (integer)",
  "status": "PLACEHOLDER_STATUS (string)",
  "last_active_at": "PLACEHOLDER_LAST_ACTIVE_AT (string)",
  "created_at": "PLACEHOLDER_CREATED_AT (string)",
  "updated_at": "PLACEHOLDER_UPDATED_AT (string)",
  "deleted_at": "PLACEHOLDER_DELETED_AT (string)",
  "balance_notify_enabled": "PLACEHOLDER_BALANCE_NOTIFY_ENABLED (boolean)",
  "balance_notify_threshold_type": "PLACEHOLDER_BALANCE_NOTIFY_THRESHOLD_TYPE (string)",
  "balance_notify_threshold": "PLACEHOLDER_BALANCE_NOTIFY_THRESHOLD (number)",
  "balance_notify_extra_emails": "PLACEHOLDER_BALANCE_NOTIFY_EXTRA_EMAILS (array)",
  "total_recharged": "PLACEHOLDER_TOTAL_RECHARGED (number)",
  "rpm_limit": "PLACEHOLDER_RPM_LIMIT (integer)",
  "api_keys": "PLACEHOLDER_API_KEYS (array)"
}

UserAnnouncement

필드	타입	필수	검증 / 설명
`id`	`integer`	아니요
`title`	`string`	아니요
`content`	`string`	아니요
`notify_mode`	`string`	아니요
`starts_at`	`string`	아니요	; null 가능
`ends_at`	`string`	아니요	; null 가능
`read_at`	`string`	아니요	; null 가능
`created_at`	`string`	아니요
`updated_at`	`string`	아니요

객체 필드

{
  "id": "PLACEHOLDER_ID (integer)",
  "title": "PLACEHOLDER_TITLE (string)",
  "content": "PLACEHOLDER_CONTENT (string)",
  "notify_mode": "PLACEHOLDER_NOTIFY_MODE (string)",
  "starts_at": "PLACEHOLDER_STARTS_AT (string)",
  "ends_at": "PLACEHOLDER_ENDS_AT (string)",
  "read_at": "PLACEHOLDER_READ_AT (string)",
  "created_at": "PLACEHOLDER_CREATED_AT (string)",
  "updated_at": "PLACEHOLDER_UPDATED_AT (string)"
}

UserDashboardStats

필드	타입	필수	검증 / 설명
`total_api_keys`	`integer`	아니요
`active_api_keys`	`integer`	아니요
`total_requests`	`integer`	아니요
`total_input_tokens`	`integer`	아니요
`total_output_tokens`	`integer`	아니요
`total_cache_creation_tokens`	`integer`	아니요
`total_cache_read_tokens`	`integer`	아니요
`total_tokens`	`integer`	아니요
`total_cost`	`number`	아니요	; 기본 요금으로 계산한 총비용
`total_actual_cost`	`number`	아니요	; 실제 총차감액
`today_requests`	`integer`	아니요
`today_input_tokens`	`integer`	아니요
`today_output_tokens`	`integer`	아니요
`today_cache_creation_tokens`	`integer`	아니요
`today_cache_read_tokens`	`integer`	아니요
`today_tokens`	`integer`	아니요
`today_cost`	`number`	아니요	; 기본 요금으로 계산한 오늘 비용
`today_actual_cost`	`number`	아니요	; 오늘 실제 차감액
`average_duration_ms`	`number`	아니요
`rpm`	`integer`	아니요	; 최근 5분 동안의 분당 평균 요청 수
`tpm`	`integer`	아니요	; 최근 5분 동안의 분당 평균 토큰 수

객체 필드

{
  "total_api_keys": "PLACEHOLDER_TOTAL_API_KEYS (integer)",
  "active_api_keys": "PLACEHOLDER_ACTIVE_API_KEYS (integer)",
  "total_requests": "PLACEHOLDER_TOTAL_REQUESTS (integer)",
  "total_input_tokens": "PLACEHOLDER_TOTAL_INPUT_TOKENS (integer)",
  "total_output_tokens": "PLACEHOLDER_TOTAL_OUTPUT_TOKENS (integer)",
  "total_cache_creation_tokens": "PLACEHOLDER_TOTAL_CACHE_CREATION_TOKENS (integer)",
  "total_cache_read_tokens": "PLACEHOLDER_TOTAL_CACHE_READ_TOKENS (integer)",
  "total_tokens": "PLACEHOLDER_TOTAL_TOKENS (integer)",
  "total_cost": "PLACEHOLDER_TOTAL_COST (number)",
  "total_actual_cost": "PLACEHOLDER_TOTAL_ACTUAL_COST (number)",
  "today_requests": "PLACEHOLDER_TODAY_REQUESTS (integer)",
  "today_input_tokens": "PLACEHOLDER_TODAY_INPUT_TOKENS (integer)",
  "today_output_tokens": "PLACEHOLDER_TODAY_OUTPUT_TOKENS (integer)",
  "today_cache_creation_tokens": "PLACEHOLDER_TODAY_CACHE_CREATION_TOKENS (integer)",
  "today_cache_read_tokens": "PLACEHOLDER_TODAY_CACHE_READ_TOKENS (integer)",
  "today_tokens": "PLACEHOLDER_TODAY_TOKENS (integer)",
  "today_cost": "PLACEHOLDER_TODAY_COST (number)",
  "today_actual_cost": "PLACEHOLDER_TODAY_ACTUAL_COST (number)",
  "average_duration_ms": "PLACEHOLDER_AVERAGE_DURATION_MS (number)",
  "rpm": "PLACEHOLDER_RPM (integer)",
  "tpm": "PLACEHOLDER_TPM (integer)"
}

UserProfileResponse

필드	타입	필수	검증 / 설명
`id`	`integer`	아니요
`email`	`string`	아니요
`username`	`string`	아니요
`role`	`string`	아니요
`balance`	`number`	아니요
`frozen_balance`	`number`	아니요
`concurrency`	`integer`	아니요
`status`	`string`	아니요
`last_active_at`	`string`	아니요	; null 가능
`created_at`	`string`	아니요
`updated_at`	`string`	아니요
`deleted_at`	`string`	아니요	; null 가능
`balance_notify_enabled`	`boolean`	아니요
`balance_notify_threshold_type`	`string`	아니요
`balance_notify_threshold`	`number`	아니요	; null 가능
`balance_notify_extra_emails`	`array` · `items: NotifyEmailEntry` · NotifyEmailEntry	아니요
`total_recharged`	`number`	아니요
`rpm_limit`	`integer`	아니요
`api_keys`	`array` · `items: APIKey` · APIKey	아니요
`avatar_url`	`string`	아니요
`email_bound`	`boolean`	아니요

객체 필드

{
  "id": "PLACEHOLDER_ID (integer)",
  "email": "PLACEHOLDER_EMAIL (string)",
  "username": "PLACEHOLDER_USERNAME (string)",
  "role": "PLACEHOLDER_ROLE (string)",
  "balance": "PLACEHOLDER_BALANCE (number)",
  "frozen_balance": "PLACEHOLDER_FROZEN_BALANCE (number)",
  "concurrency": "PLACEHOLDER_CONCURRENCY (integer)",
  "status": "PLACEHOLDER_STATUS (string)",
  "last_active_at": "PLACEHOLDER_LAST_ACTIVE_AT (string)",
  "created_at": "PLACEHOLDER_CREATED_AT (string)",
  "updated_at": "PLACEHOLDER_UPDATED_AT (string)",
  "deleted_at": "PLACEHOLDER_DELETED_AT (string)",
  "balance_notify_enabled": "PLACEHOLDER_BALANCE_NOTIFY_ENABLED (boolean)",
  "balance_notify_threshold_type": "PLACEHOLDER_BALANCE_NOTIFY_THRESHOLD_TYPE (string)",
  "balance_notify_threshold": "PLACEHOLDER_BALANCE_NOTIFY_THRESHOLD (number)",
  "balance_notify_extra_emails": "PLACEHOLDER_BALANCE_NOTIFY_EXTRA_EMAILS (array)",
  "total_recharged": "PLACEHOLDER_TOTAL_RECHARGED (number)",
  "rpm_limit": "PLACEHOLDER_RPM_LIMIT (integer)",
  "api_keys": "PLACEHOLDER_API_KEYS (array)",
  "avatar_url": "PLACEHOLDER_AVATAR_URL (string)",
  "email_bound": "PLACEHOLDER_EMAIL_BOUND (boolean)"
}

ValidateInvitationCodeRequest

필드	타입	필수	검증 / 설명
`code`	`string`	예	required

객체 필드

{
  "code": "PLACEHOLDER_CODE (string)"
}

ValidateInvitationCodeResponse

필드	타입	필수	검증 / 설명
`valid`	`boolean`	아니요
`error_code`	`string`	아니요

객체 필드

{
  "valid": "PLACEHOLDER_VALID (boolean)",
  "error_code": "PLACEHOLDER_ERROR_CODE (string)"
}

ValidatePromoCodeRequest

필드	타입	필수	검증 / 설명
`code`	`string`	예	required

객체 필드

{
  "code": "PLACEHOLDER_CODE (string)"
}

ValidatePromoCodeResponse

필드	타입	필수
`valid`	`boolean`	아니요
`bonus_amount`	`number`	아니요
`error_code`	`string`	아니요
`message`	`string`	아니요

객체 필드

{
  "valid": "PLACEHOLDER_VALID (boolean)",
  "bonus_amount": "PLACEHOLDER_BONUS_AMOUNT (number)",
  "error_code": "PLACEHOLDER_ERROR_CODE (string)",
  "message": "PLACEHOLDER_MESSAGE (string)"
}

NotifyEmailEntry

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string"
    },
    "disabled": {
      "type": "boolean"
    },
    "verified": {
      "type": "boolean"
    }
  }
}

EndpointStat

{
  "type": "object",
  "properties": {
    "endpoint": {
      "type": "string"
    },
    "requests": {
      "type": "integer"
    },
    "total_tokens": {
      "type": "integer"
    },
    "cost": {
      "type": "number"
    },
    "actual_cost": {
      "type": "number"
    }
  }
}

궁금한 점이 남았나요? Request ID와 설명을 보내 주시면 해결을 도와드리겠습니다.지원팀에 문의