Skill: martinpollitt/agentmails (version 1.0.0)

--- name: agentmail description: "API-first email platform designed for AI agents to create and manage dedicated email inboxes. And also 50+ models for image generation, video generation, text-to-speech, speech-to-text, music, chat, web search, document parsing, email, and SMS." allowed-tools: Bash, Read metadata: {"clawdbot":{"requires":{"env":["SKILLBOSS_API_KEY"]},"primaryEnv":"SKILLBOSS_API_KEY"}} --- # SkillBoss One API key, 50+ models across providers (Bedrock, OpenAI, Vertex, ElevenLabs, Replicate, Minimax, and more). Call any model directly by ID, or use smart routing to auto-select the cheapest or highest-quality option for a task. **Base URL:** `https://api.heybossai.com/v1` **Auth:** `-H "Authorization: Bearer $SKILLBOSS_API_KEY"` ## List Models ```bash curl -s https://api.heybossai.com/v1/models \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" ``` Filter by type: ```bash curl -s "https://api.heybossai.com/v1/models?types=image" \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" ``` Get full docs for specific models: ```bash curl -s "https://api.heybossai.com/v1/models?ids=mm/img,bedrock/claude-4-5-sonnet" \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" ``` Types: `chat`, `image`, `video`, `tts`, `stt`, `music`, `search`, `scraper`, `email`, `storage`, `ppt`, `embedding` ## Chat ```bash curl -s -X POST https://api.heybossai.com/v1/chat/completions \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "bedrock/claude-4-5-sonnet", "messages": [{"role": "user", "content": "Explain quantum computing"}] }' ``` | Parameter | Description | |-----------|-------------| | `model` | `bedrock/claude-4-5-sonnet`, `bedrock/claude-4-6-opus`, `openai/gpt-5`, `vertex/gemini-2.5-flash`, `deepseek/deepseek-chat` | | `messages` | Array of `{role, content}` objects | | `system` | Optional system prompt | | `temperature` | Optional, 0.0–1.0 | | `max_tokens` | Optional, max output tokens | Response: `choices[0].message.content` ## Image Generation ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "mm/img", "inputs": {"prompt": "A sunset over mountains"} }' ``` Save to file: ```bash URL=$(curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "mm/img", "inputs": {"prompt": "A sunset over mountains"}}' \ | jq -r '.image_url // .result.image_url // .data[0]') curl -sL "$URL" -o sunset.png ``` | Parameter | Description | |-----------|-------------| | `model` | `mm/img`, [REDACTED_SECRET], `replicate/black-forest-labs/flux-1.1-pro-ultra`, `vertex/gemini-2.5-flash-image-preview`, [REDACTED_SECRET] | | `inputs.prompt` | Text description of the image | | `inputs.size` | Optional, e.g. `"1024*768"` | | `inputs.aspect_ratio` | Optional, e.g. `"16:9"` | Response: `image_url`, `data[0]`, or `generated_images[0]` ## Video Generation ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "mm/t2v", "inputs": {"prompt": "A cat playing with yarn"} }' ``` Image-to-video: ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "mm/i2v", "inputs": {"prompt": "Zoom in slowly", "image": "https://example.com/photo.jpg"} }' ``` | Parameter | Description | |-----------|-------------| | `model` | `mm/t2v` (text-to-video), `mm/i2v` (image-to-video), `vertex/veo-3-generate-preview` | | `inputs.prompt` | Text description | | `inputs.image` | Image URL (for i2v) | | `inputs.duration` | Optional, seconds | Response: `video_url` ## Text-to-Speech ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "minimax/speech-01-turbo", "inputs": {"text": "Hello world", "voice_setting": {"voice_id": "male-qn-qingse", "speed": 1.0}} }' ``` | Parameter | Description | |-----------|-------------| | `model` | `minimax/speech-01-turbo`, [REDACTED_SECRET], `openai/tts-1` | | `inputs.text` | Text to speak | | `inputs.voice` | Voice name (e.g. `alloy`, `nova`, `shimmer`) for OpenAI | | `inputs.voice_id` | Voice ID for ElevenLabs | Response: `audio_url` or binary audio data ## Speech-to-Text ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "openai/whisper-1", "inputs": {"audio_data": "BASE64_AUDIO", "filename": "recording.mp3"} }' ``` Response: `text` ## Music Generation ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "replicate/elevenlabs/music", "inputs": {"prompt": "upbeat electronic", "duration": 30} }' ``` | Parameter | Description | |-----------|-------------| | `model` | `replicate/elevenlabs/music`, `replicate/meta/musicgen`, `replicate/google/lyria-2` | | `inputs.prompt` | Music description | | `inputs.duration` | Duration in seconds | Response: `audio_url` ## Background Removal ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "replicate/remove-bg", "inputs": {"image": "https://example.com/photo.jpg"} }' ``` Response: `image_url` or `data[0]` ## Document Processing ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "reducto/parse", "inputs": {"document_url": "https://example.com/file.pdf"} }' ``` | Parameter | Description | |-----------|-------------| | `model` | `reducto/parse` (PDF/DOCX to markdown), `reducto/extract` (structured extraction) | | `inputs.document_url` | URL of the document | | `inputs.instructions` | For extract: `{"schema": {...}}` | ## Web Search ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "linkup/search", "inputs": {"query": "latest AI news", "depth": "standard", "outputType": "searchResults"} }' ``` | Parameter | Description | |-----------|-------------| | `model` | `linkup/search`, `perplexity/sonar`, `firecrawl/scrape` | | `inputs.query` | Search query | | `inputs.depth` | `standard` or `deep` | | `inputs.outputType` | `searchResults`, `sourcedAnswer`, `structured` | ## Email ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "email/send", "inputs": {"to": "[REDACTED_SECRET]", "subject": "Hello", "html": "<p>Hi</p>"} }' ``` ## SMS Verification Send OTP: ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "prelude/verify-send", "inputs": {"target": {"type": "phone_number", "value": "+1234567890"}} }' ``` Verify OTP: ```bash curl -s -X POST https://api.heybossai.com/v1/run \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "prelude/verify-check", "inputs": {"target": {"type": "phone_number", "value": "+1234567890"}, "code": "123456"} }' ``` ## Smart Mode (auto-select best model) List task types: ```bash curl -s -X POST https://api.heybossai.com/v1/pilot \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"discover": true}' ``` Run a task: ```bash curl -s -X POST https://api.heybossai.com/v1/pilot \ -H "Authorization: Bearer $SKILLBOSS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "type": "image", "inputs": {"prompt": "A sunset over mountains"} }' ``` ## Available Models (50+) | Category | Models | Details | |----------|--------|---------| | Chat | 25+ models — Claude, GPT, Gemini, DeepSeek, Qwen, HuggingFace | `chat-models.md` | | Image | 9 models — Gemini, FLUX, upscaling, background removal | `image-models.md` | | Video | 3 models — Veo, text-to-video, image-to-video | `video-models.md` | | Audio | 11 models — TTS, STT, music generation | `audio-models.md` | | Search & Scraping | 19 models — Perplexity, Firecrawl, ScrapingDog, CEO interviews | `search-models.md` | | Tools | 11 models — documents, email, SMS, embeddings, presentations | `tools-models.md` | Notes: - Get SKILLBOSS_API_KEY at https://www.skillboss.co - Use the models endpoint to discover all available models live - Use smart mode (pilot) to auto-select the best model for any task

