skills.rest
krusemediallc
krusemediallcCOMMUNITY
Explore all skills by this author →
GitHub

arcads-external-api

Generates AI marketing videos and images via the Arcads external API.

1.5k|357|Updated Apr 1, 2026
Search Tags:#sora#marketing creative#AI video generation#Seedance#API Integration#UGC ads#arcads
One-click install
npx skills add https://github.com/krusemediallc/arcads-claude-code --skill arcads-external-api
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arcads-external-api
Source: https://github.com/krusemediallc/arcads-claude-code/tree/main/skills/arcads-external-api
Command: npx skills add https://github.com/krusemediallc/arcads-claude-code --skill arcads-external-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openai-whisper, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Creating AI-generated marketing videos and images across multiple models (Seedance 2.0, Sora 2, Veo 3.1, Kling 3.0, Grok Video, Nano Banana) requires knowing each model's API parameters, prompt formulas, credit costs, and polling behavior. This Skill handles the full Arcads external API workflow so you can produce ad creative without memorizing endpoint schemas or vendor prompting guides.

Core Features & Use Cases

  • Multi-model video and image generation: Routes requests to the unified POST /v2/videos/generate endpoint or image/b-roll/scene endpoints with the correct model value, duration, aspect ratio, and reference inputs.
  • Prompt library and workflow guidance: Loads model-specific prompting formulas (UGC, product hero, premium reveal, character sheets, influencer recreation) before composing any prompt.
  • Cost control and QA gates: Estimates credit costs from historical logs before generating, enforces a dialogue confirmation gate for talking videos, and runs visual QA with retries on generated still images.
  • Use Case: Ask for a 15-second UGC-style product review video. The Skill creates a dated project folder in Arcads, drafts the prompt and dialogue for your approval, shows a credit estimate, generates the video via Seedance 2.0, polls until ready, and delivers watch URLs.

Quick Start

Ask the agent to generate a 15-second UGC-style product review video with Seedance 2.0 using your Arcads API key configured in the .env file.

Frequently Asked Questions about arcads-external-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an AI video with the Arcads API?▼

Send a POST request to /v2/videos/generate with a model value such as seedance-2.0, sora2, veo31, kling-3.0, or grok-video, plus productId, prompt, and optional duration and aspectRatio. Then poll GET /v1/videos/{id} or GET /v1/assets/{id} depending on the response type until the status is generated.

Which Arcads video model should I use for UGC ads?▼

Seedance 2.0 is the flagship choice for UGC-style videos with speech, supporting 4-15 second durations, 9:16 or 16:9 aspect ratios, reference images, and audio output. Sora 2 and Veo 3.1 also support spoken dialogue, while Kling and Grok Video are silent-only.

How does Arcads API authentication work?▼

The API uses HTTP Basic auth with your Arcads API key as the username and an empty password, for example curl -u "$ARCADS_API_KEY:". Store the key in a .env file and never commit it or paste it into shared contexts.

Why does my Seedance 2.0 request return HTTP 500?▼

Common causes include combining referenceVideos and referenceImages in one request (they are mutually exclusive), using more than one reference video, or sending a stale presigned upload URL. Pick one input mode and always use freshly obtained presigned URLs.

Can I estimate credit costs before generating videos?▼

Yes. Check the logs/arcads-api.jsonl history for recorded creditsCharged values matching your model and config, or use rate tables in MASTER_CONTEXT.md. The API has no billing endpoint, so all totals are estimates to confirm in the Arcads platform.

What are the limitations of reference image uploads?▼

Presigned upload filePaths are single-use; reusing one returns HTTP 400 REFERENCE_FILE_NOT_FOUND, so re-upload before each call. Images under 1024px on the longest side may be rejected with a 422 error, so upscale to 1080px first.

Related Skills

Explore More Marketing & Sales Skills→
npc-livenpc-live
168

digital-avatar

Create and animate digital avatars from text or photos, outputting avatar_id and video-ready assets.

Official
Advanced
williamsforealwilliamsforeal
1

seedance-ugc-ads

Generates a multi-shot UGC ad video from a product image using Seedation 2.0 on fal.ai and stitches MP4s into a 9:16 final video with ffmpeg.

Community
Advanced
Largo2z9Largo2z9
1

decompose-ad

Analyzes paid advertising creatives to identify structure, messaging, and strategic mechanics.

Community
Advanced
cdeistopenedcdeistopened

video-generator

Generate videos from text prompts or images using Google VEO 3.1, OpenAI Sora, or Kling.

Community
Advanced