ds2api / agy2api /src /api /utils.py
luckfun233
feat(agy): 内嵌 agy2api,接入 Gemini 模型与独立 AGY 面板
b0074f5
Raw History Blame Contribute Delete
7.13 kB
"""
API 客户端共用基础功能:自动封禁、错误重试、调用结果记录、冷却解析
"""
import asyncio
import json
import re
import time
from datetime import datetime, timezone
from typing import Any, Dict, Optional
from config import (
get_auto_ban_enabled,
get_auto_ban_error_codes,
get_retry_429_enabled,
get_retry_429_interval,
get_retry_429_max_retries,
)
from log import log
from src.credential_manager import record_api_call_result, set_cred_disabled
# ==================== 错误检查与处理 ====================
async def check_should_auto_ban(status_code: int) -> bool:
"""检查是否应该触发自动封禁"""
return (
await get_auto_ban_enabled()
and status_code in await get_auto_ban_error_codes()
)
async def handle_auto_ban(status_code: int, email: str) -> None:
"""处理自动封禁:直接禁用凭证"""
if email:
log.warning(f"[AUTO_BAN] Status {status_code} triggers auto-ban for credential: {email}")
await set_cred_disabled(email, True)
async def handle_error_with_retry(
status_code: int,
email: str,
retry_enabled: bool,
attempt: int,
max_retries: int,
retry_interval: float,
) -> bool:
"""
统一处理错误和重试逻辑
仅在以下情况下进行自动重试:
1. 429错误(速率限制)
2. 503错误(服务不可用)
3. 500错误(服务临时不可用)
4. 导致凭证封禁的错误(AUTO_BAN_ERROR_CODES配置)
Returns:
bool: True表示需要继续重试,False表示不需要重试
"""
# 优先检查自动封禁
if await check_should_auto_ban(status_code):
await handle_auto_ban(status_code, email)
# 自动封禁后,仍然尝试重试(会在下次循环中自动获取新凭证)
if retry_enabled and attempt < max_retries:
log.info(
f"[RETRY] Retrying with next credential after auto-ban "
f"(status {status_code}, attempt {attempt + 1}/{max_retries})"
)
await asyncio.sleep(retry_interval)
return True
return False
# 如果不触发自动封禁,仅对429、503和500错误进行重试
if status_code in (429, 500, 503) and retry_enabled and attempt < max_retries:
log.info(
f"[RETRY] {status_code} error encountered, retrying "
f"(attempt {attempt + 1}/{max_retries})"
)
await asyncio.sleep(retry_interval)
return True
return False
# ==================== 重试配置获取 ====================
async def get_retry_config() -> Dict[str, Any]:
"""获取重试配置"""
return {
"retry_enabled": await get_retry_429_enabled(),
"max_retries": await get_retry_429_max_retries(),
"retry_interval": await get_retry_429_interval(),
}
# ==================== API调用结果记录 ====================
async def record_api_call_success(
email: str,
model_name: Optional[str] = None,
) -> None:
"""记录API调用成功"""
if email:
await record_api_call_result(
email, True, model_name=model_name
)
async def record_api_call_error(
email: str,
status_code: int,
cooldown_until: Optional[float] = None,
model_name: Optional[str] = None,
error_message: Optional[str] = None,
) -> None:
"""记录API调用错误"""
if email:
await record_api_call_result(
email,
False,
status_code,
cooldown_until=cooldown_until,
model_name=model_name,
error_message=error_message,
)
# ==================== 429错误处理 ====================
async def parse_and_log_cooldown(error_text: str) -> Optional[float]:
"""
解析并记录冷却时间
Returns:
冷却截止时间(Unix时间戳),解析失败返回None
"""
try:
error_data = json.loads(error_text)
cooldown_until = parse_quota_reset_timestamp(error_data)
if cooldown_until:
log.info(
f"检测到quota冷却时间: "
f"{datetime.fromtimestamp(cooldown_until, timezone.utc).isoformat()}"
)
return cooldown_until
except Exception as parse_err:
log.debug(f"Failed to parse cooldown time: {parse_err}")
return None
def parse_quota_reset_timestamp(error_response: dict) -> Optional[float]:
"""
从 Antigravity API 429 错误响应中提取quota重置时间戳
解析优先级:
1. ErrorInfo.metadata.quotaResetTimeStamp(绝对时间戳,最精确)
2. ErrorInfo.metadata.quotaResetDelay(相对时长,如 "154h21m14.468080073s")
3. RetryInfo.retryDelay(纯秒数,如 "555674.468080073s")
"""
try:
error_obj = error_response.get("error", {})
details = error_obj.get("details", [])
error_info_metadata: Optional[dict] = None
retry_delay_str: Optional[str] = None
for detail in details:
detail_type = detail.get("@type", "")
if detail_type == "type.googleapis.com/google.rpc.ErrorInfo":
error_info_metadata = detail.get("metadata", {})
elif detail_type == "type.googleapis.com/google.rpc.RetryInfo":
retry_delay_str = detail.get("retryDelay")
unit_to_seconds = {"s": 1, "m": 60, "h": 3600, "d": 86400}
# 优先级1: quotaResetTimeStamp(绝对时间戳)
if error_info_metadata:
reset_timestamp_str = error_info_metadata.get("quotaResetTimeStamp")
if reset_timestamp_str:
if reset_timestamp_str.endswith("Z"):
reset_timestamp_str = reset_timestamp_str.replace("Z", "+00:00")
reset_dt = datetime.fromisoformat(reset_timestamp_str)
if reset_dt.tzinfo is None:
reset_dt = reset_dt.replace(tzinfo=timezone.utc)
return reset_dt.astimezone(timezone.utc).timestamp()
# 优先级2: quotaResetDelay(相对时长,支持小数秒)
if error_info_metadata:
reset_delay_str = error_info_metadata.get("quotaResetDelay")
if reset_delay_str:
parts = re.findall(r"(\d+(?:\.\d+)?)([smhd])", reset_delay_str)
if parts:
cooldown_seconds = sum(
float(value) * unit_to_seconds[unit] for value, unit in parts
)
if cooldown_seconds > 0:
return time.time() + cooldown_seconds
# 优先级3: RetryInfo.retryDelay(纯秒数)
if retry_delay_str:
parts = re.findall(r"(\d+(?:\.\d+)?)([smhd])", retry_delay_str)
if parts:
cooldown_seconds = sum(
float(value) * unit_to_seconds[unit] for value, unit in parts
)
if cooldown_seconds > 0:
return time.time() + cooldown_seconds
return None
except Exception:
return None