Official agent skill

ZOOOP Skill: generate images, video and audio from your AI agent

Install one skill bundle and your agent can create with 70+ top AI models — Flux, Veo, Kling, Seedance, ElevenLabs and more — without leaving the terminal. It picks the model, prices the job, submits it, waits, and hands back the file.

Install
npx skills add zooopai/skill-zooop
Installation guideView on GitHub

Works with Claude Code, Codex, Cursor, OpenCode and 70+ other agents.

Every top model, one skill

The skill queries the live ZOOOP catalog at runtime, so your agent can reach every image, video and audio model on the platform — including ones added after you installed it.

Runs inside your agent

No new app, no dashboard. Ask in plain language; the agent reads SKILL.md, calls the REST API and returns a URL or a downloaded file.

Pays from credits you already have

Generations are charged to your existing ZOOOP balance. No separate plan, no subscription, and credits never expire.

What your agent can make

The skill covers every generation category ZOOOP exposes through its public API, plus the specialised tools — background removal and upscaling — that a prompt alone can't do.

Image

Text-to-image, image-to-image, prompt-driven edits, mask-based inpainting, SVG vector output, upscaling and background removal.

Video

Text-to-video, animate a still, first/last-frame interpolation, motion transfer from a reference clip, lip-sync, extend and restyle.

Audio

Text-to-speech in a named voice, voice cloning from a sample, one-shot sound effects, and full music tracks.

Model availability is read live at request time, so a model published today works the same day. Browse the full catalog.

Install in three steps

About two minutes. You need a ZOOOP account with credits and a terminal.

  1. 1Install the skill

    The bundle is a public GitHub repo containing SKILL.md, an API reference and helper scripts. Pick whichever line matches your setup.

    npx skills add zooopai/skill-zooop

    Detects the agents on your machine and installs for each. Add -g to install once for every project instead of only the current one.

  2. 2Create an API key

    Generations are authenticated with a personal access token (zpk_live_…). It is shown once, so copy it before closing the dialog.

    Create a token

    Set the value in your own terminal, never by pasting it into an agent chat — anything in a conversation can end up in logs or a shared transcript.

    echo 'export ZOOOP_API_KEY=zpk_live_xxxxxxxxxxxx' >> ~/.zshrc
    source ~/.zshrc

    Using bash instead of zsh? Write the same line to ~/.bashrc.

  3. 3Restart your agent and ask

    Agents inherit the environment at start-up, so restart yours after step 2. Confirm the token resolves, then just describe what you want.

    Check the token
    curl -fsS https://api.zooop.ai/v1/me \
      -H "Authorization: Bearer $ZOOOP_API_KEY"

    Try one of these

    • ›Generate a 1:1 poster of a neon-lit rainy Tokyo alley, cinematic.
    • ›Animate this photo into a 5-second clip with a slow push-in. ./portrait.jpg
    • ›Read this paragraph as speech in a calm British male voice.

What the agent does for you

Every request follows the same five steps. The skill handles them, so you never have to learn the API.

  1. 01

    Picks a model

    Reads the live catalog for the right category and matches your hint, or falls back to the curated default.

  2. 02

    Uploads your files

    Local images, video or audio are pushed to ZOOOP storage first — models only accept ZOOOP-hosted URLs.

  3. 03

    Prices it first

    A free quote call returns the exact credit cost and an ETA before anything is charged.

  4. 04

    Submits safely

    Every submit carries an idempotency key, so a timed-out request can be retried without paying twice.

  5. 05

    Waits and delivers

    Polls until the task is done, prints the output URL and offers to save the file locally.

Cost and safety controls

The skill spends real credits, so every token you issue carries its own limits.

Daily spend cap per token
Set a credit ceiling when you create the key. A task that would breach it is refused before it runs, so a runaway loop cannot drain the balance.
Bound to one project
Each token is locked to a project at creation. Every task and upload it makes lands there, keeping agent output separate from your manual work.
Nothing is charged without a quote
Quotes are free and have no side effects. Generations that fail are refunded automatically.
The token stays out of the chat
The skill instructs the agent to read the value from an environment variable and never to ask you to paste it. Revoke or rotate any key from the page you created it on.

Questions

Which agents does this work with?
Any agent that reads Markdown instructions and can run shell commands. Claude Code, Codex, Cursor and OpenCode are the ones we test; the skills CLI supports 70+ more.
Does the skill itself cost anything?
No. The bundle is MIT-licensed and free. You only pay the credit cost of the generations your agent runs, at the same rates as the website.
How much does a generation cost?
It depends on the model and the output — mostly resolution and duration. The agent quotes the exact price before submitting, and per-model rates are on the pricing page.
Where do I get an API key?
In your profile, under API Keys. Personal tokens spend your own credits; a team owner or admin can issue a team token that spends the shared team balance instead.
Can the agent use my canvases and templates?
No. The skill does single-shot generation only — it does not manage projects, canvases or teams. Results land in the token's bound project, where you can open them in the web app.
How do I update the skill?
Re-run the install command, or git pull in the cloned directory. The model catalog is read live, so a newly published model needs no update at all.

Docs and source

skill-zooop on GitHub

The full bundle — SKILL.md, helper scripts and the API reference. MIT licensed; issues and PRs welcome.

SKILL.md

The instruction file your agent actually reads: model-selection rules, workflow and error handling.

API documentation

The REST API behind the skill, with cURL, JavaScript and Python examples for every endpoint.

Full v1 reference

Every request and response shape, error code and rate limit, in one Markdown file.

Skill quickstart tutorial

A walkthrough with real prompts and results: what to ask for, and what comes back.

Agents can also discover ZOOOP without the bundle: /llms.txt · /llms-full.txt

Ready to hand it to your agent?

Create a token, export it, and your next prompt can produce a finished image, clip or track.

Create an API keySee pricing