- name
- skillboss
- description
- Swiss-knife for AI agents. 50+ models for image generation, video generation, text-to-speech, speech-to-text, music, chat, web search, document parsing, email, and SMS — with smart routing for cost saving.
- 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
List Models
curl -s -X POST https://api.heybossai.com/v1/models \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\"}"Filter by type:
curl -s -X POST https://api.heybossai.com/v1/models \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"types\":\"image\"}"Types: chat, image, video, tts, stt, music, search, tools
Smart Mode (auto-select best model)
List available task types:
curl -s -X POST https://api.heybossai.com/v1/pilot \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"discover\":true}"Run a task (auto-selects best model):
curl -s -X POST https://api.heybossai.com/v1/pilot \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"type\":\"image\",\"inputs\":{\"prompt\":\"A sunset over mountains\"}}"Chat
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"model\":\"bedrock/claude-4-5-sonnet\",\"inputs\":{\"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 |
inputs.messages | Array of {role, content} objects |
inputs.system | Optional system prompt string |
inputs.temperature | Optional, 0.0–1.0 |
inputs.max_tokens | Optional, max output tokens |
Response: choices[0].message.content or content[0].text
Image Generation
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"model\":\"mm/img\",\"inputs\":{\"prompt\":\"A sunset over mountains\"}}"Save to file:
URL=$(curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"model\":\"mm/img\",\"inputs\":{\"prompt\":\"A sunset over mountains\"}}" \
| grep -o '"image_url":"[^"]*"' | cut -d'"' -f4)
curl -sL "$URL" -o sunset.png| Parameter | Description |
|---|---|
model | mm/img, replicate/black-forest-labs/flux-2-pro, replicate/black-forest-labs/flux-1.1-pro-ultra, vertex/gemini-2.5-flash-image-preview, vertex/gemini-3-pro-image-preview |
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
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"model\":\"mm/t2v\",\"inputs\":{\"prompt\":\"A cat playing with yarn\"}}"Image-to-video:
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"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
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"model\":\"minimax/speech-01-turbo\",\"inputs\":{\"text\":\"Hello world\",\"input\":\"Hello world\",\"voice\":\"alloy\"}}"| Parameter | Description |
|---|---|
model | minimax/speech-01-turbo, elevenlabs/eleven_multilingual_v2, openai/tts-1 |
inputs.text | Text to speak |
inputs.voice | Voice name (e.g. alloy, nova, shimmer) |
inputs.voice_id | Voice ID (for ElevenLabs) |
Response: audio_url or binary audio data
Speech-to-Text
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"model\":\"openai/whisper-1\",\"inputs\":{\"audio_data\":\"BASE64_AUDIO\",\"filename\":\"recording.mp3\"}}"| Parameter | Description |
|---|---|
model | openai/whisper-1 |
inputs.audio_data | Base64-encoded audio |
inputs.filename | Original filename with extension |
Response: text
Music Generation
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"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
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"model\":\"replicate/remove-bg\",\"inputs\":{\"image\":\"https://example.com/photo.jpg\"}}"| Parameter | Description |
|---|---|
model | replicate/remove-bg, replicate/background-remover |
inputs.image | Image URL |
Response: image_url or data[0]
Document Processing
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"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": {...}} JSON schema |
Response: result (parsed content)
Web Search
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"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 |
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"model\":\"email/send\",\"inputs\":{\"to\":\"user@example.com\",\"subject\":\"Hello\",\"html\":\"<p>Hi there</p>\"}}"SMS Verification
Send OTP:
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"model\":\"prelude/verify-send\",\"inputs\":{\"target\":{\"type\":\"phone_number\",\"value\":\"+1234567890\"}}}"Verify OTP:
curl -s -X POST https://api.heybossai.com/v1/run \
-H "Content-Type: application/json" \
-d "{\"api_key\":\"$SKILLBOSS_API_KEY\",\"model\":\"prelude/verify-check\",\"inputs\":{\"target\":{\"type\":\"phone_number\",\"value\":\"+1234567890\"},\"code\":\"123456\"}}"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