Quickstart

Three commands. The skill teaches your agent the workflow; the CLI does the work; the account holds the credits.

$ npx skills add vokox-ai/vokox⌘C$ npm i -g @vokox/cli⌘C$ vokox auth login⌘C

Then, in your agent: “Make a 15-second vertical ad for this product photo, English voice-over.” The agent drafts a plan, shows the cost and waits for your yes.

plan.json

One file per deliverable. Steps reference each other with @id; local files with file:. Independent steps run in parallel; a rerun skips finished steps.

{
  "name": "coffee-ad", "budget": { "maxCredits": 300 },
  "defaults": { "aspectRatio": "9:16" },
  "steps": [
    { "id": "hero",  "type": "image", "model": "auto:image.hq", "refs": ["file:./product.png"], "prompt": "…" },
    { "id": "clip1", "type": "video", "model": "auto:video.hq", "refs": ["@hero"], "duration": 5, "prompt": "slow dolly in; …" },
    { "id": "voice", "type": "tts",   "language": "en", "voice": "en-female-1", "text": "…" },
    { "id": "music", "type": "music", "prompt": "warm lo-fi, 90 bpm, no vocals", "duration": 30 },
    { "id": "final", "type": "compose", "timeline": {
      "clips": [{ "asset": "@clip1" }], "voice": { "asset": "@voice" },
      "music": { "asset": "@music", "volume": 0.2, "duck": true },
      "captions": { "from": "@voice", "style": "bold-bottom" } } }
  ]
}

$ vokox run plan.json --estimate⌘C$ vokox run plan.json --yes --max-credits 300⌘C

MCP server

For claude.ai, ChatGPT, Cursor or Claude Code without the CLI. Same tools, same credits.

$ claude mcp add --transport http vokox https://vokox.ai/mcp --header "Authorization: Bearer sk_…"⌘C

Tools: list_models, estimate_cost, generate, compose, get_job, list_recent, get_balance. Create an API key in your account.

HTTP API

Bearer auth with an API key. Jobs are asynchronous: create, poll, download.

POST /v1/price          { "type": "video", "input": { "prompt": "…", "model": "auto:video.hq", "duration": 5 } }
POST /v1/jobs           same body → { id, status, creditsHeld }
GET  /v1/jobs/:id       → { status: queued|running|succeeded|failed, output: { assets: [{ id, url }] } }
POST /v1/uploads        multipart "file" → { id }   (use the id in "refs")
GET  /v1/me             → { balance, topupUrl }

Terms

Credits are prepaid and non-refundable except for failed generations, which are refunded automatically. You own the outputs you generate, subject to the licenses of the underlying models. Do not generate sexual content involving minors, non-consensual imagery of real people, or content that violates the law of your jurisdiction; such requests are refused and repeated attempts close the account.

Privacy

We store your email, your prompts, the files you upload and the files we generate for you, so you can find them again. Prompts and reference files are sent to the model provider that runs the job and nowhere else. Files can be deleted from your account at any time; deleted files are gone within 24 hours.