skillboss-5
v1.0.0Swiss-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.
Installation
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":"[email protected]","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