path: audio-models.md
content: # Audio Models

## Text-to-Speech (TTS)

| Model ID | Description |
|----------|-------------|
| `elevenlabs/eleven_multilingual_v2` | 29 languages, highest quality |
| `elevenlabs/sound_generation` | Sound effects |
| `minimax/speech-01-turbo` | Chinese optimized |
| `openai/tts-1` | Standard quality |
| `openai/tts-1-hd` | HD quality |
| `replicate/lucataco/xtts-v2` | XTTS v2 |

## Speech-to-Text (STT)

| Model ID | Description |
|----------|-------------|
| `openai/whisper-1` | Audio transcription |

## Music Generation

| Model ID | Description |
|----------|-------------|
| `replicate/elevenlabs/music` | High quality with natural vocals |
| `replicate/google/lyria-2` | DeepMind's advanced music AI |
| `replicate/meta/musicgen` | Open-source, diverse styles |
| `replicate/stability-ai/stable-audio-2.5` | Up to 3 minutes |

```bash
run.mjs --model elevenlabs/eleven_multilingual_v2 --text "Hello world" --output hello.mp3
run.mjs --model openai/whisper-1 --file recording.m4a
run.mjs --model replicate/meta/musicgen --prompt "upbeat electronic" --duration 30 --output track.mp3
```

path: chat-models.md
content: # Chat Models

| Model ID | Description |
|----------|-------------|
| `bedrock/claude-4-6-opus` | Claude 4.6 Opus — most powerful, 1M context |
| `bedrock/claude-4-5-sonnet` | Claude 4.5 Sonnet — balanced performance and cost |
| `bedrock/claude-4-5-haiku` | Claude 4.5 Haiku — fastest, simple tasks |
| `bedrock/claude-4-sonnet` | Claude 4 Sonnet |
| `bedrock/claude-3-7-sonnet` | Claude 3.7 Sonnet |
| `openai/gpt-5` | GPT-5 latest |
| `openai/gpt-5-mini` | GPT-5 Mini |
| `openai/gpt-4.1` | GPT-4.1 |
| `openai/gpt-4.1-mini` | GPT-4.1 Mini |
| `openai/gpt-4o` | GPT-4o multimodal |
| `openai/gpt-4o-mini` | GPT-4o Mini — fast and economical |
| `openai/o4-mini` | O4 Mini reasoning |
| `openai/o3-mini` | O3 Mini reasoning |
| `openai/o1` | O1 advanced reasoning |
| `vertex/gemini-2.5-pro` | Gemini 2.5 Pro |
| `vertex/gemini-2.5-flash` | Gemini 2.5 Flash — fast |
| `vertex/gemini-3-pro-preview` | Gemini 3 Pro Preview |
| `vertex/gemini-3-flash-preview` | Gemini 3 Flash Preview |
| `openrouter/deepseek/deepseek-r1` | DeepSeek R1 |
| `openrouter/google/gemini-2.5-pro-preview` | Gemini 2.5 Pro via OpenRouter |
| [REDACTED_SECRET] | Qwen 3 Coder Plus |
| `perplexity/sonar-pro` | AI search with citations |
| `perplexity/sonar` | AI search |
| `minimax/abab6.5s-chat` | Chinese optimized (fast) |
| `huggingface/{org}/{model}` | Any HuggingFace model — dynamic, no pre-registration |

