# 更新日志

## 文档更正（2026-08）

`credits_consumed`、`balance`、`frozen` 在 JSON 中为**数值（number）**，最多两位小数（例如 `48.00`、`41465.00`）。请使用浮点或 decimal 解析——**禁止**用整数解析（`int`、`parseInt` 等），否则会失败或截断小数部分（如 VIP 折扣）。

## v3.0 (2026-04)

### 全新 API 架构

- **独立端点替代万能 POST**：按能力分组的独立端点（如 `POST /v3/generation/text-to-model`）替代原有的 `POST /v2/openapi/task` + `type` 字段的万能接口
- **统一 `{input}-to-{output}` 命名规范**：所有生成类端点采用直观的命名方式，如 `text-to-model`、`image-to-multiview`、`multiview-to-model`
- **统一 `input` 字段**：支持 `task_id` / `file_token` / URL 自动推断输入来源，无需手动指定输入类型
- **去除 `/openapi` 冗余路径**：Base URL 从 `/v2/openapi/` 简化为 `/v3/`
- **文生图和图生图分离为独立端点**：`text-to-image` 和 `image-to-image` 不再合并为同一个接口

### 端点变更明细

| v2 端点 | v3 端点 |
| :-: | :-: |
| `POST /v2/openapi/task` type=text_to_model | `POST /v3/generation/text-to-model` |
| `POST /v2/openapi/task` type=image_to_model | `POST /v3/generation/image-to-model` |
| `POST /v2/openapi/task` type=multiview_to_model | `POST /v3/generation/multiview-to-model` |
| `POST /v2/openapi/task` type=text_to_image | `POST /v3/generation/text-to-image` |
| `POST /v2/openapi/task` type=generate_image | `POST /v3/generation/image-to-image` |
| `POST /v2/openapi/task` type=generate_multiview_image | `POST /v3/generation/image-to-multiview` |
| `POST /v2/openapi/task` type=edit_multiview_image | `POST /v3/generation/edit-multiview` |
| `POST /v2/openapi/task` type=refine_model | `POST /v3/models/refine` |
| `POST /v2/openapi/task` type=convert_model | `POST /v3/models/convert` |
| `POST /v2/openapi/task` type=import_model | `POST /v3/models/import` |
| `POST /v2/openapi/task` type=stylize_model | `POST /v3/models/stylize` |
| `POST /v2/openapi/task` type=texture_model | `POST /v3/models/texture` |
| `POST /v2/openapi/task` type=animate_prerigcheck | `POST /v3/animations/rig-check` |
| `POST /v2/openapi/task` type=animate_rig | `POST /v3/animations/rig` |
| `POST /v2/openapi/task` type=animate_retarget | `POST /v3/animations/retarget` |
| `POST /v2/openapi/task` type=mesh_segmentation | `POST /v3/mesh/segment` |
| `POST /v2/openapi/task` type=mesh_completion | `POST /v3/mesh/complete` |
| `POST /v2/openapi/task` type=highpoly_to_lowpoly | `POST /v3/mesh/decimate` |
| `GET /v2/openapi/task/{task_id}` | `GET /v3/tasks/{task_id}` |

### 字段变更

| v2 字段 | v3 字段 |
| :-: | :-: |
| `create_time` | `created_at` |
| `consumed_credit` | `credits_consumed` |
| `file` / `file_token` / `url` / `object` | 统一为 `input` |

### 新增能力

- `POST /v3/tasks/list`：批量查询任务
- `POST /v3/files/upload-credentials`：获取文件直传凭证
- `GET /v3/account/usage`：查询用量明细