Quickstart
Make your first shoot in a couple of minutes.
Authentication
Create an API key and send it with every request.
Use from Claude (MCP)
Add Cherry Shot as an MCP server and generate by chatting.
API Reference
Every endpoint, parameter, and response.
How it works
Generation is asynchronous. You create a job and receive anid, then poll that job
until its status is completed.
1
Create
POST /v1/shoots (or /v1/videos) with your inputs. You get back an id and the
credits reserved.2
Poll
GET /v1/shoots/{id} every few seconds until status is completed.3
Use the result
Read the returned image or video URLs. Feed shoot images straight into a video.
Base URL
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.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 withGET /v1/credits.