# 변경 내역

## 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` - 사용량 세부정보 쿼리