documentazione
Area personale
API dell’area personale

Schemi dei dati

Markdown

Campi e tipi degli oggetti dell’API dell’area personale.

Guida completa

Campi degli oggetti dell’API dell’area personale e relativi tipi. omitempty significa che il campo può mancare nella risposta; non autorizza a inviare null. Le stringhe PLACEHOLDER indicano il tipo, non una risposta reale.

APIKey

Il campoTipoObbligatorioVerifica / descrizione
idintegerno
user_idintegerno
keystringno
namestringno
statusstringno
ip_whitelistarray · items: stringno
ip_blacklistarray · items: stringno
last_used_atstringno; può essere null
last_used_ipstringno; può essere null
quotanumberno; Limite di spesa della chiave in USD; 0 — senza limite
quota_usednumberno; Importo consumato del limite della chiave, USD
expires_atstringno; Validità; null — senza scadenza; può essere null
created_atstringno
updated_atstringno
current_concurrencyintegerno
rate_limit_5hnumberno
rate_limit_1dnumberno
rate_limit_7dnumberno
usage_5hnumberno
usage_1dnumberno
usage_7dnumberno
window_5h_startstringno; può essere null
window_1d_startstringno; può essere null
window_7d_startstringno; può essere null
reset_5h_atstringno; può essere null
reset_1d_atstringno; può essere null
reset_7d_atstringno; può essere null
userobject · Userno; può essere null
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
datestringno
requestsintegerno
input_tokensintegerno
output_tokensintegerno
cache_read_tokensintegerno
cache_write_tokensintegerno
total_tokensintegerno
costnumberno; Costo al prezzo standard
actual_costnumberno; Addebito effettivo
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
access_tokenstringno
refresh_tokenstringno; Token di rinnovo della sessione
expires_inintegerno; Validità del token di accesso in secondi
token_typestringno
userobject · Userno; può essere null
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
api_key_idsarray · items: integer (int64)sìrequired
Campi dell’oggetto
{
  "api_key_ids": "PLACEHOLDER_API_KEY_IDS (array)"
}

BatchAPIKeyUsageStats

Il campoTipoObbligatorioVerifica / descrizione
api_key_idintegerno
today_actual_costnumberno
total_actual_costnumberno
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
old_passwordstringsìrequired
new_passwordstringsìrequired,min=6
Campi dell’oggetto
{
  "old_password": "PLACEHOLDER_OLD_PASSWORD (string)",
  "new_password": "PLACEHOLDER_NEW_PASSWORD (string)"
}

CreateAPIKeyRequest

Il campoTipoObbligatorioVerifica / descrizione
namestringsìrequired
custom_keystringno; Valore personalizzato facoltativo della chiave; può essere null
ip_whitelistarray · items: stringno; Elenco degli IP consentiti
ip_blacklistarray · items: stringno; Elenco degli IP bloccati
quotanumberno; Limite di spesa della chiave in USD; può essere null
expires_in_daysintegerno; Durata di validità in giorni; può essere null
rate_limit_5hnumberno; può essere null
rate_limit_1dnumberno; può essere null
rate_limit_7dnumberno; può essere null
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
emailstringsìrequired,email
turnstile_tokenstringno
Campi dell’oggetto
{
  "email": "PLACEHOLDER_EMAIL (string)",
  "turnstile_token": "PLACEHOLDER_TURNSTILE_TOKEN (string)"
}

ForgotPasswordResponse

Il campoTipoObbligatorioVerifica / descrizione
messagestringno
Campi dell’oggetto
{
  "message": "PLACEHOLDER_MESSAGE (string)"
}

Login2FARequest

Il campoTipoObbligatorioVerifica / descrizione
temp_tokenstringsìrequired
totp_codestringsìrequired,len=6
Campi dell’oggetto
{
  "temp_token": "PLACEHOLDER_TEMP_TOKEN (string)",
  "totp_code": "PLACEHOLDER_TOTP_CODE (string)"
}

