异步调用步骤
- 把一次性显示的密钥保存到服务端环境变量
LUMINA_API_KEY，不要放进浏览器或 App 安装包。
- 先请求
GET /openai/v1/models，读取模型与当前 price_version。
- 提交任务。每个不同请求使用新的
Idempotency-Key；网络重试时复用原值，避免重复扣费。
curl -X POST "$BASE_URL/openai/v1/images/generations" \
-H "Authorization: Bearer $LUMINA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: image-request-20260929-0001" \
-d '{"model":"lumina-sunburst-4k","prompt":"A planted courtyard at blue hour","n":1,"aspect_ratio":"1:1","price_version":"MODEL_CATALOG_VALUE"}'
创建成功会返回 202 与 id。随后轮询任务；完成后按响应中的产物地址下载：
curl "$BASE_URL/openai/v1/jobs/${JOB_ID}" \
-H "Authorization: Bearer $LUMINA_API_KEY"
curl "$BASE_URL/openai/v1/artifacts/${ARTIFACT_ID}/content" \
-H "Authorization: Bearer $LUMINA_API_KEY" \
--output lumina-result.png