更新日志

API Key

Better Auth 的 apiKey 插件已经接到 /v1/* 路由。每个请求都必须带 Authorization: Bearer ak_…。Key 按 workspace 划分，可在 dashboard 撤销。

• Key 在数据库里只存哈希，原值仅在创建时展示一次。
• 每个 key 的 metadata 记录最后使用时间，以及最近 N 次调用的来源 IP。

积分核算

credits 模块现在会在任务提交时扣款，终态失败时自动退款。

• 提交：插入一条金额等于模型挂牌价的 USAGE 交易，扣减用户余额。
• 成功：不动作，扣款保留。
• 失败 / 取消：写一条对冲交易，原因 REFUND_FAILED_JOB，余额还原。
• Webhook 处理器和 worker 共用同一个 settleJob()，不管哪条路径走完任务，账务都一致。

限流

按 API key 的滑动窗口限流通过 Postgres（request_log 表）实现，MVP 阶段不引入 Redis。默认配额：

• Free 套餐：60 次 / 分钟。
• Pro 套餐：600 次 / 分钟。
• Lifetime 套餐：600 次 / 分钟。

下一步

第 4 周开始铺公开 API 表面：OpenAPI 规范、/v1/jobs/:id/stream 的 SSE，以及 @genace/agent-video Claude Code skill 的首个版本。

异步任务 worker

生成请求不再阻塞 HTTP。Worker 从 Postgres 拉取 queued 任务，调用对应 Provider，然后把任务挂在 running 等上游回写。

• 指数退避 + 抖动 处理上游 5xx / 临时错误，单任务最多重试 6 次。
• 可见性超时：worker 崩溃后任务不会永远卡住，60 秒后会被另一个 worker 接管。
• 每个 Provider 的并发上限 从模型注册表读取，避免一次 Veo 3 爆量把 Flux Pro 饿死。

fal.ai Webhook 接入

/api/webhooks/fal 处理器先用项目密钥校验 x-fal-signature HMAC，然后在单个事务里把结果写进任务行和资源表。

• 时间戳 + nonce 双重校验拒绝重放。
• 校验失败会推到运维 Discord 频道并直接丢弃，绝不回 5xx，免得 fal.ai 反复重试。

体验改进

• 不论任务处于 queued、running、succeeded 还是 failed，/v1/jobs/:id 返回结构完全一致。
• 任务行新增 provider_meta JSONB 字段，调试上游 ID 不用再多打一次接口。

下一步

第 3 周打开真正的鉴权：API key、失败自动退款的积分扣减、按 key 的限流。

概览

Genace 第一个内部版本。还不面向用户，目的是把后续所有模型集成都要依赖的底座搭起来。

• Provider 适配器模式：所有上游统一对接 Provider 接口（submit、pollJob、parseWebhook）。首发对接 fal.ai。
• 模型注册表：registry/models.ts 声明每个支持的模型，包含能力、默认参数和单次调用价格。当前已注册：Seedance 2.0 fast、Kling 2.0、Veo 3（视频）和 Flux Pro、Nano Banana、Ideogram v3（图片）。
• 共享类型：GenerationRequest、GenerationJob 以及与上游解耦的资源类型集中在 src/ai/types.ts，让 API、worker 和 Claude Code skill 用同一套契约。

技术细节

• 所有 Provider 统一归一化到 JobStatus 枚举：queued | running | succeeded | failed | cancelled。
• 幂等键贯穿整条链路，Agent SDK 重试不会把积分扣两次。
• 本次版本通过 Drizzle migration 落地 generation_job / generation_asset 表结构。

下一步

第 2 周交付异步 worker、fal.ai webhook 签名校验，以及第一个带 API key 的 /v1/generations 端点。