LoginRequest

Il campoTipoObbligatorioVerifica / descrizione
emailstringsìrequired,email
passwordstringsìrequired
turnstile_tokenstringno
Campi dell’oggetto
{
  "email": "PLACEHOLDER_EMAIL (string)",
  "password": "PLACEHOLDER_PASSWORD (string)",
  "turnstile_token": "PLACEHOLDER_TURNSTILE_TOKEN (string)"
}

LogoutRequest

Il campoTipoObbligatorioVerifica / descrizione
refresh_tokenstringno; Facoltativo: revocare il token di rinnovo specificato
Campi dell’oggetto
{
  "refresh_token": "PLACEHOLDER_REFRESH_TOKEN (string)"
}

LogoutResponse

Il campoTipoObbligatorioVerifica / descrizione
messagestringno
Campi dell’oggetto
{
  "message": "PLACEHOLDER_MESSAGE (string)"
}

PasskeyBeginLoginRequest

Il campoTipoObbligatorioVerifica / descrizione
turnstile_tokenstringno
Campi dell’oggetto
{
  "turnstile_token": "PLACEHOLDER_TURNSTILE_TOKEN (string)"
}

PasskeyCredentialSummary

Il campoTipoObbligatorioVerifica / descrizione
idintegerno
namestringno
created_atstringno
last_used_atstringno; può essere null
backupbooleanno
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
session_tokenstringsìrequired
namestringno
credentialobject · WebAuthn PublicKeyCredential JSONsìrequired
Campi dell’oggetto
{
  "session_token": "PLACEHOLDER_SESSION_TOKEN (string)",
  "name": "PLACEHOLDER_NAME (string)",
  "credential": "PLACEHOLDER_CREDENTIAL (object)"
}

PasskeyOptionsResponse

Il campoTipoObbligatorioVerifica / descrizione
session_tokenstringno
optionsanyno
Campi dell’oggetto
{
  "session_token": "PLACEHOLDER_SESSION_TOKEN (string)",
  "options": "PLACEHOLDER_OPTIONS (any)"
}

RedeemCode

Il campoTipoObbligatorioVerifica / descrizione
idintegerno
codestringno
typestringno
valuenumberno
statusstringno
used_byintegerno; può essere null
used_atstringno; può essere null
created_atstringno
expires_atstringno; può essere null
validity_daysintegerno
notesstringno; può essere null
userobject · Userno; può essere null
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
codestringsìrequired
Campi dell’oggetto
{
  "code": "PLACEHOLDER_CODE (string)"
}

RefreshTokenRequest

Il campoTipoObbligatorioVerifica / descrizione
refresh_tokenstringsìrequired
Campi dell’oggetto
{
  "refresh_token": "PLACEHOLDER_REFRESH_TOKEN (string)"
}

RefreshTokenResponse

Il campoTipoObbligatorioVerifica / descrizione
access_tokenstringno
refresh_tokenstringno
expires_inintegerno; Validità del token di accesso in secondi
token_typestringno
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
emailstringsìrequired,email
passwordstringsìrequired,min=6
verify_codestringno
turnstile_tokenstringno
promo_codestringno; Codice promozionale di registrazione
invitation_codestringno; Codice invito
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
emailstringsìrequired,email
tokenstringsìrequired
new_passwordstringsìrequired,min=6
Campi dell’oggetto
{
  "email": "PLACEHOLDER_EMAIL (string)",
  "token": "PLACEHOLDER_TOKEN (string)",
  "new_password": "PLACEHOLDER_NEW_PASSWORD (string)"
}

ResetPasswordResponse

Il campoTipoObbligatorioVerifica / descrizione
messagestringno
Campi dell’oggetto
{
  "message": "PLACEHOLDER_MESSAGE (string)"
}

RevokeAllSessionsResponse

