資料結構

控制台 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`	否	; 工作階段的更新 token
`expires_in`	`integer`	否	; 存取 token 的有效期限，以秒為單位
`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`	否	; 選填：撤銷指定的更新 token

物件欄位

{
  "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 的有效期限，以秒為單位
`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 分鐘的每分鐘平均 token 數

物件欄位

{
  "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與問題描述，我們會協助釐清。聯絡支援