Communitygithub.com

PrunaAPI/Pruna技巧

在所有 Pruna 或 Replicate HTTP 呼叫之前使用 — 處理憑證、上傳/輪詢/下載、平行批次及代理安全性。

Pruna技巧 是什麼?

這是一個基礎架構級的 AI 代理技巧,專為與 Pruna P-API 和 Replicate(音訊工具)互動而設計。它負責處理所有底層 HTTP 通訊模式,包括憑證設定(`PRUNA_API_KEY`、`REPLICATE_API_TOKEN`)、檔案上傳、任務輪詢與結果下載,以及平行非同步批次處理。此技巧還整合了代理安全審查機制,確保在不受信任的環境中執行付費 API 呼叫前進行風險評估。由於它與許多下游生成技巧(如 `p-image`、`p-video` 等)配合使用,開發者應在所有付費 `POST` 請求之前安裝此技巧,以確保憑證與流程正確。此外,它也建議在需要提示詞多樣性時先使用 `generation-diversity` 技巧進行結構化提示設計,避免無謂的 API 消耗。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PrunaAI/pruna-skills/tree/HEAD/skills/guides/pruna-api

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Pruna API

HTTP 模式,用於 Pruna P-API 與 Replicate(音訊工具)。在呼叫 Pruna 工具技巧的付費 POST 前請先安裝此技巧。

安裝

技巧說明安裝指令
pruna-api在所有 Pruna 或 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 token
  • 上傳檔案、輪詢預測結果、下載輸出
  • 平行非同步多場景批次處理
  • 在不受信任的儲存庫中啟用技巧前的安全審查

代理習慣

在第一個回覆中,用反引號標註 `pruna-api`。在任何付費 POST 之前,確認 PRUNA_API_KEY 及/或 REPLICATE_API_TOKEN 是否已設定。如果媒體路徑、語音或品牌尚未確定,請先開啟 intake → 在上傳前進行 generation-diversity 釐清 intake。請勿自行發明模型 payload — 請使用對應的工具技巧。

何時不該使用

請改用以下技巧:

技巧說明安裝指令
p-image-ideogram當照片生成需要更多控制時使用 — 逼真結果、圖片內文字,或含十六進位顏色與邊界框的結構化 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-roll、開始/結束影格動畫或含混合音軌的動態鏡頭。不適用於電影級生成音訊短片或僅有主播人頭。npx skills add PrunaAI/pruna-skills@p-video-2 -y
p-video當有人想要從文字或圖片生成簡單短片時使用 — 快速 B-roll、草稿或開始/結束影格動畫。不需要電影級生成、最高品質、精準唇形同步或匯入 1080p 音軌時請勿使用。npx skills add PrunaAI/pruna-skills@p-video -y
generation-diversity在撰寫任何生成式提示詞時使用 — 儀式性種子、明確結構、情境軸線及付費 API 呼叫前的品質把關。npx skills add PrunaAI/pruna-skills@generation-diversity -y
video-editing當使用 ffmpeg 組合或打磨已渲染的片段時使用 — 串接、淡入淡出、燒錄字幕與隱藏式字幕、文字/標誌疊加、前後對比滑桿、背景音樂、平台匯出 — 或使用 Hyperframes 組合多層 HTML 複合影片。不適用於 AI 影片生成、提示詞設計或基於模型的影片編輯。npx skills add PrunaAI/pruna-skills@video-editing -y

生成前準備

  1. API 憑證 — 註冊及缺少 key 時的環境變數設定。
  2. 代理安全性 — 在不受信任的環境中上傳或進行付費呼叫前的安全審查。
  3. pruna-api.md — 建立、輪詢、下載、平行批次。
  4. Replicate 工具 → replicate-api.md。
  5. 模型索引 → pruna-models.md。

相關技巧

當工作需求來臨時,安裝相關技巧:

技巧說明安裝指令
p-image-ideogram當照片生成需要更多控制時使用 — 逼真結果、圖片內文字,或含十六進位顏色與邊界框的結構化 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-roll、開始/結束影格動畫或含混合音軌的動態鏡頭。不適用於電影級生成音訊短片或僅有主播人頭。npx skills add PrunaAI/pruna-skills@p-video-2 -y
p-video當有人想要從文字或圖片生成簡單短片時使用 — 快速 B-roll、草稿或開始/結束影格動畫。不需要電影級生成、最高品質、精準唇形同步或匯入 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.

相關技能