> ## 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 接口概览

> 正式地址、认证方式、同步返回与后台任务一览

正式环境基础地址：

```text theme={null}
https://api.ch88.cn
```

除临时素材 URL 外，请在 Playground 右侧认证区域填写自己的完整 Public API Key。文档不会保存或展示密钥申请入口。

所有 JSON 接口都会同步返回 HTTP 响应。成功响应统一包含顶层 `code`、`data` 和 `request_id`；错误响应统一包含 `error` 和 `request_id`。生图提交只代表任务已创建，图片仍在后台异步处理。

## 接口一览

| 方法     | 路径                                    | 模式       | 用途               |
| ------ | ------------------------------------- | -------- | ---------------- |
| `POST` | `/v1/open/uploads/images`             | 同步       | 上传本地图片并取得临时 URL。 |
| `POST` | `/v1/open/product-analysis`           | 同步       | 生成结构化商品分析。       |
| `POST` | `/v1/open/aplus/plans`                | 同步       | 生成 A+ 模块策划。      |
| `POST` | `/v1/open/product-images/generations` | 同步返回任务编号 | 提交商品图片生成任务。      |
| `POST` | `/v1/open/aplus/generations`          | 同步返回任务编号 | 提交 A+ 图片生成任务。    |
| `GET`  | `/v1/open/tasks/{task_id}`            | 同步查询     | 查询生成任务状态。        |
| `GET`  | `/v1/open/assets/{asset_id}`          | 文件响应     | 访问生成图片。          |

## Playground 使用方式

1. 从左侧选择一个接口。
2. 在认证区域填写完整 Public API Key。
3. 按字段中文说明填写请求体。
4. 点击发送，请求会调用 `https://api.ch88.cn` 正式环境。

<Warning>
  Playground 会产生真实 API 调用和真实上游消耗。生图和 AI 分析接口不要重复点击发送。
</Warning>

## 响应模式

* 商品分析与 A+ 策划：HTTP 请求内直接返回结果。
* 生图提交：返回 `{code, data: {task_id}, request_id}`，随后查询任务。
* 任务成功：`result.images[].url` 为最长有效 3 天的完整图片地址。
* 图片文件：直接返回二进制内容，不返回 JSON 包装。