让你的工具，也能开始创作。

每次请求使用 Authorization: Bearer YOUR_API_KEY。新密钥以 sk- 开头，请保存在你的服务端环境变量中。创建或撤销密钥使用网站登录状态。

下表从当前模型目录读取。1 积分对应 ¥0.01；图像按张、视频按秒计费。可用模型以带密钥请求 GET /v1/models 的结果为准。

正在读取模型目录…

创建任务与查询结果

为每次新创作生成一个 Idempotency-Key。网络中断时，使用同一个标识和完全相同的参数重试；另一次创作使用新的标识。任务排队和生成期间，可继续提交其他任务。

创建任务通常返回 HTTP 202。图像请求未设置 async: true 时会等待最多约 25 秒，完成则返回 HTTP 200，仍未完成则返回 HTTP 202。收到任务编号后只需查询该任务。

任务状态：in_progress 生成中；completed 已完成；partial 部分完成；failed 失败；cancelled 已取消。失败任务返回 error 和逐张 failures；usage 区分已消耗、仍预留和已退回积分。图片响应 data 中的签名地址可直接下载，也可使用带 Bearer 的 content 接口。

请求示例

在自己的环境中设置 LUMINA_BASE_URL（上方地址）和 LUMINA_API_KEY。以下示例仅供复制，本页不会发送生图或视频生成请求。

curl "$LUMINA_BASE_URL/models" \
  -H "Authorization: Bearer $LUMINA_API_KEY"

curl "$LUMINA_BASE_URL/images/generations" \
  -H "Authorization: Bearer $LUMINA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: image-request-001" \
  -d '{"model":"gpt-image-2.5-sunburst","prompt":"阳光下的自然式花园，写实摄影","resolution":"1K","aspect_ratio":"1:1","n":1,"response_format":"url","async":true}'

图像支持 resolution 或 size 像素尺寸。参考图放在 images 数组，以 data URI 传入；可用数量和尺寸以模型目录为准。

curl "$LUMINA_BASE_URL/images/generations" -H "Authorization: Bearer $LUMINA_API_KEY" -H "Content-Type: application/json" -H "Idempotency-Key: seedream-request-001" -d '{"model":"seedream5.0pro","prompt":"晨光中的庭院，写实摄影","resolution":"1K","aspect_ratio":"1:1","n":1,"response_format":"url","async":true}'

# 把创建响应中的完整 img_... 编号保存为 TASK_ID，持续查询同一个任务
curl "$LUMINA_BASE_URL/tasks/$TASK_ID" -H "Authorization: Bearer $LUMINA_API_KEY"

Seedream 支持 1K / 2K 文生图及图生图，参考图通过 images 传入最多 10 张 data URI。等待结果时保持原 Idempotency-Key；任务查询会继续恢复原上游任务。价格及可用状态以模型目录为准。

curl "$LUMINA_BASE_URL/videos" \
  -H "Authorization: Bearer $LUMINA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: video-request-001" \
  -d '{"model":"wan3.0-ns","prompt":"小猫在花园中追逐蝴蝶，镜头平稳推进","duration":10,"resolution":"720p","aspect_ratio":"16:9","images":[],"audios":[]}'

wan3.0-ns，支持固定 2–30 秒、480p / 720p / 1080p，比例为 adaptive、16:9、4:3、1:1、3:4、9:16。最多 10 张参考图与 5 段音频，均以 data URI 数组传入。图片单张最多 20 MB；音频单段最多 15 MB、1–15 秒，总时长最多 15 秒；所有参考文件合计最多 60 MB。视频参考价格翻倍，暂不支持。

# 把 TASK_ID 换成创建响应中的完整 id，例如 vid_...
curl "$LUMINA_BASE_URL/tasks/$TASK_ID" \
  -H "Authorization: Bearer $LUMINA_API_KEY"

# status 为 completed 后下载
curl "$LUMINA_BASE_URL/videos/$TASK_ID/content" \
  -H "Authorization: Bearer $LUMINA_API_KEY" -o video.mp4

错误与重试

错误响应格式为 {"error":{"message":"具体原因"}}。不要把 API Key 放入网址、浏览器存储或前端公开代码。