---
title: "Start 3D generation (spends the account's credits)"
method: POST
path: "/v1/items/{id}/generate"
tags: ["items"]
---

# Start 3D generation (spends the account's credits)

`POST /v1/items/{id}/generate`

## Request

- Base URL: `https://pixeloa.ai`
- URL: `https://pixeloa.ai/v1/items/{id}/generate`
- Auth: HTTP bearer

Requires status 'confirmed' with confirmed dimensions (a 'failed' generation may be attempted again on the same item; it was refunded and has no result). A 'ready' item is never regenerated in place; for another result create a new item from the images. Asynchronous: poll GET /v1/items/{id} until model.available is true. Fails with 402 insufficient_credits when the balance is too low, 409 conflict when the state does not allow it.

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- Item
  - `id` string, uuid
  - `title` string
  - `description` string, nullable
  - `status` 'draft' | 'analyzing' | 'awaiting_confirmation' | 'confirmed' | 'generating' | 'ready' | 'failed'
  - `visibility` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time, nullable
  - `dimensions_cm` object
    - `confirmed` object, nullable
    - `estimated` object, nullable
  - `model` object
    - `available` boolean
    - `sha256` string, nullable
  - `public` object
    - `published` boolean
    - `slug` string, nullable
    - `ar_url` string, uri, nullable
    - `embed_url` string, uri, nullable
  - `publishable` object: Row-level pre-check for POST /publish; POST /publish reports the exact resolver state on 409.
    - `ok` boolean
    - `blockers` string[]
  - `next_allowed_actions` string[]

## Other responses

- `401`: Error envelope
- `402`: Error envelope
- `403`: Error envelope
- `404`: Error envelope
- `409`: Error envelope
- `422`: Error envelope
- `429`: Error envelope

---

[API](https://skmtc.dev/pixeloa/apis/pixeloa-api.md) · [All operations](https://skmtc.dev/pixeloa/apis/pixeloa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pixeloa/apis/pixeloa-api/revisions/10a8178bed64?raw)