arcads-external-api

arcads-external-api is a skill for Claude Code, Codex from krusemediallc/arcads-claude-code. It costs 133 tokens per session (9,053 once invoked), scanned A, original, MIT.

A guide and API workflow for creating and retrieving AI-generated video and image assets through Arcads. An API is a service that software can call to request work and receive results.

In plain words
What is it for?
Use it for Arcads video, image, b-roll, scene, script, and actor workflows, including requests involving Seedance, Sora, Veo, Kling, Grok Video, or Nano Banana.
Why use it?
It provides a defined way to authenticate, submit requests, poll for completed assets, and handle missing or rejected credentials. It also sets rules for keeping API keys out of code and chat.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it for Arcads video, image, b-roll, scene, script, and actor workflows, including requests involving Seedance, Sora, Veo, Kling, Grok Video, or Nano Banana.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/krusemediallc/arcads-claude-code/arcads-external-api
About the project

Arcads AI Video is an agent skill pack and prompting workspace for creating marketing videos and images through an Arcads account. Claude Code and Cursor users use it to produce advertising creative with Arcads' video, image, audio, and template tools. The catalogue entries provide the skills, instructions, hook, setting, and rule that support this workflow.

krusemediallc/arcads-claude-code · 1,480 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add krusemediallc/arcads-claude-code --skill arcads-external-api
Clone the repo
git clone --depth 1 https://github.com/krusemediallc/arcads-claude-code

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for arcads-external-api

