Image API Guide
接入与扣费说明
把用户最关心的三件事放在前面：怎么接入、什么时候扣费、任务离开页面后会不会继续跑。当前优先保证网页登录生图稳定，对外 API Key 后续再开放体验版。
Creative Dock
一块画布，完成从灵感到成图
Web
当前稳定路线
客户网页登录使用最稳
Async
后台任务
切页面后服务端继续执行
Guard
扣费保护
提交任务前明确成本确认
Developer Quick View
当前最稳路线：网页登录使用
这个站现在优先做成给客户直接登录使用的多功能生图工作台。站内任务已经是后台异步执行， 不要求用户一直停留在页面等待图片返回。对外 API Key 系统会放到后续体验版，避免为了追功能引入不稳定扣费链路。
Base Info
Public URL
https://image.scxai.top
当前入口
网页登录工作台
模型方式
OpenAI-compatible 中转站
任务机制
服务端后台异步执行
不会扣费
浏览首页、打开提示词库、复制模板、套用到工作台、筛选历史、下载图片、查看广场和测试 Provider /models。
会扣费
工作台点击提交后台任务，或在任务详情里按原参数重试。这两类动作会请求所选中转站或管理员共享额度。
需要确认
外网 Provider 默认要求先勾选成本确认；站点共享额度也会明确提示，避免客户误点造成连续消耗。
Endpoint Preview
站内接口心智
这里不是鼓励客户直接绕过网页登录调用，而是把“哪些动作会扣费”讲清楚。以后开放外部 API 时，也会沿用这套异步任务和成本确认思路。
GET
/healthz
站点健康检查，不扣费。
POST
/api/projects/:id/tasks
工作台提交生图任务，需成本确认。
GET
/api/projects/:id/tasks
读取任务状态和历史结果，不扣费。
GET
/api/settings/provider-credentials
读取个人 Provider 配置，不返回密钥明文。
Customer Flow
客户使用链路
Step 1
管理员在管理台配置站点共享 Provider 后，普通用户可以直接选择共享额度生图。
Step 2
如果管理员未配置共享额度，用户需要在设置页填写自己的 Base URL 和 API Key。
Step 3
用户在提示词库、生成广场或图表图页面选择灵感后，会直接跳转到工作台并自动填入主提示词。
Step 4
提交后任务进入服务端后台队列，用户可以离开页面，稍后回到历史区查看排队、生成、完成或失败状态。
Roadmap Guard
后续体验版方向
外部 OpenAI-compatible API Key 体系：适合以后给第三方软件直接调用，目前先不冒进开放。
Gemini / Grok 原生协议：当前稳定路线先通过 OpenAI-compatible 中转站模型名接入。
图片转 PPT 与深层可编辑图层：先保证图表图和 PPT 配图稳定，再逐步做可编辑结构化导出。