---
title: "Mockups"
url: https://docs.light-ai.app/api-reference/mockups.md
canonical_url: https://docs.light-ai.app/api-reference/mockups
last_updated: 2026-10-13
summary: "Lighting mockups generated with Light AI Gen 3.0 (`light-ai-gen-3.0`), exactly as in the app: 5 credits per image from the contractor's own credits (402 `insufficient_credits` with the credits required and a top-up link when short, plus the"
api_status: beta
related:
  - https://docs.light-ai.app/api-reference
---

# Mockups

> Lighting mockups generated with Light AI Gen 3.0 (`light-ai-gen-3.0`), exactly as in the app: 5 credits per image from the contractor's own credits (402 `insufficient_credits` with the credits required and a top-up link when short, plus the

Lighting mockups generated with Light AI Gen 3.0 (`light-ai-gen-3.0`), exactly as in the app: 5 credits per image from the contractor's own credits (402 `insufficient_credits` with the credits required and a top-up link when short, plus the balance for organization keys only; a failed image is refunded), results saved to the project's mockup history. Generation is asynchronous: create returns 202 with a `mgen_…` operation; poll GET /v1/mockup_generations/{id} or subscribe to mockup.completed / mockup.failed. Test keys simulate a generation (a sample image; no credits).

- `POST /v1/projects/{project_id}/photo_uploads`: [Create a photo upload](https://docs.light-ai.app/api-reference/mockups/create-photo-upload.md)
- `POST /v1/projects/{project_id}/mockups`: [Generate mockups](https://docs.light-ai.app/api-reference/mockups/create-mockup-generation.md)
- `GET /v1/mockup_generations/{mockup_generation_id}`: [Retrieve a mockup generation](https://docs.light-ai.app/api-reference/mockups/get-mockup-generation.md)