Miniature Figurine

Miniature figurine API reference. Transform any photo into a 3D-printable miniature figurine. Supports humans, animals, and objects with full body or bust styles.

Create Miniature

POST

/v1/flow/miniature/

Transform any photo into a 3D miniature figurine. The input image is automatically restyled into a miniature or realistic figurine. You just provide the source photo. Works best with photos of a single subject shown in full (no cropping), without other people or cluttered backgrounds. Human subjects produce the best results. Costs 200 credits (fast) or 300 credits (default).

Request

curl -X POST https://api.3daistudio.com/v1/flow/miniature/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "data:image/png;base64,iVBOR...",
    "preset": "miniature_human_full_body",
    "edition": "default"
  }'

Response

{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-02-25T12:00:00Z"
}

Parameters

Parameter	Type	Required	Description
image	string	Yes	Base64-encoded source image (data:image/...;base64,...).
preset	string	Yes	Style preset for the output. See preset options below.
edition	string	No	"default" (higher quality, 300 credits) or "fast" (faster, 200 credits). Default: "default".

Examples

Upload a photo and receive a 3D miniature figurine. The style is applied automatically based on the selected preset.

3D miniature figurine of a construction worker

Presets

Choose a preset that matches your subject and desired output style. You can provide any photo regardless of angle, framing, or background. The preset automatically handles cropping, reframing, and styling to produce the best possible result for the selected subject type. For best results, use an image where the subject is fully visible.

Preset	Description
miniature_human_full_body	Stylized miniature figurine of a full-body human character.
miniature_human_bust	Stylized miniature bust (head and shoulders).
miniature_animal	Stylized miniature figurine of an animal.
miniature_object	Stylized miniature figurine of an object.
realistic_human_full_body	Realistic full-body human figurine.
realistic_human_bust	Realistic bust (head and shoulders).
realistic_animal	Realistic animal figurine.
realistic_object	Realistic object figurine.

Checking Status

GET

/v1/generation-request/<task_id>/status/

Poll this endpoint with the task_id from the submit response. When status is "FINISHED", the results array contains the styled image and the 3D model in multiple formats (GLB and OBJ ZIP). Progress updates at 33% and 66% before reaching 100%. Results expire after 24 hours.

Request

curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "status": "FINISHED",
  "progress": 100,
  "results": [
    {
      "asset_url": "https://cdn.3daistudio.com/images/styled_image.jpeg",
      "asset": "https://storage.3daistudio.com/assets/styled_image.jpeg",
      "asset_type": "EDITED_IMAGE",
      "thumbnail": "https://storage.3daistudio.com/thumbnails/styled_image.png"
    },
    {
      "asset_url": "https://cdn.3daistudio.com/models/figurine.glb",
      "asset": "https://storage.3daistudio.com/assets/figurine.glb",
      "asset_type": "3D_MODEL",
      "thumbnail": "https://storage.3daistudio.com/thumbnails/figurine.png"
    },
    {
      "asset_url": null,
      "asset": "https://storage.3daistudio.com/assets/figurine_obj.zip",
      "asset_type": "3D_MODEL",
      "thumbnail": null
    }
  ]
}

Credit Costs

Edition	Credits
fast	200
default	300

Processing Times

Fast mode typically takes 3–5 minutes. Default mode produces higher quality results and takes 5–8 minutes. We recommend polling the status endpoint every 10 seconds.

Errors

Common errors for the miniature flow.

Status	Error Code	Description
402	insufficient_credits	Not enough credits. Top up your wallet.
429	rate_limited	Rate limit exceeded. Wait and retry.
400	validation_failed	Missing or invalid parameters.