deAPI Skills

Agent skills for deAPI. With them an AI agent can transcribe recordings and video links, generate and edit images, create speech, music and video, read text from images, remove backgrounds, upscale and compute embeddings, and help developers build all of this into their own apps.

The skills follow the agentskills.io open standard, so the same folder works in Claude Code, Codex, Cursor, Hermes Agent, OpenClaw, Goose, OpenCode, GitHub Copilot and other agents that support skills.

Quick start

export DEAPI_API_KEY="sk-dp-..."      # create a key at https://app.deapi.ai/settings/api-keys
npx skills add deapi-ai/skills        # or see "Install" below for your agent

Then ask your agent, for example:

• "Transcribe this YouTube video, it's in English: https://www.youtube.com/watch?v=..."
• "Generate a 1024x768 image of a red fox in studio light"
• "Read this text aloud in my voice, the sample is voice.wav"
• "How do I verify a deAPI webhook signature in Node?"

Every paid job is priced first, for free, and the agent stops and asks you when the price is above your limit (0.25 USD per job by default).

The two skills

Skill	Use it to	How it works
deapi	Get something done now: transcribe or subtitle a file or a YouTube, X, TikTok, Twitch or Kick link; generate, edit and upscale images; remove backgrounds; read text from images (OCR); turn text or a photo into video and describe videos; speech with preset voices, a cloned voice or a designed voice; music; embeddings; better prompts; job status; account and key limits.	A helper script (deapi/scripts/deapi.py, Python 3.9+, standard library only), or the deAPI MCP tools when they are connected.
deapi-api	Build deAPI into an application: the native API v2, async jobs and webhooks, WebSockets, limits and errors, keys and usage, and OpenAI SDKs pointed at https://oai.deapi.ai/v1.	Reference pages and tested code examples (Python, TypeScript, Node, curl). It runs nothing on its own.

Install

1. Get an API key

Sign up at deapi.ai and create a key at app.deapi.ai/settings/api-keys (Settings > API Keys). Keys look like sk-dp-<id>-<secret>; use them as they are.

For an agent, create a dedicated key with the API role and a daily spend limit. deAPI enforces that limit itself, whatever the agent does.

2. Make the key available

The skills read the key from the DEAPI_API_KEY environment variable. Never paste the key into the chat.

export DEAPI_API_KEY="sk-dp-..."      # add it to your shell profile

3. Install the skills

Any agent, via skills.sh:

npx skills add deapi-ai/skills

Claude Code (manual):

git clone https://github.com/deapi-ai/skills.git
mkdir -p ~/.claude/skills && cp -r skills/deapi skills/deapi-api ~/.claude/skills/

To let Claude Code run the helper without asking each time, allow only that script in settings.json, for example "allow": ["Bash(python /path/to/deapi/scripts/deapi.py *)"] with the path where you installed the skill. The skill tells the agent to run one command per call, so the rule matches.

Hermes Agent:

hermes skills install deapi-ai/skills/deapi

Hermes does not ask for the key when it loads the skill. Add it to the Hermes .env file (~/.hermes/.env by default; hermes config env-path prints the path), which Hermes passes to the terminal where the script runs:

DEAPI_API_KEY=sk-dp-...

If your deAPI account has access to chat models, Hermes can also use one as its main model through the OpenAI-compatible API (hermes model, "Custom endpoint", or in config.yaml):

model:
  provider: custom
  base_url: https://oai.deapi.ai/v1
  key_env: DEAPI_API_KEY
  default: <a chat model ID from GET https://oai.deapi.ai/v1/models>

A text-only chat model cannot handle Hermes' image tasks (vision); point auxiliary.vision at another provider if you need them.

To make deAPI the engine behind Hermes' built-in image_generate and video_generate tools, install the deAPI plugin (hermes plugins install deapi-ai/hermes-plugin-deapi, hermes plugins enable deapi, then pick deAPI in hermes tools). For the deAPI MCP tools, add the server to config.yaml; Hermes fills in the key from its .env:

mcp_servers:
  deapi:
    url: https://mcp.deapi.ai/mcp
    headers:
      Authorization: "Bearer ${DEAPI_API_KEY}"

Codex, Cursor, Goose, OpenCode, VS Code Copilot (shared ~/.agents/skills convention):

git clone https://github.com/deapi-ai/skills.git
mkdir -p ~/.agents/skills && cp -r skills/deapi skills/deapi-api ~/.agents/skills/

OpenClaw: copy the deapi folder to the agent's skills folder. The skill declares that it needs DEAPI_API_KEY and one of python3, python or py.

Requirements: the deapi skill needs Python 3.9 or newer (the version macOS ships) and network access to api.deapi.ai. On Windows, python or py works too.

Use

Ask your agent in plain language. You can also run the helper script yourself:

python3 deapi/scripts/deapi.py doctor                         # check Python, the key and limits
python3 deapi/scripts/deapi.py transcribe "https://www.youtube.com/watch?v=..." --lang en
python3 deapi/scripts/deapi.py image --prompt "a red fox, studio light" --quote
python3 deapi/scripts/deapi.py transcribe --duration 7200 --quote   # price of 2 hours, no file needed
python3 deapi/scripts/deapi.py models --type image
python3 deapi/scripts/deapi.py account

This is the beginning of the README. Read the rest at the original. Read the full README ↗