---
title: "Spend one credit and get the clean full-resolution file"
method: POST
path: "/collages/{id}/unlock"
tags: ["collages"]
---

# Spend one credit and get the clean full-resolution file

`POST /collages/{id}/unlock`

## Request

- Base URL: `https://api.collager.ai/v1`
- URL: `https://api.collager.ai/v1/collages/{id}/unlock`
- Auth: HTTP bearer

A repeated call returns the same result and charges nothing (credits_charged 0). Test keys get 403.

## Path parameters

- `id` string, required

## Response `200`

Unlocked. hd_url is set.

- Collage
  - `id` string, required
  - `object` 'collage', required
  - `status` 'queued' | 'processing' | 'preview_ready' | 'unlocked' | 'failed', required
  - `shape` string, nullable
  - `cells` integer, nullable
  - `photos_used` integer, nullable
  - `width` integer, nullable
  - `height` integer, nullable
  - `preview_url` string, uri, nullable: Watermarked preview (<= 1200 px). Link valid 24 h - every GET gives a fresh one.
  - `hd_url` string, uri, nullable: Clean full-resolution JPEG, after unlock. Link valid 24 h.
  - `credits_left` integer: Returned by unlock.
  - `credits_charged` integer: Returned by unlock - 1 the first time, 0 on repeats.
  - `error` JobError
    - `code` string, required
    - `message` string, required
  - `metadata` object
  - `created_at` string, date-time, required
  - `expires_at` string, date-time, required

## Other responses

- `402`: Error.
- `403`: Error.
- `409`: Error.

---

[API](https://skmtc.dev/collager/apis/collager-ai-photo-mosaic-photo-collage-api.md) · [All operations](https://skmtc.dev/collager/apis/collager-ai-photo-mosaic-photo-collage-api/llms.txt) · [OpenAPI document](https://skmtc.dev/collager/apis/collager-ai-photo-mosaic-photo-collage-api/revisions/719c6e7aaf09?raw)