handler

type Account struct {
	// BaseURL 账号级覆盖：非空优先于模板 base_url；null = 继承模板
	BaseURL       *string    `json:"BaseURL"`
	CooldownUntil *time.Time `json:"CooldownUntil"`
	CreatedAt     *time.Time `json:"CreatedAt,omitempty"`

	// DeletedAt 软删除时间戳；null = 存活（列表过滤已删；GET 单个可查已删项）
	DeletedAt      *time.Time     `json:"DeletedAt"`
	ID             *int64         `json:"ID,omitempty"`
	LastError      *string        `json:"LastError"`
	LastUsedAt     *time.Time     `json:"LastUsedAt"`
	MaxConcurrency *int           `json:"MaxConcurrency,omitempty"`
	Name           *string        `json:"Name,omitempty"`
	Status         *AccountStatus `json:"Status,omitempty"`
	Template       *Template      `json:"Template,omitempty"`
	TemplateID     *int64         `json:"TemplateID,omitempty"`
	UpdatedAt      *time.Time     `json:"UpdatedAt,omitempty"`
	UpstreamKey    *string        `json:"UpstreamKey,omitempty"`
	Weight         *int           `json:"Weight,omitempty"`
}

type AccountCreate struct {
	// BaseUrl 账号级覆盖（可选）：非空优先于模板 base_url；null = 继承模板
	BaseUrl        *string        `json:"base_url"`
	GroupIds       *[]int64       `json:"group_ids,omitempty"`
	MaxConcurrency *int           `json:"max_concurrency,omitempty"`
	Name           string         `json:"name"`
	Status         *AccountStatus `json:"status,omitempty"`
	TemplateId     int64          `json:"template_id"`
	UpstreamKey    string         `json:"upstream_key"`
	Weight         *int           `json:"weight,omitempty"`
}

type AccountExt struct {
	AccountId *int64 `json:"account_id,omitempty"`

	// CodexAccountId 上游账号/空间标识（Task B 导入必填；本 task 仅声明）
	CodexAccountId *string `json:"codex_account_id"`

	// CodexEmail 管理标识：codex 账号登录邮箱（导入时由人工/上游提供，非自动生成——NewCodexIdentity 只生成身份四元组；可空）
	CodexEmail *string `json:"codex_email"`

	// CodexIdentity codex 账号身份四元组（account_ext.codex_identity jsonb 契约形态；对象字段请求语义：null 与空串同 = 未提供）
	CodexIdentity *CodexIdentity `json:"codex_identity,omitempty"`

	// CodexOauthExpiresAt 凭据：oauth 访问令牌过期时间
	CodexOauthExpiresAt *time.Time `json:"codex_oauth_expires_at"`

	// CodexOauthRefreshToken 凭据：oauth 刷新令牌
	CodexOauthRefreshToken *string `json:"codex_oauth_refresh_token"`

	// CodexOauthToken 凭据：oauth 访问令牌（oauth 行必填——最小完整性）
	CodexOauthToken *string `json:"codex_oauth_token"`

	// CodexPatKey 凭据：pat
	CodexPatKey *string `json:"codex_pat_key"`

	// CredentialType 类型-列组约束（service 校验）：oauth 只允许 codex_oauth_* 列组；pat 只允许 codex_pat_key
	CredentialType AccountExtCredentialType `json:"credential_type"`
}

type AccountExtCredentialType string

type AccountGroupsResponse struct {
	GroupIds []int64 `json:"group_ids"`
}

type AccountListResponse struct {
	Rows  []AccountView `json:"rows"`
	Total int64         `json:"total"`
}

type AccountPatch struct {
	// BaseUrl 批量三态：空串 = 清空（回继承模板）；null/缺省 = 不变；非空 = 落值
	BaseUrl        *string             `json:"base_url"`
	GroupIds       *[]int64            `json:"group_ids,omitempty"`
	MaxConcurrency *int                `json:"max_concurrency,omitempty"`
	Name           *string             `json:"name,omitempty"`
	Status         *AccountPatchStatus `json:"status,omitempty"`
	TemplateId     *int64              `json:"template_id,omitempty"`
	UpstreamKey    *string             `json:"upstream_key,omitempty"`
	Weight         *int                `json:"weight,omitempty"`
}

type AccountPatchStatus string

type AccountStatus string

type AccountUsageItem struct {
	AccountId int64 `json:"account_id"`

	// Gateway 账号网关计费聚合（usage_logs 实时明细；毫分 /1e5 → USD；无记录账号全 0）
	Gateway  UsageGatewayStats   `json:"gateway"`
	Upstream *CodexUsageSnapshot `json:"upstream"`

	// UpstreamError 上游快照失败分类（null = 无上游能力/快照成功；auth_expired = 凭据失效（fatal 类）；upstream_unavailable = 网络/5xx 等上游错误）
	UpstreamError *AccountUsageItemUpstreamError `json:"upstream_error"`
}

type AccountUsageItemUpstreamError string

type AccountView struct {
	// BaseURL 账号级覆盖：非空优先于模板 base_url；null = 继承模板
	BaseURL       *string    `json:"BaseURL"`
	CooldownUntil *time.Time `json:"CooldownUntil"`
	CreatedAt     *time.Time `json:"CreatedAt,omitempty"`

	// DeletedAt 软删除时间戳；null = 存活（列表过滤已删；GET 单个可查已删项）
	DeletedAt      *time.Time     `json:"DeletedAt"`
	ID             *int64         `json:"ID,omitempty"`
	LastError      *string        `json:"LastError"`
	LastUsedAt     *time.Time     `json:"LastUsedAt"`
	MaxConcurrency *int           `json:"MaxConcurrency,omitempty"`
	Name           *string        `json:"Name,omitempty"`
	Status         *AccountStatus `json:"Status,omitempty"`
	Template       *Template      `json:"Template,omitempty"`
	TemplateID     *int64         `json:"TemplateID,omitempty"`
	UpdatedAt      *time.Time     `json:"UpdatedAt,omitempty"`
	UpstreamKey    *string        `json:"UpstreamKey,omitempty"`
	Weight         *int           `json:"Weight,omitempty"`
	Concurrency    *int64         `json:"concurrency,omitempty"`
	ErrCount       *int           `json:"err_count,omitempty"`
	ErrRate        *float64       `json:"err_rate,omitempty"`
}

type AccountsUsageResponse struct {
	Items []AccountUsageItem `json:"items"`
}

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

type AdminKey struct {
	CreatedAt      *time.Time `json:"CreatedAt,omitempty"`
	DeletedAt      *time.Time `json:"DeletedAt"`
	GroupID        *int64     `json:"GroupID,omitempty"`
	ID             *int64     `json:"ID,omitempty"`
	MaxConcurrency *int       `json:"MaxConcurrency,omitempty"`
	Name           *string    `json:"Name,omitempty"`
	Quota          *int64     `json:"Quota,omitempty"`
	QuotaUsed      *int64     `json:"QuotaUsed,omitempty"`
	Status         *KeyStatus `json:"Status,omitempty"`
	UpdatedAt      *time.Time `json:"UpdatedAt,omitempty"`
	UserID         *int64     `json:"UserID,omitempty"`
}

type AdminKeyListResponse struct {
	Rows  []AdminKey `json:"rows"`
	Total int64      `json:"total"`
}

