# NoCam API

> One key for AI photo, video and text models, by REST and MCP. Ask for a model by name: we pick the cheapest route that works, move to the next if it fails, and give the credits back if none can do it.

Base URL: `https://api.nocamclub.com/v1`. MCP: `https://mcp.nocamclub.com/mcp`. Auth: `Authorization: Bearer nc_live_…` spends credits, `nc_test_…` is a free sandbox with sample results. 1 credit = $0.01.

The flow: `GET /v1/models/{id}` gives a model's options (`input_schema`) and `prices`, so never guess them. `POST /v1/estimate` checks a request and prices it for free. `POST /v1/generations` with an `Idempotency-Key` starts it and charges. Photos: add `Prefer: wait=60`. Videos: poll `GET /v1/generations/{id}` every `poll_after_ms`. A failed generation gives its credits back by itself. Files in prompts are `img1`, `video1`, `audio1`. Result links last 7 days: download what you keep. Never top up on your own: send the person to `top_up_url`.

Read [For AI agents](https://docs.nocamclub.com/for-ai-agents.md) before anything else. Machine-readable: [OpenAPI 3.1](https://docs.nocamclub.com/openapi.json), [everything in one file](https://docs.nocamclub.com/llms-full.txt). Any page as Markdown: add `.md` to its address.

## Start here

- [NoCam API](https://docs.nocamclub.com/index.md): One key for AI photo, video and text models, by REST and MCP.
- [Quickstart](https://docs.nocamclub.com/quickstart.md): From a key to your first photo and video, in five minutes.
- [For AI agents](https://docs.nocamclub.com/for-ai-agents.md): Everything an AI agent needs to use this API without guessing. Hand this page to yours.

## Basics

- [Key concepts](https://docs.nocamclub.com/concepts.md): The few words you need to read everything else here.
- [Authentication](https://docs.nocamclub.com/authentication.md): One header on every call.
- [Sandbox](https://docs.nocamclub.com/sandbox.md): The whole API, for free, with sample results.
- [Content rules](https://docs.nocamclub.com/rules.md): What this API won't make, and what happens when a request asks for it.

## API

- [Generations](https://docs.nocamclub.com/api/generations.md): Start one, wait for it, read the result, cancel or delete it.
- [Models API](https://docs.nocamclub.com/api/models.md): What's on sale, which options each model takes, and what it costs.
- [Uploads](https://docs.nocamclub.com/api/uploads.md): Get your photos, videos and audio to a model.
- [Files in prompts](https://docs.nocamclub.com/api/files-in-prompts.md): How a prompt points at your photos, videos and audio.
- [Account](https://docs.nocamclub.com/api/account.md): Your balance and limits, as the key you're using sees them.
- [Idempotency](https://docs.nocamclub.com/api/idempotency.md): How to retry without paying twice.
- [Limits](https://docs.nocamclub.com/api/limits.md): How much, how fast, and what happens past it.
- [Errors](https://docs.nocamclub.com/errors.md): Every code the API can answer with, what it means and what to do.

## MCP

- [Connect through MCP](https://docs.nocamclub.com/mcp.md): Give Claude Code, Cursor and other agents the whole API as tools.
- [MCP tools](https://docs.nocamclub.com/mcp/tools.md): Every tool the MCP server gives an agent.

## Models

- [Choose a model](https://docs.nocamclub.com/models.md): Which model for which job, and every model on sale.
- [Nano Banana 2](https://docs.nocamclub.com/models/nano-banana-2.md): A strong all-rounder for photos, from text or from your own photos. Fast and cheap, up to 4K.
- [Nano Banana Pro](https://docs.nocamclub.com/models/nano-banana-pro.md): The same subject from different angles and in different places. Our choice for keeping a look across a series.
- [GPT Image 2.5 Flare](https://docs.nocamclub.com/models/gpt-image-2.5-flare.md): Portraits and clean compositions from your photos. Takes more photos at once than GPT Image 2.
- [GPT Image 2](https://docs.nocamclub.com/models/gpt-image-2.md): Anything with exact words on it: posters, signs, covers. Also strong from text alone.
- [Muse Video](https://docs.nocamclub.com/models/muse-video.md): A talking clip from one photo, nearly free. Always 10 seconds, always with sound.
- [GPT Image 2.5 Sunburst](https://docs.nocamclub.com/models/gpt-image-2.5-sunburst.md): Bold graphic results: stickers, icons, punchy compositions.
- [Grok Imagine](https://docs.nocamclub.com/models/grok-imagine.md): A photo from text alone, at the lowest price. Good for drafts and for many tries.
- [Grok Imagine Quality](https://docs.nocamclub.com/models/grok-imagine-quality.md): The better Grok, and it takes your photos.
- [Seedream 5.0 Flash](https://docs.nocamclub.com/models/seedream-5.0-flash.md): Cheap and quick, and it takes many reference photos at no extra cost. The price is the same at 1K and 2K.
- [Seedream 5.0 Pro](https://docs.nocamclub.com/models/seedream-5.0-pro.md): Seedream with more detail, when Flash isn't enough. The price follows the size.
- [Omni Flash](https://docs.nocamclub.com/models/omni-flash.md): A short clip with sound, from text or from up to 3 photos, at a very good price. With a video in, it changes that video.
- [Seedance 2.0 Fast](https://docs.nocamclub.com/models/seedance-2.0-fast.md): Seedance for less, up to 15 seconds. The usual choice when you don't need 1080p or longer clips.
- [Seedance 2.5](https://docs.nocamclub.com/models/seedance-2.5.md): Our strongest video model: up to 30 seconds and 1080p, with photos, videos and audio as references.
- [GPT-6 Luna](https://docs.nocamclub.com/models/gpt-6-luna.md): A quick, cheap text model that can look at photos. Good for drafting prompts, captions and short answers.
- [Claude Opus 5.5](https://docs.nocamclub.com/models/claude-opus-5.5.md): A strong text model for harder writing and reasoning.

## Guides

- [From a photo to a talking clip](https://docs.nocamclub.com/guides/photo-to-clip.md): Two calls. Make the picture you want, then make it speak.
- [The same character across many photos](https://docs.nocamclub.com/guides/same-character.md): How to keep a person or a mascot looking like themselves from shot to shot.

## More

- [Changelog](https://docs.nocamclub.com/changelog.md): What changed in the API.