# 图片生成

支持灵途用户 API Key 创建图片任务。先查模型与展示价格，携带算力预算直接提交；图片每张 30 算力。

## 复刻流程与身份

读取完整参考案例或本人提取任务的图集，收集用户自己的产品素材、张数、比例与改编要求。终端只配置 LINGTU_API_KEY，不需要产品服务器密钥。

本地商品素材可用 lingtu inspiration images upload <file> --json 上传供生图读取，返回可公开访问的 URL，不自动投稿；先确认方案与素材用途，不上传明确私密素材。

GET /api/agent/creation/models 返回可用模型、参考图上限与 priced_combinations。规格原样使用；参考图须为公开 HTTPS 地址，不能传本地路径、私有素材地址或 data URL。

展示价格来自模型目录，每张 30 算力，预计费用为单价乘以张数；展示不创建报价草稿，不扣算力。正式提交使用 POST /api/agent/creation/tasks，携带持久化的 requestId、kind=image、input 和 maxCredits；input 为模型、prompt、size、resolution、quality、n（1–4）及可选 image_urls（最多 16），遵守模型目录的实际限制。

模型与展示价格

```sh
lingtu inspiration images models --json
```

## 直接提交与成品

用户要求生成后直接提交，maxCredits 由 Agent 按模型目录展示价格和张数在内部填写，不向用户询问预算、不确认报价或金额；用户主动指定的上限仍须遵守。服务端在同一提交流程内部获取实时报价、预占算力、持久化提交标记并单次发起生成。共享算力最多一位小数；服务端按每张 30 算力和申请张数预占，完成后按实际交付张数结算，未交付部分释放；明确失败释放全部预占。

每 15 秒 GET /api/agent/creation/tasks/{id} 查询原任务。重复提交也只恢复，不重新发送生图请求。超时、断连、404、pending 或 outcome_unknown 不能证明没有生成，不要换 ID 重新提交。

completed 且 billingState=captured 时 result.images 为已转存的持久图片链接，chargedCredits 为实际扣除算力；结算待确认时不交付图片。图片链接应及时下载到用户指定目录。不会自动发布复刻作品或回存素材库。billingState=reconciliation_required 时保留任务请平台对账，不自动追加扣费。长期不查询可能导致预占过期，等待超时不取消远端任务。

提交一张图片的请求体（模型规格以目录为准）

```json
{
  "requestId": "11111111-1111-4111-8111-111111111111",
  "kind": "image",
  "input": {
    "model": "目录返回的模型",
    "prompt": "商品展示图",
    "size": "1:1",
    "resolution": "1K",
    "quality": "目录返回的质量",
    "n": 1
  },
  "maxCredits": "30"
}
```