type AdminTempBalanceRow struct {
	// AmountUsd 金额 USD（毫分 /1e5；1 USD = 100,000 毫分）
	AmountUsd float64   `json:"amount_usd"`
	CreatedAt time.Time `json:"created_at"`

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

type AdminTempBalancesResponse struct {
	Rows  []AdminTempBalanceRow `json:"rows"`
	Total int64                 `json:"total"`
}

type BatchDeactivateRequest struct {
	Ids []int64 `json:"ids"`
}

type BatchDeactivateResponse struct {
	// Deactivated 新失效数（已 disabled no-op 不计）
	Deactivated int `json:"deactivated"`
}

type BatchDeleteBody struct {
	Ids []int64 `json:"ids"`
}

type BatchDeleteResponse struct {
	Deleted int `json:"deleted"`
}

type BatchResetCooldownBody struct {
	Ids []int64 `json:"ids"`
}

type BatchResetCooldownResponse struct {
	Reset int `json:"reset"`
}

type BatchUpdateAccountsBody struct {
	Fields AccountPatch `json:"fields"`
	Ids    []int64      `json:"ids"`
}

type BatchUpdateGroupsBody struct {
	Fields GroupPatch `json:"fields"`
	Ids    []int64    `json:"ids"`
}

type BatchUpdateResponse struct {
	Updated int `json:"updated"`
}

type BatchUpdateTemplatesBody struct {
	Fields TemplatePatch `json:"fields"`
	Ids    []int64       `json:"ids"`
}

type BillingAlerts struct {
	LagMs           int64
	UnbilledRows    int64
	QuarantinedRows int64
}

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

type CodexCredits struct {
	Balance *string `json:"balance"`
}

type CodexIdentity struct {
	// InstallationId 身份：账号级唯一（UUIDv4；响应恒有——首次写入自动生成；空/缺省 → service 自动生成）
	InstallationId *string `json:"installation_id,omitempty"`

	// SessionId 身份：会话级（UUIDv7；恒等 == thread_id；service 自动生成/沿用；响应 nil → null）
	SessionId *string `json:"session_id"`

	// ThreadId 身份：会话级（UUIDv7；恒等 == session_id；响应 nil → null）
	ThreadId *string `json:"thread_id"`

	// WindowId 身份：会话级派生 {thread_id}:0（导入时生成后恒定不变——恒 0，无透传无解析；上游不校验 n；响应 nil → null）
	WindowId *string `json:"window_id"`
}

type CodexOAuthImportBody struct {
	// GroupId 可选：新建账号归组（缺省不归组；不存在 → 行级 failed——FK 违反归行级不整批 400）
	GroupId *int64                 `json:"group_id"`
	Items   []CodexOAuthImportItem `json:"items"`

	// TemplateId 必填：codex 账号归属模板（credential_type 必须 == 端点类型 codex-oauth）
	TemplateId int64 `json:"template_id"`
}

type CodexOAuthImportItem struct {
	// CodexAccountId 组合幂等键②：上游账号/空间标识（必填）
	CodexAccountId string `json:"codex_account_id"`

	// CodexEmail 组合幂等键①：codex 账号登录邮箱（必填；格式非法 → 行级 failed）
	CodexEmail string `json:"codex_email"`

	// CodexOauthExpiresAt 凭据：oauth 访问令牌过期时间（可选；RFC3339 格式——解析失败 → 行级 failed）
	CodexOauthExpiresAt *string `json:"codex_oauth_expires_at,omitempty"`

	// CodexOauthRefreshToken 凭据：oauth 刷新令牌（必填；与 token 成对）
	CodexOauthRefreshToken string `json:"codex_oauth_refresh_token"`

	// CodexOauthToken 凭据：oauth 访问令牌（必填；与 refresh 成对）
	CodexOauthToken string `json:"codex_oauth_token"`

	// MaxConcurrency 可选；缺省 25（导入面裁决——非账号表默认 8）；<1 → 归 25
	MaxConcurrency *int `json:"max_concurrency,omitempty"`

	// Weight 可选；缺省 100；负值 → 行级 failed
	Weight *int `json:"weight,omitempty"`
}

type CodexPATImportBody struct {
	// GroupId 可选：新建账号归组（不存在 → 行级 failed）
	GroupId *int64               `json:"group_id"`
	Items   []CodexPATImportItem `json:"items"`

	// TemplateId 必填：codex 账号归属模板（credential_type 必须 == 端点类型 codex-pat）
	TemplateId int64 `json:"template_id"`
}

type CodexPATImportItem struct {
	// CodexAccountId 组合幂等键②：上游账号/空间标识（必填）
	CodexAccountId string `json:"codex_account_id"`

	// CodexEmail 组合幂等键①：codex 账号登录邮箱（必填；格式非法 → 行级 failed）
	CodexEmail string `json:"codex_email"`

	// CodexPatKey 凭据：pat（必填非空）
	CodexPatKey string `json:"codex_pat_key"`

	// MaxConcurrency 可选；缺省 25（导入面裁决）；<1 → 归 25
	MaxConcurrency *int `json:"max_concurrency,omitempty"`

	// Weight 可选；缺省 100；负值 → 行级 failed
	Weight *int `json:"weight,omitempty"`
}

type CodexRateLimit struct {
	ResetAt     *time.Time `json:"reset_at"`
	UsedPercent int        `json:"used_percent"`
}

type CodexSpendControl struct {
	Limit            string `json:"limit"`
	Remaining        string `json:"remaining"`
	RemainingPercent int    `json:"remaining_percent"`
	Used             string `json:"used"`
	UsedPercent      int    `json:"used_percent"`
}

type CodexUsageSnapshot struct {
	// Credits 充值余额（金额字符串，如 "12.50"；上游空串 → null，非空串占位）
	Credits  *CodexCredits `json:"credits,omitempty"`
	PlanType *string       `json:"plan_type,omitempty"`

	// RateLimit 主窗口用量（reset_at RFC3339——上游主窗口省略时 null，非虚假 0001-01-01）
	RateLimit *CodexRateLimit `json:"rate_limit,omitempty"`

	// SpendControl 消费控制额度（金额字符串）
	SpendControl *CodexSpendControl `json:"spend_control,omitempty"`
}

type CreateRuleJSONRequestBody = RuleCreate

type DeactivateRequest = map[string]interface{}

type DeactivateResponse struct {
	Deactivated bool `json:"deactivated"`
}

type DeletePriceEntryParams struct {
	Model string `form:"model" json:"model"`
}

type DeletePriceVariantsParams struct {
	Model string `form:"model" json:"model"`
}

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

type ErrLog struct {
	AccountID *int64 `json:"AccountID,omitempty"`

	// 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"`
	TemplateID *int64 `json:"TemplateID,omitempty"`

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

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

type Error = ErrorResponse

type ErrorResponse struct {
	Error string `json:"error"`
}

type ErrorType string

type GenerateRequest struct {
	// Count 生成个数 1-1000（缺省 1）
	Count *int `json:"count,omitempty"`

	// ExpiresAt 码未兑换即过期；缺省 = 永久
	ExpiresAt *time.Time `json:"expires_at,omitempty"`

	// MaxUses 1 = 单次码（缺省）；>1 = 多人码
	MaxUses *int    `json:"max_uses,omitempty"`
	Remark  *string `json:"remark,omitempty"`

	// ResourceExpiresAt 兑换后资源到期；temp_balance 必填（决策 4）
	ResourceExpiresAt *time.Time     `json:"resource_expires_at,omitempty"`
	Type              RedemptionType `json:"type"`

	// Value 面值：balance/temp_balance = USD；concurrency = 并发数（整数）。> 0
	Value float64 `json:"value"`
}

type GenerateResponse struct {
	Codes []RedemptionCode `json:"codes"`
}

type GetAccountsParams 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      *GetAccountsParamsOrder `form:"order,omitempty" json:"order,omitempty"`
	Status     *string                 `form:"status,omitempty" json:"status,omitempty"`
	TemplateId *int64                  `form:"template_id,omitempty" json:"template_id,omitempty"`
}

type GetAccountsParamsOrder string

type GetAccountsUsageParams struct {
	AccountIds string     `form:"account_ids" json:"account_ids"`
	From       *time.Time `form:"from,omitempty" json:"from,omitempty"`
	To         *time.Time `form:"to,omitempty" json:"to,omitempty"`
}

type GetAdminOverviewParams struct {
	Days    *int   `form:"days,omitempty" json:"days,omitempty"`
	GroupId *int64 `form:"group_id,omitempty" json:"group_id,omitempty"`
}

type GetAdminUsersTopParams struct {
	Top *int `form:"top,omitempty" json:"top,omitempty"`
}

type GetErrLogsParams 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"`
	AccountId  *int64         `form:"account_id,omitempty" json:"account_id,omitempty"`
	UserId     *int64         `form:"user_id,omitempty" json:"user_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 GetGroupsParams 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  *GetGroupsParamsOrder `form:"order,omitempty" json:"order,omitempty"`
}

type GetGroupsParamsOrder string

type GetKeysParams struct {
	Name    *string             `form:"name,omitempty" json:"name,omitempty"`
	UserId  *int64              `form:"user_id,omitempty" json:"user_id,omitempty"`
	GroupId *int64              `form:"group_id,omitempty" json:"group_id,omitempty"`
	Limit   *int                `form:"limit,omitempty" json:"limit,omitempty"`
	Offset  *int                `form:"offset,omitempty" json:"offset,omitempty"`
	Sort    *string             `form:"sort,omitempty" json:"sort,omitempty"`
	Order   *GetKeysParamsOrder `form:"order,omitempty" json:"order,omitempty"`
}

type GetKeysParamsOrder string

type GetPriceEntryParams struct {
	Model string `form:"model" json:"model"`
}

type GetPriceVariantsParams struct {
	Model string `form:"model" json:"model"`
}

type GetPricesParams struct {
	Page     *int                   `form:"page,omitempty" json:"page,omitempty"`
	PageSize *int                   `form:"page_size,omitempty" json:"page_size,omitempty"`
	Mode     *GetPricesParamsMode   `form:"mode,omitempty" json:"mode,omitempty"`
	Source   *GetPricesParamsSource `form:"source,omitempty" json:"source,omitempty"`
	Provider *string                `form:"provider,omitempty" json:"provider,omitempty"`
	Model    *string                `form:"model,omitempty" json:"model,omitempty"`
	Sort     *string                `form:"sort,omitempty" json:"sort,omitempty"`
	Order    *GetPricesParamsOrder  `form:"order,omitempty" json:"order,omitempty"`
}

type GetPricesParamsMode string

type GetPricesParamsOrder string

type GetPricesParamsSource string

type GetRedemptionCodesIdUsesParams struct {
	Limit  *int `form:"limit,omitempty" json:"limit,omitempty"`
	Offset *int `form:"offset,omitempty" json:"offset,omitempty"`
}

type GetRedemptionCodesParams struct {
	Page     *int                            `form:"page,omitempty" json:"page,omitempty"`
	PageSize *int                            `form:"page_size,omitempty" json:"page_size,omitempty"`
	Type     *GetRedemptionCodesParamsType   `form:"type,omitempty" json:"type,omitempty"`
	Status   *GetRedemptionCodesParamsStatus `form:"status,omitempty" json:"status,omitempty"`
	Sort     *string                         `form:"sort,omitempty" json:"sort,omitempty"`
	Order    *GetRedemptionCodesParamsOrder  `form:"order,omitempty" json:"order,omitempty"`
}

type GetRedemptionCodesParamsOrder string

type GetRedemptionCodesParamsStatus string

type GetRedemptionCodesParamsType string

type GetStatsEntityTrendParams struct {
	Entity      GetStatsEntityTrendParamsEntity      `form:"entity" json:"entity"`
	Id          int64                                `form:"id" json:"id"`
	From        time.Time                            `form:"from" json:"from"`
	To          time.Time                            `form:"to" json:"to"`
	Granularity GetStatsEntityTrendParamsGranularity `form:"granularity" json:"granularity"`
	Model       *string                              `form:"model,omitempty" json:"model,omitempty"`
}

type GetStatsEntityTrendParamsEntity string

type GetStatsEntityTrendParamsGranularity string

type GetStatsTTFTParams struct {
	From   time.Time                 `form:"from" json:"from"`
	To     time.Time                 `form:"to" json:"to"`
	Entity *GetStatsTTFTParamsEntity `form:"entity,omitempty" json:"entity,omitempty"`
	Id     *int64                    `form:"id,omitempty" json:"id,omitempty"`
	Model  *string                   `form:"model,omitempty" json:"model,omitempty"`
}

type GetStatsTTFTParamsEntity string

type GetStatsTopParams struct {
	From   time.Time               `form:"from" json:"from"`
	To     time.Time               `form:"to" json:"to"`
	Entity GetStatsTopParamsEntity `form:"entity" json:"entity"`
	By     GetStatsTopParamsBy     `form:"by" json:"by"`
	Limit  *int                    `form:"limit,omitempty" json:"limit,omitempty"`
}

type GetStatsTopParamsBy string

type GetStatsTopParamsEntity string

type GetStatsTrendParams struct {
	From        time.Time                       `form:"from" json:"from"`
	To          time.Time                       `form:"to" json:"to"`
	Granularity *GetStatsTrendParamsGranularity `form:"granularity,omitempty" json:"granularity,omitempty"`
	GroupId     *int64                          `form:"group_id,omitempty" json:"group_id,omitempty"`
	Model       *string                         `form:"model,omitempty" json:"model,omitempty"`
}

type GetStatsTrendParamsGranularity string

type GetTempBalancesParams struct {
	Page     *int                        `form:"page,omitempty" json:"page,omitempty"`
	PageSize *int                        `form:"page_size,omitempty" json:"page_size,omitempty"`
	UserId   *int64                      `form:"user_id,omitempty" json:"user_id,omitempty"`
	Sort     *string                     `form:"sort,omitempty" json:"sort,omitempty"`
	Order    *GetTempBalancesParamsOrder `form:"order,omitempty" json:"order,omitempty"`
}

type GetTempBalancesParamsOrder string

type GetTemplatesParams 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  *GetTemplatesParamsOrder `form:"order,omitempty" json:"order,omitempty"`
}

type GetTemplatesParamsOrder string

type GetUsageLogsParams 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"`
	AccountId *int64         `form:"account_id,omitempty" json:"account_id,omitempty"`
	UserId    *int64         `form:"user_id,omitempty" json:"user_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 GetUsersParams struct {
	Limit  *int                 `form:"limit,omitempty" json:"limit,omitempty"`
	Offset *int                 `form:"offset,omitempty" json:"offset,omitempty"`
	Email  *string              `form:"email,omitempty" json:"email,omitempty"`
	Sort   *string              `form:"sort,omitempty" json:"sort,omitempty"`
	Order  *GetUsersParamsOrder `form:"order,omitempty" json:"order,omitempty"`
}

type GetUsersParamsOrder string

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

	// DeletedAt 软删除时间戳；null = 存活（列表/消费路径过滤已删；GET 单个可查已删项）
	DeletedAt *time.Time `json:"DeletedAt"`
	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 GroupAssignmentsBody struct {
	// Multipliers 可选：user_id → 该用户在该组的专属价格倍率（正常值，1 = ×1，0 = 免费，上限 10 = ×10；API 边界与万分数换算）。仅对 user_ids 中列出的用户生效；null = 清除为未设置（回退组倍率）；未列出的用户沿用当前值
	Multipliers *map[string]*float64 `json:"multipliers,omitempty"`

	// UserIds 替换语义：完整授予列表（未列出即撤销；空数组 = 清空）
	UserIds []int64 `json:"user_ids"`
}

type GroupAssignmentsResponse struct {
	// Multipliers 该组当前各用户的专属价格倍率（正常值；null/缺省 = 未设置 → 用组倍率）
	Multipliers *map[string]*float64 `json:"multipliers,omitempty"`
	UserIds     []int64              `json:"user_ids"`
}

type GroupCreate struct {
	Name string `json:"name"`

	// PriceMultiplier 价格倍率（正常值，1 = ×1，0 = 免费，上限 10 = ×10；API 边界与万分数换算——存储 15000 ↔ 显示 1.5）。缺省/null = 不设置（×1）；显式 0 = 免费组；PUT 显式写（含 0）
	PriceMultiplier *float64 `json:"price_multiplier"`

	// ProtocolConvert 协议转换方向集合（多方向并存，按客户端格式命中——chat 请求走 chat_to_*、anthropic 请求走 mess_to_resp、resp 请求走 resp_to_mess）。空数组/缺省 = off = 不转换；同客户端格式多方向（chat_to_resp 与 chat_to_mess 并存）→ 400。PUT 语义：缺省（null/省略）= 保持原值；显式空数组 = 清空既有方向
	ProtocolConvert *[]GroupProtocolConvert `json:"protocol_convert,omitempty"`
	Visibility      *GroupVisibility        `json:"visibility,omitempty"`
}

type GroupListResponse struct {
	Rows  []Group `json:"rows"`
	Total int64   `json:"total"`
}

type GroupPatch struct {
	Name       *string          `json:"name,omitempty"`
	Visibility *GroupVisibility `json:"visibility,omitempty"`
}

type GroupProtocolConvert string

type GroupVisibility string

type ImportFailedItem struct {
	// Error 该行失败原因文案
	Error string `json:"error"`

	// Index items 原始下标
	Index int `json:"index"`
}

type ImportResult struct {
	Failed []ImportFailedItem `json:"failed"`

	// Imported 新建账号数
	Imported int `json:"imported"`

	// Updated 键存在更新凭据数
	Updated int `json:"updated"`
}

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type KeyStatus string

type ListRulesParams struct {
	Enabled *bool `form:"enabled,omitempty" json:"enabled,omitempty"`
}

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

type MailTemplate struct {
	BodyText  string              `json:"body_text"`
	Purpose   MailTemplatePurpose `json:"purpose"`
	Subject   string              `json:"subject"`
	UpdatedAt *time.Time          `json:"updated_at"`
}

type MailTemplatePurpose string

type MailTemplateUpdate struct {
	// BodyText 空串=还原默认（删行）
	BodyText string `json:"body_text"`
	Subject  string `json:"subject"`
}

type MiddlewareFunc func(http.Handler) http.Handler

type OpsOptions struct {
	Workers   []StatsProvider
	Snapshots func() []SnapshotState // nil = 快照区返回空
	// InFlightUsers 实时在途并发快照提供面（/api/admin/users-top；实现 =
	// proxy.Auth.InFlightUsers——门禁快照只读访问器，零锁冷面。nil = 未装配 →
	// 端点返回空列表）。
	InFlightUsers func() map[int64]int64
	// BillingAlerts 计费告警面（/api/admin/overview alerts 段；实现 = billing
	// 游标消费者 lag 族观测直读（F2 ledger-cursor）。nil = 未装配 → alerts 全零）。
	BillingAlerts func() BillingAlerts
}

type OverviewAccounts struct {
	N429   int `json:"429"`
	Active int `json:"active"`

	// Concurrency 在途并发合计
	Concurrency int64 `json:"concurrency"`
	Disabled    int   `json:"disabled"`

	// MaxConcurrency 并发上限合计（水位 = concurrency / max_concurrency）
	MaxConcurrency int `json:"max_concurrency"`
	Unhealthy      int `json:"unhealthy"`
}

type OverviewAlerts struct {
	// BillingLagMs 游标积压时滞（毫秒）= 最近周期探测的 now − 最老 unbilled 行 created_at；0 = 游标空/未探测
	BillingLagMs int64 `json:"billing_lag_ms"`

	// BillingQuarantinedRows 累计隔离行数（用户缺失组 + 毒行终极隔离——未扣费写销）
	BillingQuarantinedRows int64 `json:"billing_quarantined_rows"`

	// BillingUnbilledRows 当前未扣费账本行数（部分索引 WHERE NOT billed）
	BillingUnbilledRows int64 `json:"billing_unbilled_rows"`
}

type OverviewErrTop struct {
	ErrCount int     `json:"err_count"`
	ErrRate  float64 `json:"err_rate"`

	// Name 账号名（非模型名——账号维度）
	Name string `json:"name"`
}

type OverviewResources struct {
	Groups    int `json:"groups"`
	Templates int `json:"templates"`
	Users     int `json:"users"`
}

type OverviewResponse struct {
	// Accounts 账号健康分布 + 并发水位（调度器快照同源——与账号列表运行时视图一致）
	Accounts OverviewAccounts `json:"accounts"`

	// Alerts 告警面（billing 游标消费者 lag 族观测，F2 ledger-cursor；注入面读取，未装配 = 全零）
	Alerts OverviewAlerts   `json:"alerts"`
	ErrTop []OverviewErrTop `json:"err_top"`

	// Resources 资源计数（冷面 count；模板/分组排除软删）
	Resources OverviewResources `json:"resources"`

	// Summary 今日汇总（UTC 日界；cost_usd/raw_cost_usd = 毫分 /1e5 → USD；TTFT 指标仅含首 token 流式请求样本，无样本 = 0）
	Summary OverviewSummary `json:"summary"`
	Trend   []OverviewTrend `json:"trend"`
}

type OverviewSummary struct {
	CacheReadTokens int64 `json:"cache_read_tokens"`

	// CallCount 按次调用（图片生成 = 张数、search = 1；usage_logs call_count 离线聚合 sum）
	CallCount int64 `json:"call_count"`

	// CostUsd 今日成本（USD，毫分 /1e5——与价格 API 口径一致）
	CostUsd float64 `json:"cost_usd"`

	// ErrRate 错误率（errors / requests；无请求 = 0）
	ErrRate      float64 `json:"err_rate"`
	Errors       int64   `json:"errors"`
	InputTokens  int64   `json:"input_tokens"`
	OutputTokens int64   `json:"output_tokens"`

	// RawCostUsd 今日原始成本（USD，毫分 /1e5——乘倍率前"实际消耗"口径；免费组 cost 为 0 但 raw 有值）
	RawCostUsd  float64 `json:"raw_cost_usd"`
	Requests    int64   `json:"requests"`
	TotalTokens int64   `json:"total_tokens"`

	// TtftAvgMs TTFT 均值（ttft_total_ms / ttft_count，查询侧 Go 除）
	TtftAvgMs float64 `json:"ttft_avg_ms"`

	// TtftMaxMs TTFT 最大值
	TtftMaxMs int64 `json:"ttft_max_ms"`

	// TtftP50Ms TTFT p50（直方图桶内线性插值，nearest-rank；顶桶回落 12800）
	TtftP50Ms int64 `json:"ttft_p50_ms"`
	TtftP90Ms int64 `json:"ttft_p90_ms"`
	TtftP95Ms int64 `json:"ttft_p95_ms"`
	TtftP99Ms int64 `json:"ttft_p99_ms"`
}

type OverviewTrend struct {
	// CallCount 按次调用（图片生成 = 张数、search = 1）
	CallCount int64 `json:"call_count"`

	// CostUsd 当日成本（USD，毫分 /1e5）
	CostUsd float64 `json:"cost_usd"`

	// Date 日桶（UTC）
	Date   openapi_types.Date `json:"date"`
	Errors int64              `json:"errors"`

	// RawCostUsd 当日原始成本（USD，毫分 /1e5——乘倍率前"实际消耗"口径）
	RawCostUsd float64 `json:"raw_cost_usd"`
	Requests   int64   `json:"requests"`

	// Tokens 当日总 token（usage_stats total_tokens 列聚合）
	Tokens int64 `json:"tokens"`

	// TtftAvgMs 当日 TTFT 均值（查询侧 Go 除）
	TtftAvgMs float64 `json:"ttft_avg_ms"`
	TtftMaxMs int64   `json:"ttft_max_ms"`
	TtftP50Ms int64   `json:"ttft_p50_ms"`
	TtftP90Ms int64   `json:"ttft_p90_ms"`
	TtftP95Ms int64   `json:"ttft_p95_ms"`
	TtftP99Ms int64   `json:"ttft_p99_ms"`
}

type PostAccountsBatchDeleteJSONRequestBody = BatchDeleteBody

type PostAccountsBatchImportCodexOauthJSONRequestBody = CodexOAuthImportBody

type PostAccountsBatchImportCodexPatJSONRequestBody = CodexPATImportBody

type PostAccountsBatchResetCooldownJSONRequestBody = BatchResetCooldownBody

type PostAccountsBatchUpdateJSONRequestBody = BatchUpdateAccountsBody

type PostAccountsJSONRequestBody = AccountCreate

type PostGroupsBatchDeleteJSONRequestBody = BatchDeleteBody

type PostGroupsBatchUpdateJSONRequestBody = BatchUpdateGroupsBody

type PostGroupsJSONRequestBody = GroupCreate

type PostRedemptionCodesBatchDeactivateJSONRequestBody = BatchDeactivateRequest

type PostRedemptionCodesIdDeactivateJSONRequestBody = DeactivateRequest

type PostRedemptionCodesJSONRequestBody = GenerateRequest

type PostRulesBatchDeleteJSONRequestBody = BatchDeleteBody

type PostTemplatesBatchDeleteJSONRequestBody = BatchDeleteBody

type PostTemplatesBatchUpdateJSONRequestBody = BatchUpdateTemplatesBody

type PostTemplatesJSONRequestBody = TemplateCreate

type PostUsersJSONRequestBody = UserCreate

type PriceEntry struct {
	CacheReadPerM  *float64       `json:"CacheReadPerM"`
	CacheWritePerM *float64       `json:"CacheWritePerM"`
	CreatedAt      time.Time      `json:"CreatedAt"`
	ImgInTokPerM   *float64       `json:"ImgInTokPerM"`
	ImgOutTokPerM  *float64       `json:"ImgOutTokPerM"`
	InputPerM      *float64       `json:"InputPerM"`
	Mode           PriceEntryMode `json:"Mode"`
	Model          string         `json:"Model"`
	OutputPerM     *float64       `json:"OutputPerM"`
	PricePerCall   *float64       `json:"PricePerCall"`
	PricePerImage  *float64       `json:"PricePerImage"`
	Provider       *Provider      `json:"Provider"`
	Source         PricingSource  `json:"Source"`
	UpdatedAt      time.Time      `json:"UpdatedAt"`
}

type PriceEntryListResponse struct {
	Rows  []PriceEntry `json:"rows"`
	Total int64        `json:"total"`
}

type PriceEntryMode string

type PriceEntryUpsert struct {
	CacheReadPerM  *float64             `json:"cache_read_per_m"`
	CacheWritePerM *float64             `json:"cache_write_per_m"`
	ImgInTokPerM   *float64             `json:"img_in_tok_per_m"`
	ImgOutTokPerM  *float64             `json:"img_out_tok_per_m"`
	InputPerM      *float64             `json:"input_per_m"`
	Mode           PriceEntryUpsertMode `json:"mode"`
	OutputPerM     *float64             `json:"output_per_m"`
	PricePerCall   *float64             `json:"price_per_call"`
	PricePerImage  *float64             `json:"price_per_image"`
}

type PriceEntryUpsertMode string

type PriceVariant struct {
	CreatedAt            time.Time `json:"CreatedAt"`
	CtxMax               *int64    `json:"CtxMax"`
	CtxMin               *int64    `json:"CtxMin"`
	DowMask              *int      `json:"DowMask"`
	Model                string    `json:"Model"`
	Seq                  int       `json:"Seq"`
	ServiceTier          *string   `json:"ServiceTier"`
	SetCacheCreationPerM *float64  `json:"SetCacheCreationPerM"`
	SetCacheReadPerM     *float64  `json:"SetCacheReadPerM"`
	SetImgInTokPerM      *float64  `json:"SetImgInTokPerM"`
	SetImgOutTokPerM     *float64  `json:"SetImgOutTokPerM"`
	SetInputPerM         *float64  `json:"SetInputPerM"`
	SetOutputPerM        *float64  `json:"SetOutputPerM"`
	SetPricePerCall      *float64  `json:"SetPricePerCall"`
	SetPricePerImage     *float64  `json:"SetPricePerImage"`
	TimeEnd              *string   `json:"TimeEnd"`
	TimeStart            *string   `json:"TimeStart"`
	UpdatedAt            time.Time `json:"UpdatedAt"`

	// Multiplier 价格倍率（正常值，1 = ×1，0 = 免费，上限 10 = ×10；API 边界倍数小数——存储 mult_bp 万分：存储 15000 ↔ 显示 1.5）
	Multiplier *float64 `json:"multiplier"`
}

type PriceVariantListRequest struct {
	Variants *[]PriceVariantUpsert `json:"variants,omitempty"`
}

type PriceVariantListResponse struct {
	Rows *[]PriceVariant `json:"rows,omitempty"`
}

type PriceVariantUpsert struct {
	CtxMax  *int64 `json:"ctx_max"`
	CtxMin  *int64 `json:"ctx_min"`
	DowMask *int   `json:"dow_mask"`

	// Multiplier 价格倍率（正常值，1 = ×1，0 = 免费，上限 10 = ×10；API 边界倍数小数——存储 mult_bp 万分：存储 15000 ↔ 显示 1.5）
	Multiplier           *float64 `json:"multiplier"`
	Seq                  *int     `json:"seq,omitempty"`
	ServiceTier          *string  `json:"service_tier"`
	SetCacheCreationPerM *float64 `json:"set_cache_creation_per_m"`
	SetCacheReadPerM     *float64 `json:"set_cache_read_per_m"`
	SetImgInTokPerM      *float64 `json:"set_img_in_tok_per_m"`
	SetImgOutTokPerM     *float64 `json:"set_img_out_tok_per_m"`
	SetInputPerM         *float64 `json:"set_input_per_m"`
	SetOutputPerM        *float64 `json:"set_output_per_m"`
	SetPricePerCall      *float64 `json:"set_price_per_call"`
	SetPricePerImage     *float64 `json:"set_price_per_image"`
	TimeEnd              *string  `json:"time_end"`
	TimeStart            *string  `json:"time_start"`
}

type PricingPreviewEntry struct {
	Action PricingPreviewEntryAction `json:"action"`
	Mode   PricingPreviewEntryMode   `json:"mode"`
	Model  string                    `json:"model"`
}

type PricingPreviewEntryAction string

type PricingPreviewEntryMode string

type PricingSource string

type PricingSyncPreviewResponse struct {
	Entries         *[]PricingPreviewEntry `json:"entries,omitempty"`
	Skipped         int                    `json:"skipped"`
	ToAdd           int                    `json:"to_add"`
	ToUpdate        int                    `json:"to_update"`
	VariantsChanged *int                   `json:"variants_changed,omitempty"`
}

type PricingSyncResponse struct {
	// Rows 拉取到的有效模型行数
	Rows int `json:"rows"`

	// Skipped 解析时跳过的非法条目数（文本价、image 价与 function 价均无效，计一次）
	Skipped int `json:"skipped"`

	// Updated 文本价 upsert 落库数（manual 行不计）
	Updated int `json:"updated"`
}

type Provider string

type PutAccountsIdExtJSONRequestBody = AccountExt

type PutAccountsIdJSONRequestBody = AccountCreate

type PutAdminSettingsJSONRequestBody = SettingUpdate

type PutGroupsIdAssignmentsJSONRequestBody = GroupAssignmentsBody

type PutGroupsIdJSONRequestBody = GroupCreate

type PutMailTemplateJSONRequestBody = MailTemplateUpdate

type PutPriceEntryJSONRequestBody = PriceEntryUpsert

type PutPriceEntryParams struct {
	Model string `form:"model" json:"model"`
}

type PutPriceVariantsJSONRequestBody = PriceVariantListRequest

type PutPriceVariantsParams struct {
	Model string `form:"model" json:"model"`
}

type PutTemplatesIdExtJSONRequestBody = TemplateExt

type PutTemplatesIdJSONRequestBody = TemplateCreate

type PutUsersIdGroupsJSONRequestBody = UserGroupsBody

type PutUsersIdJSONRequestBody = UserUpdate

type RedemptionCode struct {
	// Code XXXX-XXXX-XXXX-XXXX（16 字符，生成后不可编辑，仅可失效）
	Code      string    `json:"Code"`
	CreatedAt time.Time `json:"CreatedAt"`

	// CreatedBy 0 = 系统（静态 admin token）；>0 = platform_admin 用户 id
	CreatedBy int64 `json:"CreatedBy"`

	// ExpiresAt 码未兑换即过期；null = 永久
	ExpiresAt *time.Time `json:"ExpiresAt"`
	ID        int64      `json:"ID"`

	// MaxUses 1 = 单次码；>1 = 多人码
	MaxUses int     `json:"MaxUses"`
	Remark  *string `json:"Remark"`

	// ResourceExpiresAt 兑换后资源到期；temp_balance 必有，其余恒 null
	ResourceExpiresAt *time.Time       `json:"ResourceExpiresAt"`
	Status            RedemptionStatus `json:"Status"`
	Type              RedemptionType   `json:"Type"`
	UpdatedAt         time.Time        `json:"UpdatedAt"`

	// UsedCount 已兑换次数
	UsedCount int `json:"UsedCount"`

	// Value 面值：balance/temp_balance = USD（1 = $1）；concurrency = 并发数（整数）。存储毫分（API 边界换算）
	Value float64 `json:"Value"`
}

type RedemptionCodeListResponse struct {
	Rows  []RedemptionCode `json:"rows"`
	Total int64            `json:"total"`
}

type RedemptionStatus string

type RedemptionType string

type RedemptionUse struct {
	CodeID            int64      `json:"CodeID"`
	CreatedAt         time.Time  `json:"CreatedAt"`
	ID                int64      `json:"ID"`
	ResourceExpiresAt *time.Time `json:"ResourceExpiresAt"`
	UserID            int64      `json:"UserID"`

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

type RedemptionUseListResponse struct {
	Rows  []RedemptionUse `json:"rows"`
	Total int64           `json:"total"`
}

type RequestFormat string

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type Rule struct {
	CreatedAt time.Time `json:"CreatedAt"`

	// DeletedAt 软删除时间戳；null = 存活（列表/规则引擎重载过滤已删；GET 单个可查已删项）
	DeletedAt *time.Time `json:"DeletedAt"`
	Enabled   bool       `json:"Enabled"`
	ID        int64      `json:"ID"`
	Name      string     `json:"Name"`
	Priority  int        `json:"Priority"`

	// Then 动作集（只读回显；字段集与语义同 RuleCreate.then——status/cooldown/weight/response_code/custom_message；全空 {} = 纯透传规则：命中后码/文双透、零惩罚）
	Then      map[string]interface{} `json:"Then"`
	UpdatedAt time.Time              `json:"UpdatedAt"`

	// When 事件匹配条件（只读回显；字段集与语义同 RuleCreate.when——kind/http_status(_in)/model/model_in/error_message_contains(_in)/account_id/template_id/group_id/window_seconds/count_*/ratio_*；model 口径为映射后最终请求模型，区分大小写）
	When map[string]interface{} `json:"When"`
}

type RuleCreate struct {
	Enabled  *bool  `json:"enabled,omitempty"`
	Name     string `json:"name"`
	Priority int    `json:"priority"`

	// Then 动作集（指针即意图：键缺省/null = 该维度透传不改）。全空对象 {} 合法 =
	// 纯透传规则：命中后状态/冷却/权重零改动、响应码与文案双透传上游原样返回、
	// 不计惩罚（不投递状态事件）。可用键：
	// - status：命中后账号目标状态，active/unhealthy/429/disabled 之一
	// - cooldown：冷却时长，Go time.ParseDuration 可解析且 > 0（如 "30s"、"5h"）
	// - weight：调度权重 ∈ [0,100]
	// - response_code：缺省/null = 透传上游状态码；设置 = 覆写为指定码（400-599）
	// - custom_message：缺省/null = 透传上游错误文案；设置 = 覆写为固定文案（禁止空串）
	// 错误响应面无任何规则命中时默认归一为 502 "upstream rejected request"
	// （安全默认，未知错误不透传）；可用本对象的 response_code/custom_message 覆写该默认。
	Then *map[string]interface{} `json:"then,omitempty"`

	// When 事件匹配条件（自由对象，未知键拒绝 → 400）。规则按 priority 升序首中匹配，
	// 全部条件 AND 组合，缺省键不参与匹配。可用键：
	// - kind：事件类别，ok/429/4xx/5xx/network 之一；network = 连接级失败（独立类别，不吃 5xx 冷却）
	// - http_status：精确匹配响应码（400-599）；与 http_status_in 互斥（同现 → 400）
	// - http_status_in：响应码集合任一命中即匹配（OR；值限 400-599、去重、禁止空数组——传空数组 → 400）；与 http_status 互斥
	// - model：精确匹配最终请求模型名——映射后 sel.Model/MappedModel 口径（非客户端原始请求名），响应分类/状态事件/日志脱敏各事件面统一；区分大小写；空串非法；事件未携带模型时不命中；与 model_in 互斥
	// - model_in：最终请求模型名集合任一精确命中（OR；口径同 model、区分大小写、去重、元素禁止空串、禁止空数组——传空数组 → 400）；与 model 互斥
	// - error_message_contains：上游错误文本子串匹配；与 kind=ok 不兼容（ok 事件错误信息恒空，永不命中 → 400）
	// - error_message_contains_in：子串集合任一命中（OR；去重、元素禁止空串、禁止空数组）；与 error_message_contains 互斥、与 kind=ok 不兼容
	// - account_id / template_id / group_id：按账号/模板/分组过滤事件（精确匹配）
	// - window_seconds：计数/比例条件的滑动统计窗口秒数（≥1；缺省 60）
	// - count_429_ge / count_failure_ge / count_ok_ge / count_total_ge：窗口内计数阈值（≥0；failure 桶 = 非 ok 非 429 的失败事件，5xx/network/4xx 并入）
	// - ratio_429_ge / ratio_failure_ge：窗口内比例阈值 ∈ [0,1]，必须同时配置 count_total_ge 作为样本下限
	When *map[string]interface{} `json:"when,omitempty"`
}

type RuleListResponse struct {
	Rows  []Rule `json:"rows"`
	Total int64  `json:"total"`
}

type RulePatch struct {
	Enabled  *bool   `json:"enabled,omitempty"`
	Name     *string `json:"name,omitempty"`
	Priority *int    `json:"priority,omitempty"`

	// Then 动作集（指针即意图：键缺省/null = 该维度透传不改）。PUT 部分更新语义：
	// 键缺省（null/省略）= 保持原值；显式提供时整体替换该对象（显式 {} = 清空），
	// 并对合并后的完整 when/then 重新校验。全空对象 {} 合法 = 纯透传规则：
	// 命中后状态/冷却/权重零改动、响应码与文案双透传上游原样返回、不计惩罚
	// （不投递状态事件）。可用键：
	// - status：命中后账号目标状态，active/unhealthy/429/disabled 之一
	// - cooldown：冷却时长，Go time.ParseDuration 可解析且 > 0（如 "30s"、"5h"）
	// - weight：调度权重 ∈ [0,100]
	// - response_code：缺省/null = 透传上游状态码；设置 = 覆写为指定码（400-599）
	// - custom_message：缺省/null = 透传上游错误文案；设置 = 覆写为固定文案（禁止空串）
	// 错误响应面无任何规则命中时默认归一为 502 "upstream rejected request"
	// （安全默认，未知错误不透传）；可用本对象的 response_code/custom_message 覆写该默认。
	Then *map[string]interface{} `json:"then,omitempty"`

	// When 事件匹配条件（自由对象，未知键拒绝 → 400）。PUT 部分更新语义：键缺省
	// （null/省略）= 保持原值；显式提供时整体替换该对象（显式 {} = 清空），
	// 并对合并后的完整 when/then 重新校验。规则按 priority 升序首中匹配，
	// 全部条件 AND 组合，缺省键不参与匹配。可用键：
	// - kind：事件类别，ok/429/4xx/5xx/network 之一；network = 连接级失败（独立类别，不吃 5xx 冷却）
	// - http_status：精确匹配响应码（400-599）；与 http_status_in 互斥（同现 → 400）
	// - http_status_in：响应码集合任一命中即匹配（OR；值限 400-599、去重、禁止空数组——传空数组 → 400）；与 http_status 互斥
	// - model：精确匹配最终请求模型名——映射后 sel.Model/MappedModel 口径（非客户端原始请求名），响应分类/状态事件/日志脱敏各事件面统一；区分大小写；空串非法；事件未携带模型时不命中；与 model_in 互斥
	// - model_in：最终请求模型名集合任一精确命中（OR；口径同 model、区分大小写、去重、元素禁止空串、禁止空数组——传空数组 → 400）；与 model 互斥
	// - error_message_contains：上游错误文本子串匹配；与 kind=ok 不兼容（ok 事件错误信息恒空，永不命中 → 400）
	// - error_message_contains_in：子串集合任一命中（OR；去重、元素禁止空串、禁止空数组）；与 error_message_contains 互斥、与 kind=ok 不兼容
	// - account_id / template_id / group_id：按账号/模板/分组过滤事件（精确匹配）
	// - window_seconds：计数/比例条件的滑动统计窗口秒数（≥1；缺省 60）
	// - count_429_ge / count_failure_ge / count_ok_ge / count_total_ge：窗口内计数阈值（≥0；failure 桶 = 非 ok 非 429 的失败事件，5xx/network/4xx 并入）
	// - ratio_429_ge / ratio_failure_ge：窗口内比例阈值 ∈ [0,1]，必须同时配置 count_total_ge 作为样本下限
	When *map[string]interface{} `json:"when,omitempty"`
}

type ServerInterface interface {
	// 账号列表（分页/筛选/排序，含运行时视图）
	// (GET /accounts)
	GetAccounts(w http.ResponseWriter, r *http.Request, params GetAccountsParams)
	// 创建账号
	// (POST /accounts)
	PostAccounts(w http.ResponseWriter, r *http.Request)
	// 批量删除账号（事务，全成或全败）
	// (POST /accounts/batch-delete)
	PostAccountsBatchDelete(w http.ResponseWriter, r *http.Request)
	// 批量导入 codex-oauth 凭据（幂等组合键 codex_email + codex_account_id；items ≤100 原始条数；行级失败不毁整批）
	// (POST /accounts/batch-import-codex-oauth)
	PostAccountsBatchImportCodexOauth(w http.ResponseWriter, r *http.Request)
	// 批量导入 codex-pat 凭据（幂等组合键 codex_email + codex_account_id；items ≤100 原始条数；行级失败不毁整批）
	// (POST /accounts/batch-import-codex-pat)
	PostAccountsBatchImportCodexPat(w http.ResponseWriter, r *http.Request)
	// 批量重置账号冷却（事务，全成或全败；status→active + cooldown_until=now）
	// (POST /accounts/batch-reset-cooldown)
	PostAccountsBatchResetCooldown(w http.ResponseWriter, r *http.Request)
	// 批量更新账号（fields 为任意字段子集）
	// (POST /accounts/batch-update)
	PostAccountsBatchUpdate(w http.ResponseWriter, r *http.Request)
	// 账号用量聚合（统一 usage API——批量 ≤100 条；from/to 缺省 = 当天）
	// (GET /accounts/usage)
	GetAccountsUsage(w http.ResponseWriter, r *http.Request, params GetAccountsUsageParams)

	// (DELETE /accounts/{id})
	DeleteAccountsId(w http.ResponseWriter, r *http.Request, id int64)

	// (GET /accounts/{id})
	GetAccountsId(w http.ResponseWriter, r *http.Request, id int64)

	// (PUT /accounts/{id})
	PutAccountsId(w http.ResponseWriter, r *http.Request, id int64)
	// 读取账号类型化鉴权扩展（编辑回显；仅 codex-oauth/codex-pat 账号有 ext 行）
	// (GET /accounts/{id}/ext)
	GetAccountsIdExt(w http.ResponseWriter, r *http.Request, id int64)
	// 幂等写入账号类型化鉴权扩展（Create/Update 合一；全列更新含 NULL 清空）
	// (PUT /accounts/{id}/ext)
	PutAccountsIdExt(w http.ResponseWriter, r *http.Request, id int64)
	// 读取账号的全部分组 id（编辑回显；不随账号列表返回）
	// (GET /accounts/{id}/groups)
	GetAccountsIdGroups(w http.ResponseWriter, r *http.Request, id int64)
	// 错误明细分页查询（err_logs 完整错误面：本地拒绝 + 半异常双轨；status_code/error_type 全值）
	// (GET /err_logs)
	GetErrLogs(w http.ResponseWriter, r *http.Request, params GetErrLogsParams)
	// 分组列表（分页/筛选/排序）
	// (GET /groups)
	GetGroups(w http.ResponseWriter, r *http.Request, params GetGroupsParams)
	// 创建分组（平台容量池；key 为独立表，由用户面 /user/keys 创建）
	// (POST /groups)
	PostGroups(w http.ResponseWriter, r *http.Request)
	// 批量删除分组（事务，全成或全败）
	// (POST /groups/batch-delete)
	PostGroupsBatchDelete(w http.ResponseWriter, r *http.Request)
	// 批量更新分组（fields 为任意字段子集）
	// (POST /groups/batch-update)
	PostGroupsBatchUpdate(w http.ResponseWriter, r *http.Request)

	// (DELETE /groups/{id})
	DeleteGroupsId(w http.ResponseWriter, r *http.Request, id int64)

	// (GET /groups/{id})
	GetGroupsId(w http.ResponseWriter, r *http.Request, id int64)

	// (PUT /groups/{id})
	PutGroupsId(w http.ResponseWriter, r *http.Request, id int64)
	// 读取组的授予用户与专属倍率（platform_admin；与 PUT 对称，供前端预填充与安全全量写回）
	// (GET /groups/{id}/assignments)
	GetGroupsIdAssignments(w http.ResponseWriter, r *http.Request, id int64)
	// 设置组的授予用户（platform_admin；替换语义：未列出即撤销，空数组 = 清空）
	// (PUT /groups/{id}/assignments)
	PutGroupsIdAssignments(w http.ResponseWriter, r *http.Request, id int64)
	// 密钥列表（platform_admin 专属；脱敏，不含 key 明文——密钥明文绝不下发管理端）
	// (GET /keys)
	GetKeys(w http.ResponseWriter, r *http.Request, params GetKeysParams)
	// 邮件模板列表（缺行自动回退内置默认）
	// (GET /mail/templates)
	GetMailTemplates(w http.ResponseWriter, r *http.Request)
	// 更新邮件模板（空 body_text 还原内置默认=删行）
	// (PUT /mail/templates/{purpose})
	PutMailTemplate(w http.ResponseWriter, r *http.Request, purpose string)
	// 运维观测（worker 状态 + 快照注册表）
	// (GET /ops/workers)
	GetOpsWorkers(w http.ResponseWriter, r *http.Request)
	// 管理端总览（summary USD + trend 日桶 + 账号健康 + 资源 + err_top + 计费告警）
	// (GET /overview)
	GetAdminOverview(w http.ResponseWriter, r *http.Request, params GetAdminOverviewParams)
	// 统一价格列表（分页+筛选）
	// (GET /prices)
	GetPrices(w http.ResponseWriter, r *http.Request, params GetPricesParams)

	// (DELETE /prices/entry)
	DeletePriceEntry(w http.ResponseWriter, r *http.Request, params DeletePriceEntryParams)
	// 单条价格查询
	// (GET /prices/entry)
	GetPriceEntry(w http.ResponseWriter, r *http.Request, params GetPriceEntryParams)
	// 手动设价（upsert）
	// (PUT /prices/entry)
	PutPriceEntry(w http.ResponseWriter, r *http.Request, params PutPriceEntryParams)
	// 清空变体
	// (DELETE /prices/variants)
	DeletePriceVariants(w http.ResponseWriter, r *http.Request, params DeletePriceVariantsParams)
	// 变体列表（seq 升序）
	// (GET /prices/variants)
	GetPriceVariants(w http.ResponseWriter, r *http.Request, params GetPriceVariantsParams)
	// 整体替换变体（seq 升序首匹配）
	// (PUT /prices/variants)
	PutPriceVariants(w http.ResponseWriter, r *http.Request, params PutPriceVariantsParams)
	// 手动触发一次价格同步（fetch 官方价格表 → upsert → 快照重载；失败保留旧价）
	// (POST /pricing/sync)
	PostPricingSync(w http.ResponseWriter, r *http.Request)
	// 预览价格同步（零写库 diff 报告）
	// (POST /pricing/sync/preview)
	PostPricingSyncPreview(w http.ResponseWriter, r *http.Request)
	// 兑换码列表（增强分页范式 page/page_size；type/status 筛选；sort 白名单）
	// (GET /redemption-codes)
	GetRedemptionCodes(w http.ResponseWriter, r *http.Request, params GetRedemptionCodesParams)
	// 生成兑换码（1..count 个；count 默认 1，上限 1000；type 枚举/value>0/temp_balance 必填 resource_expires_at）
	// (POST /redemption-codes)
	PostRedemptionCodes(w http.ResponseWriter, r *http.Request)
	// 批量失效兑换码（单事务；已失效 no-op；缺失 id → 404 含缺失详情）
	// (POST /redemption-codes/batch-deactivate)
	PostRedemptionCodesBatchDeactivate(w http.ResponseWriter, r *http.Request)
	// 单码失效（已失效 no-op；缺失 → 404）
	// (POST /redemption-codes/{id}/deactivate)
	PostRedemptionCodesIdDeactivate(w http.ResponseWriter, r *http.Request, id int64)
	// 某码的兑换记录（审计；码缺失 → 404）
	// (GET /redemption-codes/{id}/uses)
	GetRedemptionCodesIdUses(w http.ResponseWriter, r *http.Request, id int64, params GetRedemptionCodesIdUsesParams)
	// 规则列表（enabled 过滤，priority 升序）
	// (GET /rules)
	ListRules(w http.ResponseWriter, r *http.Request, params ListRulesParams)
	// 创建规则
	// (POST /rules)
	CreateRule(w http.ResponseWriter, r *http.Request)
	// 批量删除规则（事务，全成或全败）
	// (POST /rules/batch-delete)
	PostRulesBatchDelete(w http.ResponseWriter, r *http.Request)
	// 删除规则
	// (DELETE /rules/{id})
	DeleteRule(w http.ResponseWriter, r *http.Request, id int64)
	// 更新规则（fields 任意子集，未提供字段保持原值）
	// (PUT /rules/{id})
	UpdateRule(w http.ResponseWriter, r *http.Request, id int64)
	// 全部设置（默认值 + DB 覆盖）
	// (GET /settings)
	GetAdminSettings(w http.ResponseWriter, r *http.Request)
	// 更新设置（类型化校验：switch 必须 true/false、number 必须数字）
	// (PUT /settings)
	PutAdminSettings(w http.ResponseWriter, r *http.Request)
	// 实体趋势（entity 卷积）
	// (GET /stats/entity-trend)
	GetStatsEntityTrend(w http.ResponseWriter, r *http.Request, params GetStatsEntityTrendParams)
	// Top 排行（entity 卷积）
	// (GET /stats/top)
	GetStatsTop(w http.ResponseWriter, r *http.Request, params GetStatsTopParams)
	// 趋势聚合（cube）
	// (GET /stats/trend)
	GetStatsTrend(w http.ResponseWriter, r *http.Request, params GetStatsTrendParams)
	// TTFT 聚合（sketch 或 exact）
	// (GET /stats/ttft)
	GetStatsTTFT(w http.ResponseWriter, r *http.Request, params GetStatsTTFTParams)
	// 临时额度列表（platform_admin 专属；全量视角含过期/用尽/负扣减行；user_id 筛选；sort 白名单 expires_at/amount/created_at，默认 expires_at asc——FEFO 同序）
	// (GET /temp-balances)
	GetTempBalances(w http.ResponseWriter, r *http.Request, params GetTempBalancesParams)
	// 模板列表（分页/筛选/排序）
	// (GET /templates)
	GetTemplates(w http.ResponseWriter, r *http.Request, params GetTemplatesParams)
	// 创建模板
	// (POST /templates)
	PostTemplates(w http.ResponseWriter, r *http.Request)
	// 批量删除模板（事务，全成或全败）
	// (POST /templates/batch-delete)
	PostTemplatesBatchDelete(w http.ResponseWriter, r *http.Request)
	// 批量更新模板（fields 为任意字段子集）
	// (POST /templates/batch-update)
	PostTemplatesBatchUpdate(w http.ResponseWriter, r *http.Request)

	// (DELETE /templates/{id})
	DeleteTemplatesId(w http.ResponseWriter, r *http.Request, id int64)

	// (GET /templates/{id})
	GetTemplatesId(w http.ResponseWriter, r *http.Request, id int64)

	// (PUT /templates/{id})
	PutTemplatesId(w http.ResponseWriter, r *http.Request, id int64)
	// 读取模板类型化扩展（编辑回显；仅生态三类型模板有 ext 行）
	// (GET /templates/{id}/ext)
	GetTemplatesIdExt(w http.ResponseWriter, r *http.Request, id int64)
	// 幂等写入模板类型化扩展（Create/Update 合一；全列更新含 NULL 清空）
	// (PUT /templates/{id}/ext)
	PutTemplatesIdExt(w http.ResponseWriter, r *http.Request, id int64)
	// 用量明细分页查询（usage_logs 放行路径明细——成功 none + abort 半异常，cost 不限；失败行（4xx/5xx/拒绝）归 /err_logs）
	// (GET /usage_logs)
	GetUsageLogs(w http.ResponseWriter, r *http.Request, params GetUsageLogsParams)
	// 用户列表（platform_admin 专属；分页/筛选/排序）
	// (GET /users)
	GetUsers(w http.ResponseWriter, r *http.Request, params GetUsersParams)
	// 创建用户（platform_admin 专属；email 唯一/格式、密码 ≤72 字节）
	// (POST /users)
	PostUsers(w http.ResponseWriter, r *http.Request)
	// 实时在途并发排行 TopN（本实例视角）
	// (GET /users-top)
	GetAdminUsersTop(w http.ResponseWriter, r *http.Request, params GetAdminUsersTopParams)
	// 更新用户（role/status/max_concurrency/balance；变更即时生效——Auth 快照刷新）
	// (PUT /users/{id})
	PutUsersId(w http.ResponseWriter, r *http.Request, id int64)
	// 读取用户被授予的分组与各专属倍率（platform_admin；用户视角，与 /groups/{id}/assignments 对称）
	// (GET /users/{id}/groups)
	GetUsersIdGroups(w http.ResponseWriter, r *http.Request, id int64)
	// 设置用户的授予分组（platform_admin；替换语义：未列出即撤销，空数组 = 清空）
	// (PUT /users/{id}/groups)
	PutUsersIdGroups(w http.ResponseWriter, r *http.Request, id int64)
}

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

type Setting struct {
	Key       *string      `json:"Key,omitempty"`
	Type      *SettingType `json:"Type,omitempty"`
	UpdatedAt *time.Time   `json:"UpdatedAt,omitempty"`
	Value     *string      `json:"Value,omitempty"`
}

type SettingType string

type SettingUpdate struct {
	Key   string `json:"key"`
	Value string `json:"value"`
}

type SnapshotState struct {
	// LastError 最近一次 reload 错误文本；缺省 = 成功
	LastError  *string   `json:"last_error,omitempty"`
	LastReload time.Time `json:"last_reload"`
	Name       string    `json:"name"`

	// Scopes 声明的变更 scope；null = 纯启动/状态快照
	Scopes *[]string `json:"scopes,omitempty"`
}

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 StatTopEntry struct {
	CacheCreationTokens *int64 `json:"CacheCreationTokens,omitempty"`
	CacheReadTokens     *int64 `json:"CacheReadTokens,omitempty"`
	CallCount           *int64 `json:"CallCount,omitempty"`

	// Cost 成本 USD（毫分 /1e5）
	Cost         *float64                `json:"Cost,omitempty"`
	EntityID     *int64                  `json:"EntityID,omitempty"`
	EntityType   *StatTopEntryEntityType `json:"EntityType,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    *float64 `json:"TTFTAvgMS,omitempty"`
	TTFTMaxMS    *int64   `json:"TTFTMaxMS,omitempty"`
	TotalTokens  *int64   `json:"TotalTokens,omitempty"`
}

