# Registro de alterações

## 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)

### Nova arquitetura API

- **Endpoints dedicados substituem o endpoint universal POST**: endpoints específicos de capacidade, como `POST /v3/generation/text-to-model`, substituem o endpoint universal anterior `POST /v2/openapi/task` por um campo `type`
- **Convenção de nomenclatura unificada `{input}-to-{output}`**: todos os endpoints de geração usam nomes intuitivos, como `text-to-model`, `image-to-multiview` e `multiview-to-model`
- **Campo `input` unificado**: suporta inferência automática de fonte de entrada de `task_id`, `file_token` ou URL, sem exigir que você especifique manualmente o tipo de entrada
- **Removido o caminho `/openapi` redundante**: O URL básico foi simplificado de `/v2/openapi/` para `/v3/`
- **Texto para imagem e imagem para imagem são separados em endpoints dedicados**: `text-to-image` e `image-to-image` não são mais combinados em um único API

### Alterações de endpoint

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

### Mudanças de campo

| Campo v2 | Campo v3 |
| :-: | :-: |
| `create_time` | `created_at` |
| `consumed_credit` | `credits_consumed` |
| `file` / `file_token` / `url` / `object` | Unificado como `input` |

### Novas capacidades

- `POST /v3/tasks/list` - Tarefas de consulta em lote
- `POST /v3/files/upload-credentials` - Obtenha credenciais de upload direto de arquivos
- `GET /v3/account/usage` – Consultar detalhes de uso