---
title: "Queue an AI photo set of a product"
method: POST
path: "/photos"
---

# Queue an AI photo set of a product

`POST /photos`

## Request

- Base URL: `https://app.cartviral.com/api/v1`
- URL: `https://app.cartviral.com/api/v1/photos`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://app.cartviral.com/oauth/authorize`, token URL `https://app.cartviral.com/oauth/token`, scopes: `mcp`)

Queue a set of AI photos for one catalog product. Formats and credit cost: photo_model (9, a photoshoot with an AI model wearing or using the product), photo_product (8, clean studio and lifestyle product shots), photo_infographic (7, a labelled infographic built only from the product's real facts, needs enough facts on the product page). A set renders in a few minutes; every image comes in a square (2000x2000) and a portrait (1080x1350) size, plus a zip of the whole set. Credits are charged from the account; a failed set refunds automatically. Poll list_photo_sets for download links.

## Request body

- object
  - `product_id` string, required: Product id from list_products
  - `format` 'photo_model' | 'photo_tryon' | 'photo_product' | 'photo_infographic', required

## Response `200`

Success

- object

## Other responses

- `400`: Invalid input or the action could not be done; body has an error message
- `401`: Missing or invalid credentials
- `429`: Rate limit: 120 calls per minute per key

---

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