Il campoTipoObbligatorioVerifica / descrizione
messagestringno
Campi dell’oggetto
{
  "message": "PLACEHOLDER_MESSAGE (string)"
}

SendVerifyCodeRequest

Il campoTipoObbligatorioVerifica / descrizione
emailstringsìrequired,email
turnstile_tokenstringno
Campi dell’oggetto
{
  "email": "PLACEHOLDER_EMAIL (string)",
  "turnstile_token": "PLACEHOLDER_TURNSTILE_TOKEN (string)"
}

SendVerifyCodeResponse

Il campoTipoObbligatorioVerifica / descrizione
messagestringno
countdownintegerno; Tempo di attesa in secondi
Campi dell’oggetto
{
  "message": "PLACEHOLDER_MESSAGE (string)",
  "countdown": "PLACEHOLDER_COUNTDOWN (integer)"
}

TotpLoginResponse

Il campoTipoObbligatorioVerifica / descrizione
requires_2fabooleanno
temp_tokenstringno
user_email_maskedstringno
Campi dell’oggetto
{
  "requires_2fa": "PLACEHOLDER_REQUIRES_2FA (boolean)",
  "temp_token": "PLACEHOLDER_TEMP_TOKEN (string)",
  "user_email_masked": "PLACEHOLDER_USER_EMAIL_MASKED (string)"
}

TotpStatusResponse

Il campoTipoObbligatorioVerifica / descrizione
enabledbooleanno
enabled_atintegerno; Timestamp Unix; può essere null
feature_enabledbooleanno
Campi dell’oggetto
{
  "enabled": "PLACEHOLDER_ENABLED (boolean)",
  "enabled_at": "PLACEHOLDER_ENABLED_AT (integer)",
  "feature_enabled": "PLACEHOLDER_FEATURE_ENABLED (boolean)"
}

UpdateAPIKeyRequest

