创作工作台

API 接入

Base URL：。使用 Authorization: Bearer si_…。管理和任务接口使用 EJSON；/v1/images/* 成功响应兼容 Images API 的 data[].b64_json。

异步任务（推荐）

轮询 GET /api/jobs/{id}；状态为 queued、running、succeeded、failed、uncertain 或 cancelled。图片使用同一 KEY 访问返回的 assets.url。

图片生成与编辑

POST /v1/images/generations 接收 JSON；POST /v1/images/edits 接收 multipart 的 image、prompt、model、size、quality、n。只支持列出的模型、三种标准尺寸及 b64_json；不支持流式、任意模型透传或远程图片 URL。

同步请求等待上限300秒；返回202时用任务ID轮询，不要重新提交。发送 Idempotency-Key 防止重复入队。n=1～4，每张图片占1额度；物料和GIF任务固定1张源图。

额度口径

额度为“生成图片张数”，不是美元余额。入队预占，成功后结算。已生成但后处理失败仍计费，原图保留。上游结果不确定时保留预占，管理员核对后扣除或释放。保存上游 usage 便于后续核算，不臆测实际费用。