> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cherryshot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Shot API

> Generate studio-quality product photography and video ads programmatically — from your backend, a workflow, or directly from Claude.

The Cherry Shot API turns a product photo into professional shots — with or without an AI
model — and into short video ads. It's the same generation engine behind the Cherry Shot
app, exposed as a simple REST API and an [MCP server](/guides/mcp) you can plug into Claude,
Cursor, or any agent.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Make your first shoot in a couple of minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Create an API key and send it with every request.
  </Card>

  <Card title="Use from Claude (MCP)" icon="robot" href="/guides/mcp">
    Add Cherry Shot as an MCP server and generate by chatting.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Every endpoint, parameter, and response.
  </Card>
</CardGroup>

## How it works

Generation is **asynchronous**. You create a job and receive an `id`, then poll that job
until its `status` is `completed`.

<Steps>
  <Step title="Create">
    `POST /v1/shoots` (or `/v1/videos`) with your inputs. You get back an `id` and the
    credits reserved.
  </Step>

  <Step title="Poll">
    `GET /v1/shoots/{id}` every few seconds until `status` is `completed`.
  </Step>

  <Step title="Use the result">
    Read the returned image or video URLs. Feed shoot images straight into a video.
  </Step>
</Steps>

## Base URL

```
https://ybhqmgyprapjxomdxifs.supabase.co/functions/v1/api
```

<Note>
  This is the current **staging** base URL. A stable production domain (e.g.
  `https://api.cherryshot.ai`) will replace it — the paths and payloads stay the same.
</Note>

## Credits

Every account has a credit balance shared with the app. Images cost **1** credit
(standard), **2** (pro / 2K), or **4** (4K) each; videos scale with resolution and
duration. Check your balance any time with `GET /v1/credits`.