Il campoTipoObbligatorioVerifica / descrizione
namestringno
statusstringnoomitempty,oneof=active inactive
ip_whitelistarray · items: stringno; IP consentiti: null non modifica l’elenco, un array vuoto lo cancella; può essere null
ip_blacklistarray · items: stringno; IP bloccati: null non modifica l’elenco, un array vuoto lo cancella; può essere null
quotanumberno; Limite di spesa della chiave in USD; 0 — senza limite; può essere null
expires_atstringno; Data e ora di scadenza nel formato ISO 8601; può essere null
reset_quotabooleanno; Azzera la quota consumata del limite di spesa; può essere null
rate_limit_5hnumberno; può essere null
rate_limit_1dnumberno; può essere null
rate_limit_7dnumberno; può essere null
reset_rate_limit_usagebooleanno; Azzera la spesa conteggiata nelle finestre; può essere null
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
usernamestringno; può essere null
avatar_urlstringno; può essere null
balance_notify_enabledbooleanno; può essere null
balance_notify_thresholdnumberno; può essere null
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
idintegerno
user_idintegerno
api_key_idintegerno
request_idstringno
modelstringno
service_tierstringno; può essere null
reasoning_effortstringno; può essere null
input_tokensintegerno
output_tokensintegerno
cache_creation_tokensintegerno
cache_read_tokensintegerno
cache_creation_5m_tokensintegerno
cache_creation_1h_tokensintegerno
input_costnumberno
output_costnumberno
cache_creation_costnumberno
cache_read_costnumberno
total_costnumberno
actual_costnumberno
long_context_billing_appliedbooleanno
request_typestringno
streambooleanno
duration_msintegerno; può essere null
first_token_msintegerno; può essere null
image_countintegerno
image_sizestringno; può essere null
image_input_sizestringno; può essere null
image_output_sizestringno; può essere null
image_input_tokensintegerno
image_input_costnumberno
image_output_tokensintegerno
image_output_costnumberno
image_size_breakdownobject · additionalProperties: integerno
media_typestringno; può essere null
ip_addressstringno; può essere null
session_idstringno; può essere null
created_atstringno
userobject · Userno; può essere null
api_keyobject · APIKeyno; può essere null
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
total_requestsintegerno
total_input_tokensintegerno
total_output_tokensintegerno
total_cache_tokensintegerno
total_cache_creation_tokensintegerno
total_cache_read_tokensintegerno
total_tokensintegerno
total_costnumberno
total_actual_costnumberno
average_duration_msnumberno
endpointsarray · items: EndpointStat · EndpointStatno
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
idintegerno
emailstringno
usernamestringno
rolestringno
balancenumberno
frozen_balancenumberno
concurrencyintegerno
statusstringno
last_active_atstringno; può essere null
created_atstringno
updated_atstringno
deleted_atstringno; può essere null
balance_notify_enabledbooleanno
balance_notify_threshold_typestringno
balance_notify_thresholdnumberno; può essere null
balance_notify_extra_emailsarray · items: NotifyEmailEntry · NotifyEmailEntryno
total_rechargednumberno
rpm_limitintegerno
api_keysarray · items: APIKey · APIKeyno
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
idintegerno
titlestringno
contentstringno
notify_modestringno
starts_atstringno; può essere null
ends_atstringno; può essere null
read_atstringno; può essere null
created_atstringno
updated_atstringno
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
total_api_keysintegerno
active_api_keysintegerno
total_requestsintegerno
total_input_tokensintegerno
total_output_tokensintegerno
total_cache_creation_tokensintegerno
total_cache_read_tokensintegerno
total_tokensintegerno
total_costnumberno; Costo totale al prezzo standard
total_actual_costnumberno; Addebito effettivo totale
today_requestsintegerno
today_input_tokensintegerno
today_output_tokensintegerno
today_cache_creation_tokensintegerno
today_cache_read_tokensintegerno
today_tokensintegerno
today_costnumberno; Costo di oggi al prezzo standard
today_actual_costnumberno; Addebito effettivo di oggi
average_duration_msnumberno
rpmintegerno; Numero medio di richieste al minuto negli ultimi 5 minuti
tpmintegerno; Numero medio di token al minuto negli ultimi 5 minuti
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
idintegerno
emailstringno
usernamestringno
rolestringno
balancenumberno
frozen_balancenumberno
concurrencyintegerno
statusstringno
last_active_atstringno; può essere null
created_atstringno
updated_atstringno
deleted_atstringno; può essere null
balance_notify_enabledbooleanno
balance_notify_threshold_typestringno
balance_notify_thresholdnumberno; può essere null
balance_notify_extra_emailsarray · items: NotifyEmailEntry · NotifyEmailEntryno
total_rechargednumberno
rpm_limitintegerno
api_keysarray · items: APIKey · APIKeyno
avatar_urlstringno
email_boundbooleanno
Campi dell’oggetto
{
  "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

Il campoTipoObbligatorioVerifica / descrizione
codestringsìrequired
Campi dell’oggetto
{
  "code": "PLACEHOLDER_CODE (string)"
}

ValidateInvitationCodeResponse

Il campoTipoObbligatorioVerifica / descrizione
validbooleanno
error_codestringno
Campi dell’oggetto
{
  "valid": "PLACEHOLDER_VALID (boolean)",
  "error_code": "PLACEHOLDER_ERROR_CODE (string)"
}

ValidatePromoCodeRequest

Il campoTipoObbligatorioVerifica / descrizione
codestringsìrequired
Campi dell’oggetto
{
  "code": "PLACEHOLDER_CODE (string)"
}

ValidatePromoCodeResponse

Il campoTipoObbligatorioVerifica / descrizione
validbooleanno
bonus_amountnumberno
error_codestringno
messagestringno
Campi dell’oggetto
{
  "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"
    }
  }
}
Hai altre domande? Invia il Request ID e una descrizione — ti aiuteremo a chiarire il problema.Contatta l’assistenza
AccediRegistrazioneArea personale
Tariffe