# 변경 내역
## Retopology v3.0 and Smart UV (2026-10)
- **Retopology v3.0**: `POST /v3/mesh/decimate` accepts `model=v3.0`. The default is still `v2.0`, so existing requests behave the same. `face_limit` is 500–20,000 for triangle output and 500–10,000 for quad output; omit it for adaptive reduction. v3.0 is priced by output topology: **35** credits for a triangle mesh, **40** for a quad mesh (`quad=true`). v2.0 stays at 30 and v1.0 is unchanged.
- **`smart_uv`** (boolean, default `false`): unwraps UVs as part of v3.0 retopology at no extra cost. Passing it with v1.0 or v2.0 returns `400` (`1004`). It does not produce a UV atlas preview image.
- **Smart UV**: new `POST /v3/mesh/uv` re-unwraps a model's UVs and remaps its existing textures, rigging and animation onto the new layout; the result also carries a UV atlas preview (`uv_render_url`). **20** credits per task. The input model must not exceed 80,000 equivalent triangles.
## Texture model v3.5-20260815 (2026-09)
A new texture model, reachable from two entry points:
- **`POST /v3/models/texture`**: `model` now accepts `v3.5-20260815`. The default is still `v3.0-20250812`, so requests that omit the field are unchanged.
- **Generation endpoints** (`text-to-model`, `image-to-model`, `multiview-to-model`, including P1 / P2): new `texture_version` pins the texture model independently of the geometry `model`. Supported values are `v3.5-20260815`, `v3.0-20250812`, and `v2.5-20250123`; if omitted it is derived from the geometry version (v2.5 geometry → `v2.5-20250123`, otherwise `v3.0-20250812`).
Two new parameters ship with it, **both effective only on v3.5 textures**:
- **`texture_quality=fast`**: a new quality tier — the fastest generation, trading texture detail for speed. **Output texture size and credit cost are both identical to `standard`**; only the level of detail is lower. Requesting it on any other texture version returns `1004` instead of silently downgrading to `standard`.
- **`delight`** (boolean, default `true`): removes baked-in lighting from the reference image before texturing; set `false` to keep the original shading. Older texture versions ignore it.
## GPT Image 2.5, quality tiers and transparent backgrounds (2026-09)
`POST /v3/generation/text-to-image` and `POST /v3/generation/image-to-image` now accept two new models, the GPT Image 2/2.5 family gains a `quality` parameter, and the two 2.5 models gain a `background` parameter.
- **New models**: `chat_image_2.5_flare` and `chat_image_2.5_sunburst`. They cost the same and differ in trade-off — flare is noticeably faster, sunburst preserves the untouched parts of an edited image more closely.
- **`quality`**: accepted only by `chat_image_2` (`low`, `medium`, `high`) and the two 2.5 models (additionally `xhigh`, `max`). Omitting it is equivalent to `low` — note this differs from OpenAI's own default of `auto`, which is not supported here. `high`/`xhigh`/`max` cost extra credits; see the Pricing page.
- **`background`**: `auto`, `opaque` or `transparent`, supported by the two 2.5 models only. Omit it to let the model decide. Passing it with any other model is ignored rather than rejected, so existing requests keep working unchanged.
- **`transparent` requires `output_format=png`**: JPEG carries no alpha channel, so that combination returns an error instead of silently flattening the transparency.
- **Custom sizes**: `chat_image_2` and the 2.5 models accept any `WIDTHxHEIGHT` where each edge is at most 3840 and a multiple of 16, the long edge is at most 3x the short edge, and total pixels fall between 655,360 and 8,294,400. The previous presets continue to work.
- **Retirement**: `chat_image_1` will be retired on **2026-10-23** and `chat_image_1.5` on **2026-12-01**. Migrate to `chat_image_2` or the 2.5 models before those dates.
## P2 series model (2026-08)
`POST /v3/generation/text-to-model`, `image-to-model`, and `multiview-to-model` now accept `model=P2-20260801` (an upgrade of P1).
- **P2-only parameters**: `quad` (quad mesh). Sending `quad=true` with P1 returns `400`; switch to P2 or remove the field.
- **`face_limit`**: triangle 48–50,000; with `quad=true`, 48–25,000. Omitted = adaptive.
- **Credits**: 100 without texture; `standard` / `detailed` / `extreme` = 110 / 120 / 130 (same texture add-ons as P1).
- **P1** (`P1-20260311`) remains available; P1 does not support `quad`, `smart_low_poly`, `generate_parts`, or `geometry_quality`.
## 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` - 사용량 세부정보 쿼리
변경 내역
Retopology v3.0 and Smart UV (2026-10)
- Retopology v3.0:
POST /v3/mesh/decimate accepts model=v3.0. The default is still v2.0, so existing requests behave the same. face_limit is 500–20,000 for triangle output and 500–10,000 for quad output; omit it for adaptive reduction. v3.0 is priced by output topology: 35 credits for a triangle mesh, 40 for a quad mesh (quad=true). v2.0 stays at 30 and v1.0 is unchanged.
smart_uv (boolean, default false): unwraps UVs as part of v3.0 retopology at no extra cost. Passing it with v1.0 or v2.0 returns 400 (1004). It does not produce a UV atlas preview image.- Smart UV: new
POST /v3/mesh/uv re-unwraps a model’s UVs and remaps its existing textures, rigging and animation onto the new layout; the result also carries a UV atlas preview (uv_render_url). 20 credits per task. The input model must not exceed 80,000 equivalent triangles.
Texture model v3.5-20260815 (2026-09)
A new texture model, reachable from two entry points:
POST /v3/models/texture: model now accepts v3.5-20260815. The default is still v3.0-20250812, so requests that omit the field are unchanged.- Generation endpoints (
text-to-model, image-to-model, multiview-to-model, including P1 / P2): new texture_version pins the texture model independently of the geometry model. Supported values are v3.5-20260815, v3.0-20250812, and v2.5-20250123; if omitted it is derived from the geometry version (v2.5 geometry → v2.5-20250123, otherwise v3.0-20250812).
Two new parameters ship with it, both effective only on v3.5 textures:
texture_quality=fast: a new quality tier — the fastest generation, trading texture detail for speed. Output texture size and credit cost are both identical to standard; only the level of detail is lower. Requesting it on any other texture version returns 1004 instead of silently downgrading to standard.delight (boolean, default true): removes baked-in lighting from the reference image before texturing; set false to keep the original shading. Older texture versions ignore it.
GPT Image 2.5, quality tiers and transparent backgrounds (2026-09)
POST /v3/generation/text-to-image and POST /v3/generation/image-to-image now accept two new models, the GPT Image 2/2.5 family gains a quality parameter, and the two 2.5 models gain a background parameter.
- New models:
chat_image_2.5_flare and chat_image_2.5_sunburst. They cost the same and differ in trade-off — flare is noticeably faster, sunburst preserves the untouched parts of an edited image more closely.
quality: accepted only by chat_image_2 (low, medium, high) and the two 2.5 models (additionally xhigh, max). Omitting it is equivalent to low — note this differs from OpenAI’s own default of auto, which is not supported here. high/xhigh/max cost extra credits; see the Pricing page.background: auto, opaque or transparent, supported by the two 2.5 models only. Omit it to let the model decide. Passing it with any other model is ignored rather than rejected, so existing requests keep working unchanged.transparent requires output_format=png: JPEG carries no alpha channel, so that combination returns an error instead of silently flattening the transparency.- Custom sizes:
chat_image_2 and the 2.5 models accept any WIDTHxHEIGHT where each edge is at most 3840 and a multiple of 16, the long edge is at most 3x the short edge, and total pixels fall between 655,360 and 8,294,400. The previous presets continue to work.
- Retirement:
chat_image_1 will be retired on 2026-10-23 and chat_image_1.5 on 2026-12-01. Migrate to chat_image_2 or the 2.5 models before those dates.
P2 series model (2026-08)
POST /v3/generation/text-to-model, image-to-model, and multiview-to-model now accept model=P2-20260801 (an upgrade of P1).
- P2-only parameters:
quad (quad mesh). Sending quad=true with P1 returns 400; switch to P2 or remove the field.
face_limit: triangle 48–50,000; with quad=true, 48–25,000. Omitted = adaptive.- Credits: 100 without texture;
standard / detailed / extreme = 110 / 120 / 130 (same texture add-ons as P1).
- P1 (
P1-20260311) remains available; P1 does not support quad, smart_low_poly, generate_parts, or geometry_quality.
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 - 사용량 세부정보 쿼리
