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 キーが必要です。どのアカウントでも利用でき、無料プランには 10 クレジットが含まれます。

export ACD_API_KEY=acd_live_…

各キーには 1 日あたりのクレジット上限を設定できるため、そのキーを持つエージェントが設定した予算を超えて利用することはありません。

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 を出力します。人間が読みやすい形式にするには --pretty を追加してください。失敗時は JSON を stderr に出力し、ゼロ以外の終了コードで終了します（失敗は 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 ツールまたはリソースの対象には含まれません。新しいチェックアウトの作成は、当初、請求用に設定されたサンドボックスデプロイでのみ利用できます。利用できないカタログ項目や、未完成のサブスクリプション／履歴／管理情報の取得機能は、明示的な利用不可の応答を返します。これらのコマンドによって、本番環境で決済可能になったことが保証されるわけではありません。

設定 → インテグレーションでキーを作成し、必要な権限をそれぞれ選択してください。ステータス／履歴には 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 を開くことはありません。

エージェントスキルのインストール

公開リポジトリのルートにある skills/ ディレクトリには、目的別に絞った 13 個のスキルが収録されています。検出時にプロダクトのスキルコレクションが直接選択されるよう、このディレクトリをソースとして使用してください。

# 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

各スキルは個別にインストールでき、トリガーの範囲も絞られています。モデルの選択と見積もり、動画のプロンプト作成、画像生成、バッチ実行、エラーからの復旧、クレジットとプラン、完成した広告、ボード、競合調査、動画エージェント、ショートドラマ、独自のクライアントを構築するホストが対象です。機能の一覧はスキルカタログをご覧ください。

AI エージェント向け

• MCP サーバー：POST https://aicontentdrop.com/mcp（ストリーミング可能な HTTP）— マニフェスト は /.well-known/mcp.json にあります
• ドキュメント専用 MCP：POST https://aicontentdrop.com/mcp/docs
• エージェントの契約：/auth.md
• OpenAPI 3.1：/openapi.json
• スキル：skills/ — モデルの選択、プロンプトの作成、バッチ実行、 エラー処理、クレジット、画像生成、完成した広告、ボード、競合調査、 動画エージェント、ショートドラマ。また、各スキルは https://aicontentdrop.com/skills/<name>/SKILL.md で個別に提供され、 /skills/index.json に一覧があります
• エージェントプラグイン：plugin.json + mcp.json （Agent Plugins v1.0.0）
• このリポジトリのコーディングエージェント向けルール：AGENTS.md

リンク

ドキュメント https://aicontentdrop.com/developers · TypeScript レジストリ https://www.npmjs.com/package/aicontentdrop · Python レジストリ https://pypi.org/project/aicontentdrop/ · サポート [email protected]

MIT ライセンス。