> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ch88.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 灵感开放平台

> 通过统一 API 完成商品分析、A+ 策划、商品图片生成与素材交付

灵感开放平台面向 Codex、WorkBuddy、Trae、企业业务系统和自动化工作流开放商品视觉能力。

<CardGroup cols={2}>
  <Card title="5 分钟完成首次调用" icon="rocket" href="/quickstart">
    从上传商品图开始，提交第一个生图任务并取得结果。
  </Card>

  <Card title="浏览全部 API" icon="code" href="/api-reference/overview">
    查看接口分组、同步与异步模式以及完整字段说明。
  </Card>

  <Card title="商品分析与 A+ 策划" icon="wand-magic-sparkles" href="/guides/analysis-planning">
    同步获得结构化商品信息和可编辑的 A+ 模块策划。
  </Card>

  <Card title="任务轮询与图片下载" icon="arrows-rotate" href="/guides/task-polling">
    正确处理异步状态、退避轮询和 3 天素材有效期。
  </Card>
</CardGroup>

## 基础信息

| 项目       | 说明                                       |
| -------- | ---------------------------------------- |
| 正式接口地址   | `https://api.ch88.cn`                    |
| 认证方式     | `Authorization: Bearer <PUBLIC_API_KEY>` |
| 请求格式     | JSON；图片上传使用 `multipart/form-data`        |
| 同步返回最终结果 | 商品 AI 分析、A+ AI 策划                        |
| 同步返回任务编号 | 商品图片生成、A+ 图片生成（后台异步处理）                   |
| 临时图片有效期  | 最长 3 天，到期后自动清理                           |

<Note>
  本站不提供 Public API Key 申请入口。请向贵司客户主管或平台管理员获取成员级 Public API Key。
</Note>

## 推荐调用流程

<Steps>
  <Step title="上传商品图片">
    调用图片上传接口，取得最长有效 3 天的临时图片 URL。
  </Step>

  <Step title="分析商品或生成 A+ 策划">
    需要结构化输入时，先调用同步分析/策划接口。
  </Step>

  <Step title="提交生图任务">
    调用商品图或 A+ 生图接口，从 `data.task_id` 取得任务编号。
  </Step>

  <Step title="轮询任务状态">
    按照 5、8、13、20、30 秒退避间隔查询，直到进入终态。
  </Step>

  <Step title="保存生成图片">
    生成图片地址最长保留 3 天，需要长期保存时请及时下载到自己的存储。
  </Step>
</Steps>