SANA-Sprint 文生图 API

模型：SANA-Sprint 1.6B（1024px，一致性蒸馏，1/2/4 步出图）。单并发服务，每张约 40-100 秒。

GET /health

健康检查，无需鉴权。返回 {"status":"ok","model":"...","device":"cuda"}。

POST /generate（同步出图）

请求头：Content-Type: application/json + X-API-Key: <你的密钥>

参数	类型	默认	约束	说明
prompt	string	必填	1-2000 字符	画面描述，支持中/英/emoji 混排
steps	int	2	仅 1 / 2 / 4	去噪步数，越多越慢；传 3 返回 422（SCM 调度器限制）
seed	int	随机	任意整数	固定可复现；响应返回实际 seed
width	int	1024	512-1024	宽度，自动对齐分辨率档位
height	int	1024	512-1024	高度，同上

响应：{"image_b64": "PNG base64", "seed": 123, "steps": 2}

curl -X POST https://sd.kyeo.top/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -d '{"prompt":"一只橘猫坐在窗台上晒太阳","steps":2}' \
  | jq -r .image_b64 | base64 -d > out.png

POST /generate_async → GET /result/{task_id}（异步批量）

参数与 /generate 完全相同。/generate_async 立即返回 {"task_id":"..."}（队列上限 8，满则 429）；轮询 /result/{task_id} 得到 queued / running / done(+image_b64) / error。

错误码

码	含义
401	缺少或错误的 X-API-Key
422	参数非法（如 steps=3、超尺寸）
429	已有任务在生成（同步）/ 队列满（异步）
503	模型加载中或显存不足，稍后重试

速度参考（1024×1024）：steps=1 约 40s，steps=2 约 60s，steps=4 约 100s；小分辨率更快。长时间出现 503 可能是显存碎片，请联系机主重启服务。