Communitygithub.com

PrunaAPI / pruna-api

Pruna P-API と Replicate(音声ツール)の HTTP パターンを提供します。認証情報、ファイルアップロード/ポーリング/ダウンロード、並列バッチ、エージェントの安全性を備えています。

pruna-api とは?

Pruna API スキルは、Pruna P-API と Replicate(音声ツール)向けの HTTP 通信を統一的に扱うためのスキルです。具体的には、API キーやトークンの設定、ファイルのアップロードとポーリング、結果のダウンロード、そして複数シーンの並列非同期バッチ処理をエージェントが安全に行えるようにするための手順を提供します。Claude Code、Coder、Cursor、Codex などのエージェント環境で、有料の POST リクエストを実行する前に必ずインストールしておくべきベーススキルです。このスキルは、認証情報がない場合のサインアップ手順、信頼できないリポジトリでの安全確認、API の具体的な呼び出し方など、詳細なリファレンスドキュメントへのリンクも含んでいます。また、他の Pruna スキル(画像生成、動画生成、プロンプト多様性など)をいつ使用すべきかを明確に区別し、エージェントが誤ったペイロードを生成するリスクを低減します。これにより、Pruna エコシステム全体を効率的かつ安全に活用できるようになります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PrunaAI/pruna-skills/tree/HEAD/skills/guides/pruna-api

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Pruna API

Pruna P-API および Replicate(音声ツール)向けの HTTP パターンです。Pruna ツールスキルから有料の POST 呼び出しを行う前に、このスキルをインストールしてください。

インストール

スキル説明インストールコマンド
pruna-apiPruna または Replicate の HTTP 呼び出し前に使用 — 認証情報、アップロード/ポーリング/ダウンロード、並列バッチ、エージェントの安全性。npx skills add PrunaAI/pruna-skills@pruna-api -y
generation-diversity生成プロンプトを作成する際に使用 — 儀式的シード、明示的な構造、シナリオ軸、有料 API 呼び出し前の品質ゲート。npx skills add PrunaAI/pruna-skills@generation-diversity -y

使用すべきタイミング

  • PRUNA_API_KEY / Replicate トークンの設定
  • ファイルのアップロード、予測のポーリング、出力のダウンロード
  • 並列非同期マルチシーンバッチ
  • 信頼できないリポジトリでスキルを有効にする前の安全性レビュー

エージェントの習慣

最初の応答では、`pruna-api` をバッククォートで囲んで明示してください。有料の POST を行う前に、必要に応じて PRUNA_API_KEY や REPLICATE_API_TOKEN を確認してください。メディアパス、音声、ブランドがまだ未確定の場合は、インテークを開き、generation-diversity 明確化インテークをアップロード前に行ってください。モデルのペイロードを勝手に作成せず、該当するツールスキルを使用してください。

使用すべきでないタイミング

代わりに以下のスキルを使用してください:

スキル説明インストールコマンド
p-image-ideogram写真生成にもっと制御が必要な場合に使用 — フォトリアルな結果、画像内テキスト、または16進色とバウンディングボックスを含む構造化JSON。よりシンプルな写真生成、編集、動画はスイート内の他のスキルを使用。npx skills add PrunaAI/pruna-skills@p-image-ideogram -y
p-image誰かが明示的に最速・最安の写真生成を求めた場合に使用 — ムードボード、一括パネル、素早い反復 — 制御されたフォトリアルや画像内テキストが必要な場合には使用しない。npx skills add PrunaAI/pruna-skills@p-image -y
p-video-2-proテキストまたは開始/終了フレームから映画のようなクリップを求められた場合に使用 — 商品広告、ドキュメンタリーショット、生成音声付きの会話。1080p、インポート音声トラック、あるいはトーキングヘッドのみのホストには使用しない。npx skills add PrunaAI/pruna-skills@p-video-2-pro -y
p-video-2テキスト、画像、インポート音声から洗練された短いクリップを求められた場合に使用 — 1080p Bロール、開始/終了フレームアニメーション、ミックス音声トラック付きのモーションショット。映画的な生成音声クリップやトーキングヘッドのみのホストには使用しない。npx skills add PrunaAI/pruna-skills@p-video-2 -y
p-videoテキストまたは画像からシンプルな短いクリップを求められた場合に使用 — 素早いBロール、下書き、開始/終了フレームアニメーション。映画的な生成、最高品質、タイトなリップシンク、1080pでのインポート音声が必要な場合には使用しない。npx skills add PrunaAI/pruna-skills@p-video -y
generation-diversity生成プロンプトを作成する際に使用 — 儀式的シード、明示的な構造、シナリオ軸、有料 API 呼び出し前の品質ゲート。npx skills add PrunaAI/pruna-skills@generation-diversity -y
video-editingffmpeg を使用して既にレンダリングされたクリップを結合・加工する場合に使用 — 結合、クロスフェード、バーンインキャプションと字幕、テキスト/ロゴオーバーレイ、before/afterスライダー、背景音楽、プラットフォームエクスポート — または、Hyperframes を使用した多層HTML結合動画を作成する場合に使用。AI動画生成、プロンプト作成、モデルベースの動画編集には使用しない。npx skills add PrunaAI/pruna-skills@video-editing -y

