开发者

文生图 API

异步任务式 REST API：提交提示词，立即返回 `task_id`（HTTP 202），轮询直到图片链接就绪。一把 Key 通用全部能力；失败任务不消耗额度。

最后更新：2026-11-08

快速开始

在账号页创建一把 Key，然后带 X-API-Key 提交任务：

# 1. 提交——立即返回 HTTP 202 与 task_id
curl -X POST https://create.litelake.cn/api/open/t2i \
  -H "X-API-Key: lcr_…" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"清晨平静的湖面，柔光","aspect_ratio":"16:9","output_format":"png"}'

{
  "code": 200,
  "message": "ok",
  "data": {
    "task_id": "tsk_…",
    "status": "queued",
    "capability": "t2i",
    "created_at": "2026-11-08T02:00:00Z",
    "usage": {
      "personal": { "used_today": 1, "limit_per_day": 1 },
      "site_free": { "used_today": 3, "limit_per_day": 10 },
      "reset_at_utc": "…"
    }
  }
}

# 2. 轮询——每 2 秒一次，直到 status 进入终态
curl https://create.litelake.cn/api/open/tasks/tsk_… \
  -H "X-API-Key: lcr_…"

{
  "code": 200,
  "message": "ok",
  "data": {
    "task_id": "tsk_…",
    "status": "succeeded",
    "capability": "t2i",
    "prompt": "清晨平静的湖面，柔光",
    "aspect_ratio": "16:9",
    "output_format": "png",
    "image": { "url": "https://…", "expires_at": "…" },
    "error": null,
    "latency_ms": 8210,
    "created_at": "2026-11-08T02:00:00Z",
    "finished_at": "2026-11-08T02:00:09Z"
  }
}

认证

开放端点统一用请求头认证：X-API-Key: lcr_…。Key 在账号页自助创建，明文只在创建时展示一次。Key 继承个人每日额度；不限量的超级 Key 经管理中心发放。

提交 — POST /api/open/t2i

返回 HTTP 202（受理）与上方信封。任务进入排队，不做同步等待。

参数	类型	说明
`prompt`	`string`	必填。生成内容描述，≤2000 字符。
`aspect_ratio`	`"1:1"` \| `"2:3"` \| `"3:2"` \| `"3:4"` \| `"4:3"` \| `"9:16"` \| `"16:9"`	默认 `1:1`。
`output_format`	`"png"` \| `"jpeg"` \| `"webp"`	默认 `png`。

轮询 — GET /api/open/tasks/{task_id}

返回任务资源。status 沿流水线推进：

状态	含义
`queued`	已受理，等待调度。
`submitted`	已提交上游模型。
`running`	模型生成中。
`transferring`	生成完成——图片转存中。
`succeeded`	完成。`image.url` 为下载直链（每次拉取后 24 小时有效；图片本体保留 7 天）。
`failed`	`error.code` / `error.message` 说明原因。上游失败不消耗额度。
`expired`	结果窗口过期未被取回。请重新提交。

每 2 秒轮询一次。任务一般约 10 秒完成；轮询 90 秒后请停手，任务视为仍在处理（稍后再查）。

任务列表 — GET /api/open/tasks?limit=N

按时间倒序返回你的最近任务（limit 默认 20）。

错误码

业务错误保持信封结构，错误码在 body.code。下表同时适用于开放 API 与登录创作台。

错误码	含义
`40001`	invalid_params——参数缺失或不在白名单。
`40021`	prompt_too_long——提示词超过 2000 字符。
`40102`	unauthorized——无有效会话或 Key（用户面返回 HTTP 401）。
`40301`	account_suspended——账号被封禁。
`42901`	个人日额度用尽——UTC 零点重置。
`42902`	全站免费预算用尽——下一个 UTC 日恢复。
`42903`	并发超限——等在途任务完成后再提交。
`50021`	上游生成失败——稍后重试；不扣额度。
`50022`	上游超时——重试；不扣额度。
`50023`	网络错误中断任务——重试。
`50024`	限流存储不可用——稍后重试。
`50025`	上游繁忙——稍后重试；不扣额度。

限额与说明

免费 Beta：每用户每天 1 次成功生成（UTC 重置）；失败或超时不计次。
免费档同时共享全站每日预算；耗尽（42902）后下一个 UTC 日恢复。
生成图片保留 7 天。每次轮询返回的 image.url 是拉取后 24 小时有效的直链——过期后重新拉取任务即可拿到新链。
并发：同一身份同时 1 个在途任务（42903）。
Beta 阶段能力固定为 t2i；图生图、文生视频等维度后续开放。

获取 API Key

登录后在账号页自助创建；明文只在创建时展示一次。打开账号页