user

type BalanceWarningThresholdResponse struct {
	// BalanceWarningThreshold 阈值 USD；0 = 关闭
	BalanceWarningThreshold float64 `json:"balance_warning_threshold"`
}

type BalanceWarningThresholdUpdate struct {
	// BalanceWarningThreshold 阈值 USD；0 = 关闭；内部毫分存储（1 USD = 100,000 毫分）
	BalanceWarningThreshold float64 `json:"balance_warning_threshold"`
}

type ChangePasswordResponse struct {
	Updated bool `json:"updated"`
}

type ChiServerOptions struct {
	BaseURL          string
	BaseRouter       chi.Router
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type DeletedResponse struct {
	Deleted bool `json:"deleted"`
}

type Error = ErrorResponse

type ErrorResponse struct {
	// EffectiveFrom 判定后的生效窗口下界（`window_invalid`/`window_ambiguous` 不携带）
	EffectiveFrom *time.Time `json:"effective_from,omitempty"`

	// EffectiveTo 判定后的生效窗口上界（`window_invalid`/`window_ambiguous` 不携带）
	EffectiveTo *time.Time `json:"effective_to,omitempty"`
	Error       string     `json:"error"`

	// LimitSeconds 成本上限秒数（`window_too_long` 携带；0 = 无上限）
	LimitSeconds *int64 `json:"limit_seconds,omitempty"`

	// Reason 统计窗口被拒的机读原因（仅统计端点可能携带）。取值词表取自规划层原因与
	// 拒绝原因的**全量映射表**（唯一来源），本版实际会发出的有五个：
	// raw_horizon/cube_horizon = 起点早于所要读表的保留截止；
	// window_too_long = 请求跨度超过该形状的成本上限；window_invalid =
	// 必填/倒序/`window` 时长串不可解析等参数本身非法；window_ambiguous =
	// `from`/`to`/`window` 三者的"恰择一"未被满足（两态都给、只给一端、
	// 或两态都不给）。offset/dst/span_below_grid 是"该窗口无法用卷积表精确
	// 表达、已降级到原始行"的派生原因（只用于降级告警日志，不作为拒绝原因
	// 发出）。
	Reason *ErrorResponseReason `json:"reason,omitempty"`

	// RetentionDays 覆盖判定所依据的最保守保留天数（`*_horizon` 携带）
	RetentionDays *int `json:"retention_days,omitempty"`

	// Storage 判定所依据的实际存储（`window_invalid`/`window_ambiguous` 不携带）
	Storage *ErrorResponseStorage `json:"storage,omitempty"`
}

type ErrorResponseReason string

type ErrorResponseStorage string

type ErrorType string

type ForgotPasswordRequest struct {
	Email string `json:"email"`
}

type GetUserErrLogsParams struct {
	Limit      *int           `form:"limit,omitempty" json:"limit,omitempty"`
	Cursor     *int64         `form:"cursor,omitempty" json:"cursor,omitempty"`
	GroupId    *int64         `form:"group_id,omitempty" json:"group_id,omitempty"`
	KeyId      *int64         `form:"key_id,omitempty" json:"key_id,omitempty"`
	Model      *string        `form:"model,omitempty" json:"model,omitempty"`
	Format     *RequestFormat `form:"format,omitempty" json:"format,omitempty"`
	StatusCode *int           `form:"status_code,omitempty" json:"status_code,omitempty"`
	ErrorType  *string        `form:"error_type,omitempty" json:"error_type,omitempty"`
	From       time.Time      `form:"from" json:"from"`
	To         time.Time      `form:"to" json:"to"`
}

type GetUserKeysParams struct {
	Limit  *int                    `form:"limit,omitempty" json:"limit,omitempty"`
	Offset *int                    `form:"offset,omitempty" json:"offset,omitempty"`
	Name   *string                 `form:"name,omitempty" json:"name,omitempty"`
	Sort   *string                 `form:"sort,omitempty" json:"sort,omitempty"`
	Order  *GetUserKeysParamsOrder `form:"order,omitempty" json:"order,omitempty"`
}

type GetUserKeysParamsOrder string

type GetUserRedemptionsParams struct {
	Page     *int                           `form:"page,omitempty" json:"page,omitempty"`
	PageSize *int                           `form:"page_size,omitempty" json:"page_size,omitempty"`
	Sort     *string                        `form:"sort,omitempty" json:"sort,omitempty"`
	Order    *GetUserRedemptionsParamsOrder `form:"order,omitempty" json:"order,omitempty"`
}

type GetUserRedemptionsParamsOrder string

type GetUserStatsParams struct {
	From *time.Time `form:"from,omitempty" json:"from,omitempty"`
	To   *time.Time `form:"to,omitempty" json:"to,omitempty"`

	// Window 相对窗口（时长串，Go `time.ParseDuration` 形态，如 `24h`/`168h`/`2160h`）。
	// 给出它时**必须**省略 `from`/`to`（同时给出 → 400 `reason=window_ambiguous`）。
	// 服务端自持时钟：`to` = 当前时刻向上取整到 UTC 整点、`from` = `to` − `window`
	// ⇒ 两端恒整点，命中卷积表的精确分支（零对齐位移、零桶丢失），这就是 UI 预设
	// 走这条形态的理由。
	//
	// **只收时长，不收日历天**：`d` 不是 `time.ParseDuration` 的单位，`7d` → 400
	// （`reason=window_invalid`）。理由：`24h` 与"一个日历天"在 DST 切换日不相等，
	// 而本 API 的唯一对齐基准是固定 1h 网格；另立 `AddDate` 日历语义会引入第二套
	// 窗口长度语义。预设即网格整倍数：24h / 168h / 720h / 2160h。
	Window      *StatsWindow                   `form:"window,omitempty" json:"window,omitempty"`
	Granularity *GetUserStatsParamsGranularity `form:"granularity,omitempty" json:"granularity,omitempty"`
	Model       *string                        `form:"model,omitempty" json:"model,omitempty"`

	// Timezone IANA 时区名（如 Asia/Shanghai / America/New_York；控制台取浏览器时区）。
	// 仅影响**分组读**：时间桶按该时区的本地小时/日界聚合。显式 from/to 恒为
	// 绝对时刻直透，不受时区改写；排行/TTFT 等无分组数值端点接受并校验该参数
	// 但不改变数值。空/缺省 = UTC（兼容旧客户端）；未知名 → 400。overview 的
	// 「今日」日界仍按该时区本地零点计算（窗口是 days，不是 from/to）。
	//
	// 窗口上限**不是一个固定天数**：界不齐时服务端把两端向后取整到整点以换取
	// 卷积表快路径（生效窗口用 X-Stats-Effective-From/To 回显），能否用卷积表
	// 取决于**时区偏移是否恒整点且窗内无 DST 跳变**；DST 或 :30/:45 偏移时区的
	// 分组读只能扫原始明细行。成本上限是保留期无关的纯常量（分组原始行固定
	// 8 天、卷积表 90 天），覆盖上限另有 per-table 保留期闸门（起点早于保留
	// 截止 → 400）。两者的**真实数值见 GET /api/admin/stats/capabilities**。
	Timezone *StatsTimezone `form:"timezone,omitempty" json:"timezone,omitempty"`
}

type GetUserStatsParamsGranularity string

type GetUserStatsTTFTParams struct {
	From *time.Time `form:"from,omitempty" json:"from,omitempty"`
	To   *time.Time `form:"to,omitempty" json:"to,omitempty"`

	// Window 相对窗口（时长串，Go `time.ParseDuration` 形态，如 `24h`/`168h`/`2160h`）。
	// 给出它时**必须**省略 `from`/`to`（同时给出 → 400 `reason=window_ambiguous`）。
	// 服务端自持时钟：`to` = 当前时刻向上取整到 UTC 整点、`from` = `to` − `window`
	// ⇒ 两端恒整点，命中卷积表的精确分支（零对齐位移、零桶丢失），这就是 UI 预设
	// 走这条形态的理由。
	//
	// **只收时长，不收日历天**：`d` 不是 `time.ParseDuration` 的单位，`7d` → 400
	// （`reason=window_invalid`）。理由：`24h` 与"一个日历天"在 DST 切换日不相等，
	// 而本 API 的唯一对齐基准是固定 1h 网格；另立 `AddDate` 日历语义会引入第二套
	// 窗口长度语义。预设即网格整倍数：24h / 168h / 720h / 2160h。
	Window *StatsWindow `form:"window,omitempty" json:"window,omitempty"`
	Model  *string      `form:"model,omitempty" json:"model,omitempty"`

	// Timezone IANA 时区名（如 Asia/Shanghai / America/New_York；控制台取浏览器时区）。
	// 仅影响**分组读**：时间桶按该时区的本地小时/日界聚合。显式 from/to 恒为
	// 绝对时刻直透，不受时区改写；排行/TTFT 等无分组数值端点接受并校验该参数
	// 但不改变数值。空/缺省 = UTC（兼容旧客户端）；未知名 → 400。overview 的
	// 「今日」日界仍按该时区本地零点计算（窗口是 days，不是 from/to）。
	//
	// 窗口上限**不是一个固定天数**：界不齐时服务端把两端向后取整到整点以换取
	// 卷积表快路径（生效窗口用 X-Stats-Effective-From/To 回显），能否用卷积表
	// 取决于**时区偏移是否恒整点且窗内无 DST 跳变**；DST 或 :30/:45 偏移时区的
	// 分组读只能扫原始明细行。成本上限是保留期无关的纯常量（分组原始行固定
	// 8 天、卷积表 90 天），覆盖上限另有 per-table 保留期闸门（起点早于保留
	// 截止 → 400）。两者的**真实数值见 GET /api/admin/stats/capabilities**。
	Timezone *StatsTimezone `form:"timezone,omitempty" json:"timezone,omitempty"`
}

type GetUserUsageLogsParams struct {
	Limit     *int           `form:"limit,omitempty" json:"limit,omitempty"`
	Cursor    *int64         `form:"cursor,omitempty" json:"cursor,omitempty"`
	GroupId   *int64         `form:"group_id,omitempty" json:"group_id,omitempty"`
	KeyId     *int64         `form:"key_id,omitempty" json:"key_id,omitempty"`
	Model     *string        `form:"model,omitempty" json:"model,omitempty"`
	Format    *RequestFormat `form:"format,omitempty" json:"format,omitempty"`
	ErrorType *string        `form:"error_type,omitempty" json:"error_type,omitempty"`
	From      time.Time      `form:"from" json:"from"`
	To        time.Time      `form:"to" json:"to"`
}

type Group struct {
	CreatedAt *time.Time `json:"CreatedAt,omitempty"`

	// DeletedAt 软删除时间戳；null = 存活（列表/消费路径过滤已删；GET 单个可查已删项）
	DeletedAt *time.Time `json:"DeletedAt"`

	// Description 分组描述（空串 = 无描述）
	Description *string `json:"Description,omitempty"`
	ID          *int64  `json:"ID,omitempty"`
	Name        *string `json:"Name,omitempty"`

	// PriceMultiplier 价格倍率（正常值，1 = ×1，0 = 免费，上限 10 = ×10；API 边界与万分数换算——存储 15000 ↔ 显示 1.5）
	PriceMultiplier *float64 `json:"PriceMultiplier,omitempty"`

	// ProtocolConvert 协议转换方向集合（空数组 = off = 不转换；多方向按客户端格式命中）
	ProtocolConvert *[]GroupProtocolConvert `json:"ProtocolConvert,omitempty"`
	UpdatedAt       *time.Time              `json:"UpdatedAt,omitempty"`
	Visibility      *GroupVisibility        `json:"Visibility,omitempty"`
}

type GroupProtocolConvert string

type GroupVisibility string

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type Key struct {
	CreatedAt *time.Time `json:"CreatedAt,omitempty"`

	// DeletedAt 软删除时间戳；null = 存活（列表/鉴权过滤已删；GET 单个可查已删项）
	DeletedAt *time.Time `json:"DeletedAt"`
	GroupID   *int64     `json:"GroupID,omitempty"`

	// GroupName 归属分组名（只读投影；组非存活/未加载 → 空串，前端回退 `#<GroupID>`）
	GroupName      *string `json:"GroupName,omitempty"`
	ID             *int64  `json:"ID,omitempty"`
	MaxConcurrency *int    `json:"MaxConcurrency,omitempty"`
	Name           *string `json:"Name,omitempty"`

	// Quota 累计最终计费金额上限（毫分，1 USD = 100,000 毫分）；0 = 不限
	Quota *int64 `json:"Quota,omitempty"`

	// QuotaUsed 已消耗计费金额（毫分；后扣；无额度 key 恒 0）
	QuotaUsed *int64     `json:"QuotaUsed,omitempty"`
	Status    *KeyStatus `json:"Status,omitempty"`
	UpdatedAt *time.Time `json:"UpdatedAt,omitempty"`
	UserID    *int64     `json:"UserID,omitempty"`

	// Key key 明文（长期可查看/复制；DB 泄露即暴露——自托管权衡，用户裁决）
	Key *string `json:"key,omitempty"`
}

type KeyCreate struct {
	GroupId int64 `json:"group_id"`

	// MaxConcurrency 单 key 在途上限；0 = 不限
	MaxConcurrency *int   `json:"max_concurrency,omitempty"`
	Name           string `json:"name"`

	// Quota 累计最终计费金额上限（毫分，1 USD = 100,000 毫分）；0 = 不限
	Quota *int64 `json:"quota,omitempty"`
}

type KeyListResponse struct {
	Rows  []Key `json:"rows"`
	Total int64 `json:"total"`
}

type KeyStatus string

type KeyUpdate struct {
	// GroupId 切换归属分组（可选；缺省 = 不改组。可选性同创建——public 或已授予 private；缺失/软删 → 404，未授予 → 400，<=0 → 400）
	GroupId        *int64  `json:"group_id,omitempty"`
	MaxConcurrency *int    `json:"max_concurrency,omitempty"`
	Name           *string `json:"name,omitempty"`

	// Quota 累计最终计费金额上限（毫分，1 USD = 100,000 毫分）；0 = 不限
	Quota  *int64     `json:"quota,omitempty"`
	Status *KeyStatus `json:"status,omitempty"`
}

type ManagementKey struct {
	CreatedAt *time.Time `json:"created_at,omitempty"`
	Id        *int64     `json:"id,omitempty"`

	// KeyRaw 管理 key 明文（前缀 mk-；长期可查看/复制——自托管权衡）
	KeyRaw *string `json:"key_raw,omitempty"`

	// Name 备注/标识（非唯一）
	Name      *string              `json:"name,omitempty"`
	Status    *ManagementKeyStatus `json:"status,omitempty"`
	UpdatedAt *time.Time           `json:"updated_at,omitempty"`

	// UserId owner 用户 id
	UserId *int64 `json:"user_id,omitempty"`
}

type ManagementKeyCreate struct {
	// Name 备注/标识（非唯一，非空）
	Name string `json:"name"`
}

type ManagementKeyListResponse struct {
	Rows []ManagementKey `json:"rows"`
}

type ManagementKeyStatus string

type ManagementKeyUpdate struct {
	Name   *string              `json:"name,omitempty"`
	Status *ManagementKeyStatus `json:"status,omitempty"`
}

type MiddlewareFunc func(http.Handler) http.Handler

type PostUserAuthChangePasswordJSONRequestBody = UserAuthChangePassword

type PostUserAuthForgotPasswordJSONRequestBody = ForgotPasswordRequest

type PostUserAuthLoginJSONRequestBody = UserAuthLogin

type PostUserAuthRegisterCodeJSONRequestBody = RegisterCodeRequest

type PostUserAuthRegisterJSONRequestBody = UserAuthRegister

type PostUserAuthResetPasswordJSONRequestBody = ResetPasswordRequest

type PostUserKeysJSONRequestBody = KeyCreate

type PostUserManagementKeysJSONRequestBody = ManagementKeyCreate

type PostUserRedemptionsJSONRequestBody = RedeemRequest

type PutUserBalanceWarningThresholdJSONRequestBody = BalanceWarningThresholdUpdate

type PutUserKeysIdJSONRequestBody = KeyUpdate

type PutUserManagementKeysIdJSONRequestBody = ManagementKeyUpdate

type RedeemRequest struct {
	Code string `json:"code"`
}

type RedeemResponse struct {
	Applied struct {
		ResourceExpiresAt *time.Time     `json:"resource_expires_at"`
		Type              RedemptionType `json:"type"`

		// Value 兑换时的值快照（同面值单位语义）
		Value float64 `json:"value"`
	} `json:"applied"`
}

type RedemptionRecord struct {
	Code              string         `json:"Code"`
	CodeID            int64          `json:"CodeID"`
	CodeType          RedemptionType `json:"CodeType"`
	CreatedAt         time.Time      `json:"CreatedAt"`
	ID                int64          `json:"ID"`
	Remark            *string        `json:"Remark"`
	ResourceExpiresAt *time.Time     `json:"ResourceExpiresAt"`

	// Value 兑换时的值快照（同面值单位语义）
	Value float64 `json:"Value"`
}

type RedemptionRecordListResponse struct {
	Rows  []RedemptionRecord `json:"rows"`
	Total int64              `json:"total"`
}

type RedemptionType string

type RegisterCodeRequest struct {
	Email string `json:"email"`
}

type RequestFormat string

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type ResetPasswordRequest struct {
	Code        string `json:"code"`
	Email       string `json:"email"`
	NewPassword string `json:"new_password"`
}

type SentResponse struct {
	Sent bool `json:"sent"`
}

type ServerInterface interface {
	// 修改密码（旧密码校验复用登录语义——失败 401 同登录文案防枚举；新密码非空且 ≤72 字节，非法 400；不撤销既有 JWT，新密码下次登录生效）
	// (POST /api/user/auth/change-password)
	PostUserAuthChangePassword(w http.ResponseWriter, r *http.Request)
	// 忘记密码发码（恒 200 {sent:true}，反枚举——无论账号是否存在或邮件是否启用）
	// (POST /api/user/auth/forgot-password)
	PostUserAuthForgotPassword(w http.ResponseWriter, r *http.Request)
	// 登录（bcrypt 校验 → JWT）
	// (POST /api/user/auth/login)
	PostUserAuthLogin(w http.ResponseWriter, r *http.Request)
	// 当前用户信息（JWT）
	// (GET /api/user/auth/me)
	GetUserAuthMe(w http.ResponseWriter, r *http.Request)
	// 注册（signup_enabled 开关检查；注册即登录返回 JWT）
	// (POST /api/user/auth/register)
	PostUserAuthRegister(w http.ResponseWriter, r *http.Request)
	// 发送注册验证码（signup_enabled  gate 403；已注册静默抑制仍 200；限频 429）
	// (POST /api/user/auth/register-code)
	PostUserAuthRegisterCode(w http.ResponseWriter, r *http.Request)
	// 重置密码（验证码校验→更新密码；不撤销既有 JWT）
	// (POST /api/user/auth/reset-password)
	PostUserAuthResetPassword(w http.ResponseWriter, r *http.Request)
	// 获取余额预警阈值（当前用户；0 = 关闭）
	// (GET /api/user/balance-warning-threshold)
	GetUserBalanceWarningThreshold(w http.ResponseWriter, r *http.Request)
	// 设置余额预警阈值（USD；0 = 关闭；负值/非有限/正值舍入为0 拒绝）
	// (PUT /api/user/balance-warning-threshold)
	PutUserBalanceWarningThreshold(w http.ResponseWriter, r *http.Request)
	// 我的错误明细（err_logs 完整错误面：拒绝 + 异常双轨；强制 user_id = 当前用户，防越权）
	// (GET /api/user/err_logs)
	GetUserErrLogs(w http.ResponseWriter, r *http.Request, params GetUserErrLogsParams)
	// 可选组列表（public 全部 + 已授予 private；只读，key 创建时选组）
	// (GET /api/user/groups)
	GetUserGroups(w http.ResponseWriter, r *http.Request)
	// 我的 key 列表（分页/排序；key 明文长期可查看/复制）
	// (GET /api/user/keys)
	GetUserKeys(w http.ResponseWriter, r *http.Request, params GetUserKeysParams)
	// 创建 key（组可选性校验：public 或已授予 private；明文长期回显）
	// (POST /api/user/keys)
	PostUserKeys(w http.ResponseWriter, r *http.Request)
	// 删除 key（仅本人；Auth 快照增量移除——立即失效）
	// (DELETE /api/user/keys/{id})
	DeleteUserKeysId(w http.ResponseWriter, r *http.Request, id int64)
	// key 详情（仅本人；他人 key → 404）
	// (GET /api/user/keys/{id})
	GetUserKeysId(w http.ResponseWriter, r *http.Request, id int64)
	// 更新 key（name/status/max_concurrency/quota；仅本人）
	// (PUT /api/user/keys/{id})
	PutUserKeysId(w http.ResponseWriter, r *http.Request, id int64)
	// 轮换 key（仅本人；新明文生效，旧 key 立即失效）
	// (POST /api/user/keys/{id}/rotate)
	PostUserKeysIdRotate(w http.ResponseWriter, r *http.Request, id int64)
	// 我的管理 key 列表（软删过滤；含明文 mk-，与客户端 key 一致）
	// (GET /api/user/management-keys)
	GetUserManagementKeys(w http.ResponseWriter, r *http.Request)
	// 创建管理 key（以自身身份鉴权管理面；返回明文 mk-）
	// (POST /api/user/management-keys)
	PostUserManagementKeys(w http.ResponseWriter, r *http.Request)
	// 删除管理 key（仅本人；软删 + 本实例快照即时移除）
	// (DELETE /api/user/management-keys/{id})
	DeleteUserManagementKeysId(w http.ResponseWriter, r *http.Request, id int64)
	// 更新管理 key（name/status；仅本人；disabled 即时 401 可再启用）
	// (PUT /api/user/management-keys/{id})
	PutUserManagementKeysId(w http.ResponseWriter, r *http.Request, id int64)
	// 我的兑换记录（use 快照 + 码的 type/remark 联查；强制 user_id = 当前用户，防越权）
	// (GET /api/user/redemptions)
	GetUserRedemptions(w http.ResponseWriter, r *http.Request, params GetUserRedemptionsParams)
	// 兑换码（400 invalid code：不存在/失效/过期/用尽，统一不泄露细节；409 already redeemed 重复兑换）
	// (POST /api/user/redemptions)
	PostUserRedemptions(w http.ResponseWriter, r *http.Request)
	// 我的用量统计（强制 user_id = 当前用户）
	// (GET /api/user/stats)
	GetUserStats(w http.ResponseWriter, r *http.Request, params GetUserStatsParams)
	// 统计能力（本部署能查多久——与 /api/admin/stats/capabilities 同一投影）
	// (GET /api/user/stats/capabilities)
	GetUserStatsCapabilities(w http.ResponseWriter, r *http.Request)
	// 我的 TTFT 聚合（强制 user_id = 当前用户）
	// (GET /api/user/stats/ttft)
	GetUserStatsTTFT(w http.ResponseWriter, r *http.Request, params GetUserStatsTTFTParams)
	// 我的临时额度（仅有效额度：未过期且正余额，用尽/过期隐藏；expires_at 升序 FEFO 同序、永久最后；强制 user_id = 当前用户，无 user_id 参数防越权）
	// (GET /api/user/temp-balances)
	GetUserTempBalances(w http.ResponseWriter, r *http.Request)
	// 我的用量明细（usage_logs 纯计费明细；强制 user_id = 当前用户，防越权；error_type 值域 none/abort）
	// (GET /api/user/usage_logs)
	GetUserUsageLogs(w http.ResponseWriter, r *http.Request, params GetUserUsageLogsParams)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandlerFunc   func(w http.ResponseWriter, r *http.Request, err error)
}

type StatTTFTSummary struct {
	AvgMS  float64               `json:"AvgMS"`
	Count  int64                 `json:"Count"`
	MaxMS  int64                 `json:"MaxMS"`
	P50MS  int64                 `json:"P50MS"`
	P95MS  int64                 `json:"P95MS"`
	P99MS  int64                 `json:"P99MS"`
	Source StatTTFTSummarySource `json:"Source"`
}

type StatTTFTSummarySource string

type StatTrendPoint struct {
	BucketTime          *time.Time `json:"BucketTime,omitempty"`
	CacheCreationTokens *int64     `json:"CacheCreationTokens,omitempty"`
	CacheReadTokens     *int64     `json:"CacheReadTokens,omitempty"`
	CallCount           *int64     `json:"CallCount,omitempty"`

	// Cost 成本 USD（毫分 /1e5）
	Cost         *float64 `json:"Cost,omitempty"`
	ErrorCount   *int64   `json:"ErrorCount,omitempty"`
	InputTokens  *int64   `json:"InputTokens,omitempty"`
	OutputTokens *int64   `json:"OutputTokens,omitempty"`

	// RawCost 原始成本 USD（毫分 /1e5）
	RawCost      *float64 `json:"RawCost,omitempty"`
	RequestCount *int64   `json:"RequestCount,omitempty"`

	// TTFTAvgMS TTFT 平均毫秒（TTFTTotalMS/TTFTCount，无样本 0）
	TTFTAvgMS *float64 `json:"TTFTAvgMS,omitempty"`

	// TTFTMaxMS TTFT 最大毫秒
	TTFTMaxMS   *int64 `json:"TTFTMaxMS,omitempty"`
	TotalTokens *int64 `json:"TotalTokens,omitempty"`
}

type StatsCapabilities struct {
	// BucketGridSeconds 卷积表桶网格单位（秒；恒 3600 = 1 小时）
	BucketGridSeconds int `json:"bucket_grid_seconds"`

	// Kinds 键 = 读形状标识（trend/entity_trend/summary/days/top/ttft_sketch/ttft_exact/usage_agg/usage_list/errlog_list）
	Kinds map[string]StatsKindCapability `json:"kinds"`
}

type StatsKindCapability struct {
	// CostCapSeconds 每候选存储的最大跨度秒数（保留期无关的纯常量；0 = 无上限）
	CostCapSeconds map[string]int64 `json:"cost_cap_seconds"`

	// CoverageDays 每候选存储实际读表的保留天数（读多表取最保守者；0 = 该表未启用分区保留，覆盖守卫关闭）
	CoverageDays map[string]int `json:"coverage_days"`

	// Grouping 读形状的分组模式：`zoned` = 按请求时区分组（桶界随时区变）；`none` =
	// 数值与请求时区无关。刻意不写 enum：enum 会为一个取值是 `none` 的字段
	// 生成名为 `None` 的常量，与既有 `ErrorType` 枚举的 `None` 撞名，触发
	// oapi-codegen 把该枚举九个常量全部改名（无关生成的额外改动）。
	Grouping string `json:"grouping"`

	// Storages 候选存储（按偏好序）
	Storages []StatsKindCapabilityStorages `json:"storages"`
}

type StatsKindCapabilityStorages string

type StatsTimezone = string

type StatsWindow = string

type TempBalanceRow struct {
	// AmountUsd 金额 USD（毫分 /1e5；1 USD = 100,000 毫分）
	AmountUsd float64 `json:"amount_usd"`

	// ExpiresAt 到期时间；null = 永久额度
	ExpiresAt *time.Time `json:"expires_at"`
	Id        int64      `json:"id"`

	// Note 固定系统备注（signup bonus / redemption code），无敏感信息
	Note *string `json:"note"`
}

type TempBalancesResponse struct {
	Rows []TempBalanceRow `json:"rows"`

	// TotalUsd 有效额度合计 USD（毫分 Σ /1e5；0 = 无有效额度）
	TotalUsd float64 `json:"total_usd"`
}

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type Unimplemented struct{}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

type User struct {
	// Balance 余额 USD（浮点；内部存储毫分——1 USD = 100,000 毫分，API 边界换算）
	Balance        *float64    `json:"Balance,omitempty"`
	CreatedAt      *time.Time  `json:"CreatedAt,omitempty"`
	Email          *string     `json:"Email,omitempty"`
	ID             *int64      `json:"ID,omitempty"`
	MaxConcurrency *int        `json:"MaxConcurrency,omitempty"`
	Role           *UserRole   `json:"Role,omitempty"`
	Status         *UserStatus `json:"Status,omitempty"`
	UpdatedAt      *time.Time  `json:"UpdatedAt,omitempty"`
}

type UserAPI struct {
	// contains filtered or unexported fields
}

type UserAuthChangePassword struct {
	// NewPassword 非空且 ≤72 字节（bcrypt 截断限制），非法 400
	NewPassword string `json:"new_password"`
	OldPassword string `json:"old_password"`
}

type UserAuthLogin struct {
	Email    string `json:"email"`
	Password string `json:"password"`
}

type UserAuthRegister struct {
	// Code 可选：邮箱验证码（mail.register_verification 开启时必填，否则 400 email verification required）
	Code     *string `json:"code,omitempty"`
	Email    string  `json:"email"`
	Password string  `json:"password"`
}

type UserAuthResponse struct {
	Token string `json:"token"`
	User  User   `json:"user"`
}

type UserErrLog struct {
	// BillingTier 计费档位（service_tier 归一化：priority/flex/fast/auto）；null = 未计费路径
	BillingTier *string `json:"BillingTier"`

	// ClientIP 客户端 IP（CF-Connecting-IP / True-Client-IP / X-Real-IP 按序识别；无则 RemoteAddr 剥端口）；空 = 无
	ClientIP  *string    `json:"ClientIP,omitempty"`
	CreatedAt *time.Time `json:"CreatedAt,omitempty"`

	// ErrorMessage 错误文本（拒绝文案/上游 body，域内截断 500 字符）；null = 无错误文本
	ErrorMessage *string        `json:"ErrorMessage"`
	ErrorType    *ErrorType     `json:"ErrorType,omitempty"`
	Format       *RequestFormat `json:"Format,omitempty"`
	GroupID      *int64         `json:"GroupID,omitempty"`
	ID           *int64         `json:"ID,omitempty"`

	// KeyID 鉴权归属 key；0 = 无
	KeyID     *int64  `json:"KeyID,omitempty"`
	LatencyMS *int64  `json:"LatencyMS,omitempty"`
	Model     *string `json:"Model,omitempty"`
	RequestID *string `json:"RequestID,omitempty"`

	// StatusCode 错误状态码（完整错误面；0 = 连接级）
	StatusCode *int `json:"StatusCode,omitempty"`

	// UserID 鉴权归属用户；0 = 无
	UserID *int64 `json:"UserID,omitempty"`
}

type UserErrLogsResponse struct {
	// NextCursor 下一页游标（本页最后一条 id）；null = 无更多行
	NextCursor *int64       `json:"next_cursor"`
	Rows       []UserErrLog `json:"rows"`
}

type UserLogsResponse struct {
	// NextCursor 下一页游标（本页最后一条 id）；null = 无更多行
	NextCursor *int64         `json:"next_cursor"`
	Rows       []UserUsageLog `json:"rows"`
}

type UserRole string

type UserStatus string

type UserUsageLog struct {
	// AboveHit 任一分量超 above 阈值命中分段
	AboveHit *bool `json:"AboveHit,omitempty"`

	// BillingTier 请求 service_tier 归一化值（priority/flex/fast/auto）；空 = 未计费路径
	BillingTier         *string `json:"BillingTier,omitempty"`
	CacheCreationTokens *int64  `json:"CacheCreationTokens,omitempty"`
	CacheReadTokens     *int64  `json:"CacheReadTokens,omitempty"`

	// ClientIP 客户端 IP（CF-Connecting-IP / True-Client-IP / X-Real-IP 按序识别；无则 RemoteAddr 剥端口）；空 = 无
	ClientIP *string `json:"ClientIP,omitempty"`

	// Cost 计费成本（毫分，1 USD = 100,000 毫分）；错误请求（402/4xx）为 0
	Cost        *int64         `json:"Cost,omitempty"`
	CreatedAt   *time.Time     `json:"CreatedAt,omitempty"`
	ErrorType   *ErrorType     `json:"ErrorType,omitempty"`
	Format      *RequestFormat `json:"Format,omitempty"`
	GroupID     *int64         `json:"GroupID,omitempty"`
	ID          *int64         `json:"ID,omitempty"`
	InputTokens *int64         `json:"InputTokens,omitempty"`

	// KeyID 鉴权归属 key；0 = 无
	KeyID        *int64  `json:"KeyID,omitempty"`
	LatencyMS    *int64  `json:"LatencyMS,omitempty"`
	MappedModel  *string `json:"MappedModel"`
	Model        *string `json:"Model,omitempty"`
	OutputTokens *int64  `json:"OutputTokens,omitempty"`

	// Overdraft 本次扣费透支（余额不足扣为负余额）
	Overdraft *bool `json:"Overdraft,omitempty"`

	// PriceCacheCreationMillis 缓存写单价快照（每 M token 毫分）；null = 该请求无缓存写或无缓存价
	PriceCacheCreationMillis *int64 `json:"PriceCacheCreationMillis"`

	// PriceCacheReadMillis 缓存读单价快照（每 M token 毫分）；null = 该请求无缓存读或无缓存价
	PriceCacheReadMillis *int64 `json:"PriceCacheReadMillis"`

	// PriceInputMillis 输入单价快照（每 M token 毫分，1 USD = 100,000 毫分；pricing 同款单位）；null = 未计费路径
	PriceInputMillis *int64 `json:"PriceInputMillis"`

	// PriceOutputMillis 输出单价快照（每 M token 毫分）；null = 未计费路径
	PriceOutputMillis *int64 `json:"PriceOutputMillis"`

	// RawCost 原始成本（毫分，乘倍率前——免费组 cost=0 但 raw 有值，实际消耗口径）；bill 未装配/无价防御路径恒 0
	RawCost   *int64  `json:"RawCost,omitempty"`
	RequestID *string `json:"RequestID,omitempty"`

	// TTFTMS 首 token 时间毫秒（流式首 chunk 采集）；非流式/失败/无首 token 路径 = null
	TTFTMS      *int64 `json:"TTFTMS"`
	TotalTokens *int64 `json:"TotalTokens,omitempty"`

	// UserID 鉴权归属用户；0 = 无
	UserID *int64 `json:"UserID,omitempty"`
}