API Reference

The Qamera AI API lets you integrate product photography generation directly into your applications and workflows. You can manage products, trigger content generation, and retrieve results without using the web interface.

Base URL

All API requests use the following base URL:

https://app.qamera.ai

If you are running a self-hosted deployment, replace this with your own deployment URL.

Quick Start

1. Get an API Key

Navigate to Settings → API Keys in your team workspace and generate a new key. Your key will look like this:

mk_live_abc123.secretvalue

Copy it immediately — the secret portion is only shown once.

2. Make Your First Request

Fetch your product catalog:

curl -X GET https://app.qamera.ai/api/external/products \
  -H "X-Api-Key: mk_live_abc123.secretvalue"

A successful response returns a JSON array of your products.

Available Endpoints

The API is organized into the following resource groups:

• Products — List and retrieve products in your catalog.
• Packshots — Generate clean product images on white or custom backgrounds.
• Photo Shoots — Create lifestyle photography with AI-generated scenes and models.
• Videos — Produce short video reels from your product photos.
• Styles — List and retrieve reusable visual presets.
• Orders — Track content generation orders and their status.
• Jobs — Monitor individual generation jobs within an order.

GET endpoints are free and do not consume credits. POST endpoints that trigger content generation consume credits based on your pricing plan.

Authentication

All requests require an API key. You can pass it using either the X-Api-Key header or the Authorization: Bearer header. See the Authentication page for full details on key format, scopes, and security.

Next Steps

• Authentication — Key format, scopes, and security best practices.
• Rate Limiting — Request limits and retry strategies.
• Error Codes — HTTP status codes and error response format.
• Credits — How credit reservation and consumption work.