type StatTopEntryEntityType 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 StatsProvider interface {
	Name() string
	Stats() any
}

type Template struct {
	BaseURL   string    `json:"BaseURL"`
	CreatedAt time.Time `json:"CreatedAt"`

	// CredentialType 模板号池类型；生态三类型只支持 resp / resp-ws 格式
	CredentialType *TemplateCredentialType `json:"CredentialType,omitempty"`

	// DeletedAt 软删除时间戳；null = 存活（列表过滤已删；GET 单个可查已删项）
	DeletedAt        *time.Time                 `json:"DeletedAt"`
	FormatModels     *map[string][]string       `json:"FormatModels,omitempty"`
	ID               int64                      `json:"ID"`
	ModelMapping     *map[string]string         `json:"ModelMapping,omitempty"`
	Models           *[]string                  `json:"Models,omitempty"`
	Name             string                     `json:"Name"`
	SupportedFormats []TemplateSupportedFormats `json:"SupportedFormats"`
	UpdatedAt        time.Time                  `json:"UpdatedAt"`
}

type TemplateCreate struct {
	BaseUrl          *string                          `json:"base_url,omitempty"`
	CredentialType   *TemplateCreateCredentialType    `json:"credential_type,omitempty"`
	FormatModels     *map[string][]string             `json:"format_models,omitempty"`
	ModelMapping     *map[string]string               `json:"model_mapping,omitempty"`
	Models           *[]string                        `json:"models,omitempty"`
	Name             string                           `json:"name"`
	SupportedFormats []TemplateCreateSupportedFormats `json:"supported_formats"`
}