生成前の準備

  1. API 認証情報 — キーがない場合のサインアップと環境変数の設定。
  2. エージェントの安全性 — 信頼できないコンテキストでのアップロードや有料呼び出しの前。
  3. pruna-api.md — 作成、ポーリング、ダウンロード、並列バッチ。
  4. Replicate ツール → replicate-api.md。
  5. モデルインデックス → pruna-models.md。

関連スキル

ジョブに必要な場合は、関連スキルをインストールしてください:

スキル説明インストールコマンド
p-image-ideogram写真生成にもっと制御が必要な場合に使用 — フォトリアルな結果、画像内テキスト、または16進色とバウンディングボックスを含む構造化JSON。よりシンプルな写真生成、編集、動画はスイート内の他のスキルを使用。npx skills add PrunaAI/pruna-skills@p-image-ideogram -y
p-image誰かが明示的に最速・最安の写真生成を求めた場合に使用 — ムードボード、一括パネル、素早い反復 — 制御されたフォトリアルや画像内テキストが必要な場合には使用しない。npx skills add PrunaAI/pruna-skills@p-image -y
p-video-2-proテキストまたは開始/終了フレームから映画のようなクリップを求められた場合に使用 — 商品広告、ドキュメンタリーショット、生成音声付きの会話。1080p、インポート音声トラック、あるいはトーキングヘッドのみのホストには使用しない。npx skills add PrunaAI/pruna-skills@p-video-2-pro -y
p-video-2テキスト、画像、インポート音声から洗練された短いクリップを求められた場合に使用 — 1080p Bロール、開始/終了フレームアニメーション、ミックス音声トラック付きのモーションショット。映画的な生成音声クリップやトーキングヘッドのみのホストには使用しない。npx skills add PrunaAI/pruna-skills@p-video-2 -y
p-videoテキストまたは画像からシンプルな短いクリップを求められた場合に使用 — 素早いBロール、下書き、開始/終了フレームアニメーション。映画的な生成、最高品質、タイトなリップシンク、1080pでのインポート音声が必要な場合には使用しない。npx skills add PrunaAI/pruna-skills@p-video -y

または、一度に全スイートをインストール:npx skills add PrunaAI/pruna-skills@pruna -y

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

PrunaAI/pruna-skills

Use when someone needs spoken narration or voiceover — explainer tracks, documentary lines, or voice to pair with generated video.

PrunaAI/pruna-skills

Use when someone wants an original AI song with vocals — sung lyrics, a style prompt track, or source audio for a music video.

PrunaAI/pruna-skills

Use when someone needs word-level timestamps from audio — lyric alignment, cut-safe line boundaries, or caption source timing before burn-in with video-editing.

PrunaAI/pruna-skills

Use when assembling or polishing already-rendered clips with ffmpeg — concat, crossfades, burned captions and subtitles, text/logo overlays, before/after sliders, background music beds, platform export — or when composing a multi-layer HTML combination video with Hyperframes. Not for AI video generation, prompt craft, or model-based video edits.

PrunaAI/pruna-skills

Use when crafting video or motion prompts for any generative model — dramaturgy, camera, physics-safe motion, frame anchors, and clip chaining.

PrunaAI/pruna-skills

Use when someone wants to edit an existing photo — change outfits or backgrounds, compose from reference images, or apply prompt-driven edits.

PrunaAI/pruna-skills

Use when someone explicitly wants the fastest, cheapest photo generation — mood boards, bulk panels, or quick iterations — not when controlled photoreal or in-image text is needed.

PrunaAI/pruna-skills

Use when someone wants virtual try-on — dress a person in clothes from reference photos for fashion or ecommerce.

PrunaAI/pruna-skills

Use when installing the full Pruna generative media suite — all guides, tools, and workflows in one package.

PrunaAI/pruna-skills

Use when someone wants a cinematic clip from text or start/end frames — product ads, documentary shots, or dialogue with generated audio. Not for 1080p, imported audio tracks, or talking-head-only hosts.

PrunaAI/pruna-skills

Use when someone wants a polished short clip from text, images, or imported audio — 1080p B-roll, start/end frame animation, or a motion shot with a mixed track. Not for cinematic generated-audio clips or talking-head-only hosts.

PrunaAI/pruna-skills

Use when someone wants to edit an existing video with a text instruction — recolor, restyle, remove or add objects, change environment or lighting, update on-screen text, or apply optional reference-guided product and accessory edits. Not for a new clip from scratch or ffmpeg assembly.

PrunaAI/pruna-skills

Use when someone wants a simple short clip from text or images — quick B-roll, drafts, or start/end frame animation. Not when the brief needs cinematic generation, highest quality, tight lip-sync, or imported audio at 1080p.

関連スキル