# 変更履歴

## Documentation correction (2026-08)

\`credits_consumed\`, \`balance\`, and \`frozen\` are JSON **numbers** with up to two decimal places (e.g. \`48.00\`, \`41465.00\`). Parse them as floating-point or decimal values — **do not** use integer parsing (\`int\`, \`parseInt\`, etc.), which will fail or truncate fractional credits (e.g. VIP discounts).

## 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` パスを削除**: ベース URL は、`/v2/openapi/` から `/v3/` に簡素化されました。
- **テキストから画像への変換と画像から画像への変換は専用のエンドポイントに分離されました**: `text-to-image` と `image-to-image` は単一の API に結合されなくなりました

### エンドポイントの変更

| v2 エンドポイント | v3 エンドポイント |
| :-: | :-: |
| `POST /v2/openapi/task` タイプ=text_to_model | `POST /v3/generation/text-to-model` |
| `POST /v2/openapi/task` タイプ=image_to_model | `POST /v3/generation/image-to-model` |
| `POST /v2/openapi/task` タイプ=multiview_to_model | `POST /v3/generation/multiview-to-model` |
| `POST /v2/openapi/task` タイプ=text_to_image | `POST /v3/generation/text-to-image` |
| `POST /v2/openapi/task` タイプ=generate_image | `POST /v3/generation/image-to-image` |
| `POST /v2/openapi/task` タイプ=generate_multiview_image | `POST /v3/generation/image-to-multiview` |
| `POST /v2/openapi/task` タイプ=edit_multiview_image | `POST /v3/generation/edit-multiview` |
| `POST /v2/openapi/task` タイプ=refine_model | `POST /v3/models/refine` |
| `POST /v2/openapi/task` タイプ=convert_model | `POST /v3/models/convert` |
| `POST /v2/openapi/task` タイプ=import_model | `POST /v3/models/import` |
| `POST /v2/openapi/task` タイプ=stylize_model | `POST /v3/models/stylize` |
| `POST /v2/openapi/task` タイプ=texture_model | `POST /v3/models/texture` |
| `POST /v2/openapi/task` タイプ=animate_prerigcheck | `POST /v3/animations/rig-check` |
| `POST /v2/openapi/task` タイプ=animate_rig | `POST /v3/animations/rig` |
| `POST /v2/openapi/task` タイプ=animate_retarget | `POST /v3/animations/retarget` |
| `POST /v2/openapi/task` タイプ=mesh_segmentation | `POST /v3/mesh/segment` |
| `POST /v2/openapi/task` タイプ=mesh_completion | `POST /v3/mesh/complete` |
| `POST /v2/openapi/task` タイプ=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` - クエリの使用状況の詳細