{
  "markdown": "# aicontentdrop\n\nOfficial CLI and TypeScript SDK for [AI Content Drop](https://aicontentdrop.com) —\ngenerate AI video and images across 35+ models from the terminal or from code.\n\nNo runtime dependencies. Works with `npx`, no install and no API key for\nanything read-only.\n\n```bash\nnpx aicontentdrop models --type video --max-credits 15\n```\n\n## Install\n\n```bash\nnpm install -g aicontentdrop    # CLI\nnpm install aicontentdrop       # SDK\n```\n\n## Authentication\n\nReading the model catalogue, quoting costs, and asking questions need **no\ncredential**. Generating needs an API key you create at\n[Settings → Integrations](https://aicontentdrop.com/settings/integrations) — any\naccount works, the free tier includes 10 credits.\n\n```bash\nexport ACD_API_KEY=acd_live_…\n```\n\nEach key can carry a daily credit ceiling, so an agent holding it cannot\noverspend the budget you set.\n\n## CLI\n\n```bash\nacd models --type video --max-credits 20     # catalogue with credit costs\nacd cost kling_3_0 --quantity 4              # quote before committing\nacd ask \"which models generate audio?\"       # natural-language lookup\nacd me                                       # account and credit balance\nacd generate \"a golden retriever surfing at sunset\" --model kling_3_0 --wait\nacd status <video_id>\nacd list --limit 20                          # cursor-paginated\nacd list --all                               # follows the cursor for you\nacd register --name my-agent                 # read-scoped agent token\n```\n\nEvery command prints JSON by default so scripts and agents can parse it; add\n`--pretty` for humans. Failures print JSON to stderr and exit non-zero (`2`\nfailure, `3` rate limited).\n\nRehearse anything that would cost credits:\n\n```bash\nacd generate \"…\" --model kling_3_0 --sandbox   # no provider call, no credits\n```\n\n## SDK\n\n```ts\nimport { AiContentDrop } from \"aicontentdrop\";\n\nconst acd = new AiContentDrop({ apiKey: process.env.ACD_API_KEY });\n\nconst models = await acd.models({ type: \"video\", maxCredits: 20 });\n\n// Submit and poll until the render exists. Sends an Idempotency-Key by default,\n// so a retry after a dropped response cannot charge twice.\nconst video = await acd.generateVideoAndWait(\n  { prompt: \"a golden retriever surfing at sunset\", aiModel: \"kling_3_0\" },\n  { onProgress: (v) => console.error(v.status) },\n);\nconsole.log(video.video_url);\n\n// Pagination handled for you\nfor await (const item of acd.allVideos()) {\n  console.log(item.id, item.status);\n}\n```\n\nErrors throw `AcdError` with `status`, `code`, and `retryAfter` (on 429).\n\n## For AI agents\n\n- MCP server: `POST https://aicontentdrop.com/mcp` (Streamable HTTP) — manifest\n  at [`/.well-known/mcp.json`](https://aicontentdrop.com/.well-known/mcp.json)\n- Docs-only MCP: `POST https://aicontentdrop.com/mcp/docs`\n- Agent contract: [`/auth.md`](https://aicontentdrop.com/auth.md)\n- OpenAPI 3.1: [`/openapi.json`](https://aicontentdrop.com/openapi.json)\n- Python SDK: [`python/`](./python) — same API surface, zero runtime\n  dependencies, on [PyPI](https://pypi.org/project/aicontentdrop/) as\n  `aicontentdrop` (`pip install aicontentdrop`)\n- Go SDK: [`go/`](./go) — same API surface, standard library only,\n  `go get github.com/aicontentdrop/aicontentdrop/go`\n- Skills: [`skills/`](./skills) — model selection, prompt writing, batch runs,\n  error handling, credits, image generation. Also served per skill at\n  `https://aicontentdrop.com/skills/<name>/SKILL.md`, indexed at\n  [`/skills/index.json`](https://aicontentdrop.com/skills/index.json)\n- Agent plugin: [`plugin.json`](./plugin.json) + [`mcp.json`](./mcp.json)\n  (Agent Plugins v1.0.0)\n- Coding-agent rules for this repo: [`AGENTS.md`](./AGENTS.md)\n\n## Links\n\nDocumentation <https://aicontentdrop.com/developers> ·\nSupport <support@aicontentdrop.com>\n\nMIT licensed.\n",
  "bytes": 3794,
  "sha": "246c40a2d52fe2b6354090acab6fdcb0182347979b59f95b3cf829d8f847b277",
  "repo_slug": "aicontentdrop/aicontentdrop",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_aicontentdrop_ai_content_drop_f242052f/readme"
}