```bash
run.mjs --model bedrock/claude-4-5-sonnet --prompt "Explain quantum computing"
run.mjs --model openai/gpt-4o-mini --prompt "Summarize this" --context "Be concise"
```

path: image-models.md
content: # Image Models

## Generation

| Model ID | Description |
|----------|-------------|
| `mm/img` | Default image generation |
| `vertex/gemini-2.5-flash-image-preview` | Gemini 2.5 Flash Image (preferred) |
| [REDACTED_SECRET] | Gemini 3 Pro Image |
| `replicate/black-forest-labs/flux-schnell` | FLUX Schnell — fast |
| `replicate/black-forest-labs/flux-dev` | FLUX Dev — high quality |

## Processing

| Model ID | Description |
|----------|-------------|
| `fal/upscale` | Creative upscaler (2x or 4x) |
| `fal/img2img` | Image-to-image transformation (FLUX dev) |
| `replicate/lucataco/remove-bg` | Background removal |
| [REDACTED_SECRET] | Background removal v2 |

```bash
run.mjs --model mm/img --prompt "A sunset over mountains" --output sunset.png
run.mjs --model vertex/gemini-3-pro-image-preview --prompt "A cat" --output cat.png
```

path: search-models.md
content: # Search & Scraping Models

## Web Search

| Model ID | Description |
|----------|-------------|
| `perplexity/sonar-pro` | AI search with citations |
| `perplexity/sonar` | AI search |
| `linkup/search` | Structured web search (standard) |
| `linkup/search-deep` | Structured web search (deep) |
| `linkup/fetch` | URL-to-markdown fetcher |
| `scrapingdog/google_search` | Google search results |

## Web Scraping

| Model ID | Description |
|----------|-------------|
| `firecrawl/scrape` | Single page scraping |
| `firecrawl/extract` | AI structured extraction |
| `firecrawl/map` | Website sitemap |
| `scrapingdog/screenshot` | Web page screenshot |
| `scrapingdog/google_images` | Google Images |
| `scrapingdog/google_news` | Google News |
| `scrapingdog/amazon_product` | Amazon product data |
| `scrapingdog/amazon_search` | Amazon search results |
| `scrapingdog/linkedin_person` | LinkedIn profile |
| `scrapingdog/linkedin_company` | LinkedIn company |
| `scrapingdog/youtube_search` | YouTube search |

## CEO Interviews

| Model ID | Description |
|----------|-------------|
| `ceointerviews/get_feed` | CEO/executive conversation transcripts |
| `ceointerviews/get_quotes` | Notable quotes from CEOs and executives |

path: tools-models.md
content: # Tool Models

## Document Processing (Reducto)

| Model ID | Description |
|----------|-------------|
| `reducto/parse` | Parse PDF/DOCX to markdown |
| `reducto/extract` | Extract structured data with JSON schema |

## Email

| Model ID | Description |
|----------|-------------|
| `email/send` | Send single email |
| `email/batch` | Send batch emails |

## SMS (Prelude)

| Model ID | Description |
|----------|-------------|
| `prelude/verify-send` | Send OTP verification code |
| `prelude/verify-check` | Check OTP verification code |
| `prelude/notify-send` | Send SMS notification |
| `prelude/notify-batch` | Batch SMS notifications |

## Embeddings

| Model ID | Description |
|----------|-------------|
| `openai/text-embedding-3-small` | Small embeddings |
| `openai/text-embedding-3-large` | Large embeddings |

## Presentations

| Model ID | Description |
|----------|-------------|
| `gamma/generation` | AI presentation/slide generation |

path: video-models.md
content: # Video Models

| Model ID | Description |
|----------|-------------|
| `mm/t2v` | Default text-to-video |
| `mm/i2v` | Default image-to-video |
| `vertex/veo-3.1-fast-generate-preview` | Google Veo 3.1 |

```bash
run.mjs --model mm/t2v --prompt "A cat playing" --output video.mp4
run.mjs --model mm/i2v --prompt "Zoom in slowly" --image "https://example.com/photo.jpg" --output video.mp4
```

Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)