README.md
[![agentmods](https://agentmods.dev/badge/skills/krusemediallc/arcads-claude-code/arcads-external-api.svg)](https://agentmods.dev/skills/krusemediallc/arcads-claude-code/arcads-external-api)
Your own site
<a href="https://agentmods.dev/skills/krusemediallc/arcads-claude-code/arcads-external-api"><img src="https://agentmods.dev/badge/skills/krusemediallc/arcads-claude-code/arcads-external-api.svg" alt="Measured on agentmods" height="20"></a>
Per session 133 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 9,053 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 2 findings, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium MCP Rug Pull · line 61
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium Excessive Agency · line 153
    Skill enables autonomous high-impact decisions without human-in-the-loop verification. Critical operations (destructive commands, financial transactions, data deletion) should require explicit user confirmation.
    Fix: Add human-in-the-loop confirmation for destructive, irreversible, or high-impact operations. Never auto-execute commands that modify files, send data, or alter system state.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00133 $0.09053
Opus 5 $0.00067 $0.04526
Sonnet 5 $0.00027 $0.01811
Haiku 4.5 $0.00013 $0.00905

Measured 8d ago against content hash dc2e826cba69, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

arcads-external-api scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (prompting/analyze-video/scripts/extract-frames.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- **Auth:** HTTP Basic — use `ARCADS_API_KEY` as the **username** and an **empty password** unless Arcads documentation for your key specifies otherwise. Example curl: `curl -u "$ARCADS_API_KEY:" "$ARCADS_BASE_URL/v1/pro
Origin

Copies of this mod

1 near-identical copy found in the catalogue:

skills/arcads-external-api/SKILL.md · 335 lines

How it starts

The opening of the file, as written. The whole thing — 335 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Arcads external API

Configuration

  • Base URL: https://external-api.arcads.ai (or ARCADS_BASE_URL).
  • Auth: HTTP Basic — use ARCADS_API_KEY as the username and an empty password unless Arcads documentation for your key specifies otherwise. Example curl: curl -u "$ARCADS_API_KEY:" "$ARCADS_BASE_URL/v1/products".
  • Never print API keys, commit .env, or paste keys into MASTER_CONTEXT.md.

If the key is missing or the API returns 401/403

  1. Editor-first (default): Ensure .env exists (copy from .env.example in the repo root). Ask the user to paste ARCADS_API_KEY only inside .env and save. Do not ask them to paste the key in chat unless they insist.
  2. Chat-assisted: If they paste the key in chat, write .env for them, confirm "saved to .env" without repeating the key, and remind them that chat history may retain secrets—rotate the key in Arcads if the chat could be shared.

Before the first call, confirm .gitignore excludes .env.

Signup link (affiliate)

If the user doesn't have an Arcads account yet — at any point during a session, in any context — link them to https://arcads.ai/?via=claude-code (NOT the bare arcads.ai URL). This is the repo owner's referral / affiliate link. Use this exact URL in any "sign up" / "create an account" prompt.

Read order

  1. Repo root MASTER_CONTEXT.md when present (brand voice, decisions, quirks).
  2. This skill's reference.md for routes, bodies, polling.
  3. prompting/guide.md then the right prompting/prompt-library/ file for the model (see table below).

Decision tree: which flow?

All video models use POST /v2/videos/generate with the appropriate model value (see reference.md for the full CreateVideoDto schema).

User goal Start here Prompt library
Seedance 2.0 UGC video — selfie-style product review / testimonial POST /v2/videos/generate with model: "seedance-2.0" seedance-2.md (platform guide) + seedance-2-ugc.md (9-layer UGC formula)
Seedance 2.0 premium product reveal — dark-void, no person, text narrative POST /v2/videos/generate with model: "seedance-2.0" seedance-2.md + seedance-2-premium-reveal.md
Seedance 2.0 product hero — elemental effects, no person, splash/mist POST /v2/videos/generate with model: "seedance-2.0" seedance-2.md + seedance-2-product-hero.md
Seedance 2.0 studio lookbook — polished, voiceover, multi-look POST /v2/videos/generate with model: "seedance-2.0" seedance-2.md + seedance-2-studio-lookbook.md
Seedance 2.0 feature walkthrough — fast-paced feature demo POST /v2/videos/generate with model: "seedance-2.0" seedance-2.md + seedance-2-feature-walkthrough.md
Reverse-engineer a video style into a reusable Seedance 2.0 template Follow the analyze-video skill prompting/analyze-video/SKILL.md
Clone/replicate an existing video ad for a different product Follow the clone-ad skill prompting/clone-ad/SKILL.md
Raw Sora 2 video from text (plus product) POST /v2/videos/generate with model: "sora2" prompt-library/sora-2.md
Sora remix of an existing asset POST /v1/sora2/remix/video sora-2.md
Veo 3.1 video POST /v2/videos/generate with model: "veo31" prompt-library/veo-3-1.md
Kling 3.0 video POST /v2/videos/generate with model: "kling-3.0" kling-3.md
Grok Video POST /v2/videos/generate with model: "grok-video" See reference.md for fields
Nano Banana still image (standalone or as starting frame for video) POST /v2/images/generate with "model":"nano-banana-2" by default; optional "model":"nano-banana" (Nano Banana Pro) nano-banana.md
B-roll clip (product-level) POST /v1/b-roll kling-3.md or nano-banana.md for craft; see reference.md for Kling/Nano routing notes
Scene generation POST /v1/scene Same as b-roll row
Recreate an influencer from a reference photo Two-step: (1) POST /v2/images/generate with refImageAsBase64 to generate a still image via Nano Banana, get user approval; (2) upload approved still → POST /v2/videos/generate with model: "veo31" and startFrame for video. Never skip the approval step. prompt-library/influencer-recreation.md
Product showcase — AI person holds/uses a product and talks about it Two-step: (1) POST /v2/images/generate with product refImageAsBase64; (2) user approves still; (3) start-frame → video via POST /v2/videos/generate. prompt-library/product-showcase.md
UGC / selfie-style (authentic reels, cross-model) Any video model via POST /v2/videos/generate prompt-library/ugc-selfie-style.md — cross-model UGC guide. For Seedance 2.0 specifically, use seedance-2-ugc.md instead.
Create a new AI influencer from text (character sheet — Nano Banana, default) Two-pass: (1) hero portrait via POST /v2/images/generate with model: "nano-banana-2" or "nano-banana" (Pro), get approval; (2) 9 angles with hero as referenceImages (up to 14 refs). Save to references/influencers/. prompt-library/character-sheet.md
Create a new AI influencer from text (character sheet — ChatGPT Image 2) Same two-pass flow but with model: "gpt-image-2". Capped at 5 referenceImages, so angles 6+ use hero + 4 most-recent angles as refs. Pick this for stylized / editorial aesthetic; the Nano Banana version is the default for pure photoreal. prompt-library/character-sheet-gpt-image-2.md
UGC product selfie — AI influencer holding a product Combine character hero + product photo + style references as referenceImages. prompt-library/ugc-product-selfie.md
Pixar-style 3D animated ad — anthropomorphized cartoon ad with mascot beats Multi-step: (1) Lock cast sheet; (2) ChatGPT Image 2 storyboard stills via POST /v2/images/generate with model: "gpt-image-2" (max 5 referenceImages); (3) Seedance 2.0 image-to-video per beat via POST /v2/videos/generate with model: "seedance-2.0" and startFrame from each still; (4) ffmpeg-stitch + burn captions. ../../shared/skills/pixar-style-ad/prompting/guide.mdstoryboard-gpt-image-2.md + animate-seedance-2.md
Claymation / Aardman-style ad — sculpted plasticine characters, narrator-driven 8-beat story arc, 60–115s Multi-step: (1) Lock cast sheet (protagonist + supporting character + narrator voice); (2) ChatGPT Image 2 storyboard stills via POST /v2/images/generate with model: "gpt-image-2" (max 5 referenceImages) — fallback to model: "nano-banana" (Pro) for close-ups if clay texture flattens; (3) Seedance 2.0 image-to-video per beat via POST /v2/videos/generate with model: "seedance-2.0"; (4) ffmpeg-stitch (optional fps=12,fps=24 for stop-motion judder) + burn captions. ../../shared/skills/claymation-ad/prompting/guide.mdstoryboard-gpt-image-2.md + animate-seedance-2.md
Add captions to a finished video — burn timed narrator/dialogue captions onto an existing MP4 (any source — claymation, pixar, UGC, B-roll) Out of band (no Arcads API call). Multi-step: (1) npx hyperframes init <run-id>-captions; (2) npx hyperframes transcribe source.mp4 --model medium.en (NOT small.en if there's background music); (3) group word-level transcript into reading phrases; (4) write captions-only HTML over #ff00ff magenta bg — never include <video> or <audio> elements (causes black-bar bug); (5) npm run render then ffmpeg chromakey=0xff00ff:0.10:0.05 overlay onto source. ../../shared/skills/caption-video/prompting/guide.md
Talking avatar / script (actors, voices) POST /v1/scripts, POST /v1/scripts/{id}/generate prompting/guide.md
OmniHuman POST /v1/omnihuman prompting/guide.md
Audio-driven POST /v1/audio-driven prompting/guide.md

Read the full file on GitHub · 335 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 335 lines · 133 tokens per session scan A dc2e826cba69

Subscribe to this mod's changes

arcads-external-api is a skill published in the GitHub repository krusemediallc/arcads-claude-code (1,480 stars, last pushed 2mo ago), licensed MIT. It adds 133 tokens to every session and 9,053 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

webgl-holographic-foil

A self-contained WebGL2 hero: thin-film interference over a crushed-foil surface whose palette shifts with the viewing angle; move the cursor to tilt the film.

nexu-io/open-design · 41 tokens

general-video

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated…

heygen-com/hyperframes · 92 tokens

html-ppt-hermes-cyber-terminal

OpenDesign + BYOK: choosing and wiring your own model, hands-on — cost, quality, and the routing decision. Built as a decision-grade AI literacy deck for engineers, IT, applied-AI teams.

nexu-io/open-design · 53 tokens

html-ppt-taste-brutalist

16:9 HTML deck in tactical-telemetry / CRT-terminal taste. Deactivated-CRT charcoal slides, white-phosphor monospace, hazard-red accent, scanline overlay, ASCII syntax, density over decoration. Distilled from Leonxlnx/taste-skill brutalist-skill (Tactical Telemetry mode).

nexu-io/open-design · 78 tokens

diagnostic-stem-delivery

Audio production with diagnostic analysis, timecode parsing from documents, and verified export workflow.

HKUDS/OpenSpace · 23 tokens

chengfeng-check-updates

An environment manager for a video-editing system. It checks whether its skills and runtime—the software needed to run them—are installed and compatible.

Agentchengfeng/chengfeng-videocut-skills · 120 tokens