开发者 API

同一套流水线，程序化调度。在控制台 → API 密钥创建密钥后，以 Bearer 方式调用以下端点。BYOK 用户的 API 调用免积分（供应商成本自担）。

METHOD	PATH	说明
POST	/v1/documents	上传文档（multipart）或 /paste {text}
POST	/v1/jobs	{document_id, chapters[], options{types,density,lang}} → {job_id, quote}
GET	/v1/jobs/:id	状态 / 进度 / ETA
GET	/v1/jobs/:id/events?token=	SSE 实时进度流
GET	/v1/decks/:id/cards	卡片（含 audit_score / source_excerpt）
PATCH	/v1/cards/:id	审阅状态 / 编辑（留痕可回滚）
POST	/v1/cards/:id/regenerate	{feedback} 带反馈重生成
POST	/v1/decks/:id/export	{format:"apkg"\|"csv"\|"tsv"} → 下载地址
POST	/v1/api-keys	开发者密钥（程序化访问，scope 控制）

curl -X POST https://api.cardforge.app/v1/jobs \
  -H "Authorization: Bearer cf_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"document_id":"...","options":{"types":["basic","cloze"],"density":2}}'