ai-content-drop

aicontentdrop

AI Content Drop 的官方 CLI 和 TypeScript SDK — 可通过终端或代码，使用多个领先模型生成 AI 视频和图像。

无运行时依赖。可通过 npx 使用，无需安装；任何只读操作也无需 API 密钥。

npx aicontentdrop models --type video --max-credits 15

安装

npm install -g aicontentdrop    # CLI
npm install aicontentdrop       # SDK

Python 用户可以从 PyPI 安装同样无依赖的官方客户端：

pip install aicontentdrop

身份验证

读取模型目录、查询费用和提问无需凭据。生成内容需要 API 密钥，可在 Settings → Integrations 创建 — 任何账户均可使用，免费套餐包含 10 个点数。

export ACD_API_KEY=acd_live_…

每个密钥都可以设置每日点数上限，因此持有该密钥的 Agent 无法超出你设定的预算。

CLI

acd models --type video --max-credits 20     # catalogue with credit costs
acd cost kling_3_0 --quantity 4              # quote before committing
acd ask "which models generate audio?"       # natural-language lookup
acd me                                       # account and credit balance
acd generate "a golden retriever surfing at sunset" --model kling_3_0 --wait
acd status <video_id>
acd list --limit 20                          # cursor-paginated
acd list --all                               # follows the cursor for you
acd register --name my-agent                 # read-scoped agent token

每条命令默认输出 JSON，便于脚本和 Agent 解析；添加 --pretty 可供人类阅读。失败时会向 stderr 输出 JSON，并以非零状态码退出（2 表示失败，3 表示请求受限）。

预演任何会消耗点数的操作：

acd generate "…" --model kling_3_0 --sandbox   # no provider call, no credits

SDK

import { AiContentDrop } from "aicontentdrop";

const acd = new AiContentDrop({ apiKey: process.env.ACD_API_KEY });

const models = await acd.models({ type: "video", maxCredits: 20 });

// Submit and poll until the render exists. Sends an Idempotency-Key by default,
// so a retry after a dropped response cannot charge twice.
const video = await acd.generateVideoAndWait(
  { prompt: "a golden retriever surfing at sunset", aiModel: "kling_3_0" },
  { onProgress: (v) => console.error(v.status) },
);
console.log(video.video_url);

// Pagination handled for you
for await (const item of acd.allVideos()) {
  console.log(item.id, item.status);
}

错误会抛出 AcdError，其中包含 status、code，以及（状态码为 429 时的）retryAfter。

计费交接

计费使用独立的范围限定计费契约。 它不属于公共产品 MCP 工具或资源的范围。创建新的结账目前仅在已配置的计费沙盒部署中提供；不可用的目录条目以及尚未完成的订阅、历史记录和管理信息查询会返回明确的不可用响应。这些命令并不代表已具备生产环境支付能力。

在 Settings → Integrations 中创建密钥，并选择所需的各项权限： billing:read 用于查看状态和历史记录，billing:checkout 用于获取结账链接，billing:manage 用于访问门户。现有的 read/generate 密钥、OAuth 令牌和仅限目录的 acd_agent_ 令牌不会获得计费权限。生成点数上限不限制购买。

acd billing catalog
acd checkout plan --sku subscription:starter:s0:monthly --catalog-version VERSION_FROM_CATALOG --idempotency-key UNIQUE_PURCHASE_INTENT --confirm-purchase
acd checkout topup --sku topup:pack_150 --catalog-version VERSION_FROM_CATALOG --idempotency-key ANOTHER_PURCHASE_INTENT --confirm-purchase
acd billing status CHECKOUT_ID
acd billing status
acd billing history --limit 10
acd billing portal --idempotency-key UNIQUE_PORTAL_INTENT

结账需要由人类明确发起并接受目录条款。CLI 会打印所属的托管 URL 和状态 URL；人类需在浏览器中完成支付。重试同一意图时，请使用完全相同的幂等键和参数。--sandbox 标志仅模拟生成操作，不能用于计费写入；请改用已配置的计费沙盒主机，并传入 --base-url。

SDK 通过 billingCatalog、createBillingCheckout、billingCheckout、billingStatus、billingHistory 和 createBillingPortal 映射这些端点。调用 createBillingCheckout 时，请提供 catalogVersion、skuId、kind、idempotencyKey 和 returnTarget。SDK 和 CLI 都不会打开返回的 URL。

安装 Agent 技能

公共仓库在其根目录的 skills/ 目录中收录了十三项专门技能。请将该目录用作源，以便发现功能直接选择产品技能集合：

# Preview the product skills without installing anything
npx skills add aicontentdrop/aicontentdrop/skills --list

# Install one capability
npx skills add aicontentdrop/aicontentdrop/skills \
  --skill ai-video-model-picker

# Install the complete AI Content Drop set
npx skills add aicontentdrop/aicontentdrop/skills \
  --skill ai-video-model-picker \
  --skill video-prompt-writer \
  --skill image-generation \
  --skill batch-generation-runner \
  --skill api-error-handling \
  --skill credits-and-plans \
  --skill marketing-studio-ad \
  --skill canvas-board \
  --skill competitor-ad-research \
  --skill video-agent \
  --skill drama-studio \
  --skill short-drama-writer \
  --skill muse-connector

每项技能都可独立安装，触发范围明确：模型选择和费用查询、视频提示词、图像生成、批量执行、错误恢复、点数和套餐、成品广告、看板、竞品调研、视频 Agent、短剧，以及构建自有客户端的主机。请参阅技能目录了解功能概览。

面向 AI Agent

• MCP 服务：POST https://aicontentdrop.com/mcp（Streamable HTTP）——清单位于 /.well-known/mcp.json
• 仅限文档的 MCP：POST https://aicontentdrop.com/mcp/docs
• Agent 契约：/auth.md
• OpenAPI 3.1：/openapi.json
• 技能：skills/ ——模型选择、提示词编写、批量运行、 错误处理、额度、图像生成、成品广告、看板、竞品调研、视频 Agent 和短剧。也可按技能通过 https://aicontentdrop.com/skills/<name>/SKILL.md 获取，索引见 /skills/index.json
• Agent 插件：plugin.json + mcp.json （Agent Plugins v1.0.0）
• 本代码库的编码 Agent 规则：AGENTS.md

链接

文档 https://aicontentdrop.com/developers · TypeScript 注册表 https://www.npmjs.com/package/aicontentdrop · Python 注册表 https://pypi.org/project/aicontentdrop/ · 支持 [email protected]

采用 MIT 许可。