# Wonda CLI Documentation

> AI-powered marketing automation — generate, edit, publish, and analyze media via CLI & API.

## Getting Started

- [Overview](https://www.wonda.sh/docs): Programmatic access to Wonda generation, publishing, media, and local CLI editing workflows.
- [Authentication](https://www.wonda.sh/docs/authentication): All API requests require a Bearer token in the Authorization header.
- [Quick Start](https://www.wonda.sh/docs/quick-start): Get up and running with API-key auth, generation, job polling, and publishing.
- [Creative vs Verbatim Mode](https://www.wonda.sh/docs/verbatim-mode): Understand how Wonda handles prompts on the current public API surface.

## Generation

- [Image Generation](https://www.wonda.sh/docs/image-generation): Generate images, remove backgrounds, and vectorize with AI models.
- [Video Generation](https://www.wonda.sh/docs/video-generation): Generate, transform, upscale, and process videos with AI models.
- [Text Generation](https://www.wonda.sh/docs/text-generation): Generate text completions and extract brand styles with AI models.
- [Music Generation](https://www.wonda.sh/docs/music-generation): Generate original music tracks with AI.
- [Speech (TTS)](https://www.wonda.sh/docs/audio-speech): Synthesize speech from text using AI voices.
- [Transcription (STT)](https://www.wonda.sh/docs/audio-transcription): Transcribe audio files to text with AI speech recognition.
- [Dialogue](https://www.wonda.sh/docs/audio-dialogue): Generate multi-speaker dialogue audio from a script.
- [Extract Timestamps](https://www.wonda.sh/docs/alignment-timestamps): Extract word-level timestamps by aligning a transcript to an audio file.

## Editing

- [Video Editing](https://www.wonda.sh/docs/video-editing): Apply local video edits with the Wonda CLI: trim, crop, merge, overlay, captions, audio mixing, and more.
- [Image Editing](https://www.wonda.sh/docs/image-editing): Crop images and add local hyperframes text overlays with the Wonda CLI.
- [Audio Editing](https://www.wonda.sh/docs/audio-editing): Trim audio locally with the Wonda CLI and route AI audio cleanup through direct audio endpoints.

## Publishing

- [Instagram](https://www.wonda.sh/docs/publish-instagram): Publish single images, reels, stories, and carousels to a connected Instagram account.
- [TikTok](https://www.wonda.sh/docs/publish-tiktok): Publish single videos and photo carousels to a connected TikTok account.
- [Distribution Accounts](https://www.wonda.sh/docs/distribution-accounts): List connected Instagram and TikTok accounts, then review publish history for each surface.
- [Distribution Publishing](https://www.wonda.sh/docs/distribution-publishing): Publish carousel content and inspect distribution records.

## Cloud twin (MCP)

- [Connect to Claude](https://www.wonda.sh/docs/connect-claude): Add Wonda's cloud twin to Claude as a custom remote MCP connector with OAuth.

## Media

- [Upload Media](https://www.wonda.sh/docs/media-upload): Upload images, videos, and audio files to use in generation and editing workflows.

## Analytics

- [Analytics](https://www.wonda.sh/docs/analytics): Fetch account-level analytics for Instagram, TikTok, and Meta Ads from the public API.

## Scraping

- [Scraping](https://www.wonda.sh/docs/scraping): Scrape public social profiles and Meta Ads Library for competitive intelligence.

## Styles

- [List Styles](https://www.wonda.sh/docs/styles-list): Retrieve brand and featured styles available to your account.

## Discovery & Pricing

- [Capabilities](https://www.wonda.sh/docs/capabilities): Live inventory of models and publish destinations exposed by the public API.
- [Pricing](https://www.wonda.sh/docs/pricing): Retrieve current pricing for generation models and legacy render pricing fields.
- [Cost Estimation](https://www.wonda.sh/docs/pricing-estimate): Get a cost estimate for a generation request before running it.

## Reference

- [Error Codes](https://www.wonda.sh/docs/errors): Error response format and common HTTP status codes.
- [Job Polling](https://www.wonda.sh/docs/job-polling): Direct generation and publishing operations follow a create-then-poll pattern.
- [Rate Limits](https://www.wonda.sh/docs/rate-limits): Request-rate limiting and concurrent task admission rules for the public API.