---
title: "AI Content Drop Developer Documentation | AI Content Drop"
description: "API reference, authentication, MCP server, GraphQL schema, sandbox mode, rate limits, and error codes for AI Content Drop."
canonical: "https://aicontentdrop.com/docs"
source: "https://aicontentdrop.com/docs"
---

# AI Content Drop Developer Documentation

Everything an engineer or an agent needs to generate video and images on AI Content Drop from code.

## Start here

| Document | What it covers |
| --- | --- |
| [REST API reference](https://aicontentdrop.com/docs/api) | Every endpoint, request shape, and response shape on `/v1` |
| [Authentication](https://aicontentdrop.com/docs/authentication) | API keys, agent self-registration, and the discovery documents |
| [MCP server](https://aicontentdrop.com/docs/mcp) | The Model Context Protocol server, its tools, and its inline UI widgets |
| [GraphQL API](https://aicontentdrop.com/docs/graphql) | Schema, Relay pagination, typed errors, async jobs, SSE subscriptions, cost and deprecation policy |
| [Sandbox mode](https://aicontentdrop.com/docs/sandbox) | Rehearse a generation without spending credits |
| [Batch operations](https://aicontentdrop.com/docs/batch) | Quote or read many things in one request |
| [Rate limits](https://aicontentdrop.com/docs/rate-limits) | Limits, headers, and what a 429 tells you |
| [Errors](https://aicontentdrop.com/docs/errors) | Every error code across REST, GraphQL, and MCP |
| [Versioning and deprecation](https://aicontentdrop.com/docs/versioning) | What counts as a breaking change, and how retirement is signalled |
| [Pricing and credits](https://aicontentdrop.com/pricing.md) | Plans, credit allocations, and what each model costs |

## Machine-readable entry points

- [`/openapi.json`](https://aicontentdrop.com/openapi.json) — OpenAPI 3.1 for the JSON REST API
- [`/openapi-content.json`](https://aicontentdrop.com/openapi-content.json) — the unauthenticated content surface
- [`/graphql/schema.graphql`](https://aicontentdrop.com/graphql/schema.graphql) — GraphQL SDL; introspection is open at `POST /graphql`
- [`/.well-known/mcp.json`](https://aicontentdrop.com/.well-known/mcp.json) — MCP compatibility discovery manifest
- [`/.well-known/ai-catalog.json`](https://aicontentdrop.com/.well-known/ai-catalog.json) — ARD catalogue of every agentic resource we publish
- [`/.well-known/api-catalog`](https://aicontentdrop.com/.well-known/api-catalog) — RFC 9727 link set
- [`/llms.txt`](https://aicontentdrop.com/llms.txt) — curated site index; [`/developers/llms.txt`](https://aicontentdrop.com/developers/llms.txt) is the API-scoped version
- [`/skills/index.json`](https://aicontentdrop.com/skills/index.json) — six importable [Agent Skills](https://agentskills.io/specification), each served at `/skills/<name>/SKILL.md`
- [`/plugin.json`](https://aicontentdrop.com/plugin.json) — [Agent Plugins v1](https://agent-plugins.org/specification) manifest; its MCP servers are at [`/.well-known/agent-plugin-mcp.json`](https://aicontentdrop.com/.well-known/agent-plugin-mcp.json)
- [github.com/aicontentdrop/aicontentdrop](https://github.com/aicontentdrop/aicontentdrop) — official CLI and SDK source (TypeScript on [npm](https://www.npmjs.com/package/aicontentdrop), Python on [PyPI](https://pypi.org/project/aicontentdrop/)), and the agent plugin package (AGENTS.md, plugin.json, mcp.json, skills/)
- Append `.md` to any page URL for its markdown twin, or send `Accept: text/markdown`

## The shape of the product

Describe what you want, pick a model, get a video. 61 video models and 27 image models share one credit balance, at a flat credit cost per generation that is published up front. Credits are charged **only when a generation succeeds** — safety refusals, provider failures, and timeouts cost nothing, which is why there is no refund endpoint anywhere in this API.

Generation is submit-and-poll. A request returns a job id in about a second; the render takes one to four minutes; you poll until it is done. Nothing in this API blocks on a render.

## The five-minute version

```bash
# 1. Read the catalogue — no key needed
curl -s https://aicontentdrop.com/v1/models | head

# 2. Quote the cost before committing — still no key
curl -s "https://aicontentdrop.com/v1/models/kling_3_0/cost?quantity=4"

# 3. Rehearse the call for free
curl -sX POST https://aicontentdrop.com/v1/generate/video \
  -H "Content-Type: application/json" -H "X-Sandbox: true" \
  -d '{"prompt":"a cat surfing"}'

# 4. Do it for real
curl -sX POST https://aicontentdrop.com/v1/generate/video \
  -H "Authorization: Bearer acd_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"prompt":"a cat surfing","model":"kling_3_0"}'

# 5. Poll the Location header from step 4
curl -s https://aicontentdrop.com/v1/videos/<id> -H "Authorization: Bearer acd_live_…"
```

## Support

Questions go to [support@aicontentdrop.com](mailto:support@aicontentdrop.com) or the [contact page](https://aicontentdrop.com/contact).