type TemplateCreateCredentialType string

type TemplateCreateSupportedFormats string

type TemplateCredentialType string

type TemplateExt struct {
	// CredentialType 类型声明；必须与父模板 credential_type 一致（不一致 → 400）
	CredentialType TemplateExtCredentialType `json:"credential_type"`

	// StripImageTools 三类型公共能力开关：模板级图像 tool 剥离（NULL = 未配置 = 关闭）
	StripImageTools *bool  `json:"strip_image_tools"`
	TemplateId      *int64 `json:"template_id,omitempty"`
}

type TemplateExtCredentialType string

type TemplateListResponse struct {
	Rows  []Template `json:"rows"`
	Total int64      `json:"total"`
}

type TemplatePatch struct {
	BaseUrl          *string                          `json:"base_url,omitempty"`
	FormatModels     *map[string][]string             `json:"format_models,omitempty"`
	ModelMapping     *map[string]string               `json:"model_mapping,omitempty"`
	Models           *[]string                        `json:"models,omitempty"`
	Name             *string                          `json:"name,omitempty"`
	SupportedFormats *[]TemplatePatchSupportedFormats `json:"supported_formats,omitempty"`
}

type TemplatePatchSupportedFormats string

type TemplateSupportedFormats string

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type Unimplemented struct{}