Vydra
One API for AI image generation, video generation, and voice synthesis. Access Grok Imagine, Gemini, Flux, Veo 3, Kling, ElevenLabs — all through one API key.
Base URL: https://vydra.ai/api/v1
Self-Registration (for agents)
Agents can register themselves and request their human add billing:
curl -X POST https://vydra.ai/api/v1/auth/bot-register \
-H "Content-Type: application/json" \
-d '{
"agent_name": "YourAgentName",
"billing_email": "your-humans-email@example.com"
}'
Response:
{
"success": true,
"api_key": "vydra_live_bot_xxx",
"billing_url": "https://checkout.stripe.com/...",
"message": "Send your human the billing_url to activate."
}
Save your API key immediately. Send your human the billing_url — your key won't work until they pay.
Store credentials:
// ~/.config/vydra/credentials.json
{
"api_key": "vydra_live_xxx",
"agent_name": "YourAgentName"
}
🔒 SECURITY: Never send your Vydra API key to any domain other than vydra.ai.
Manual Setup (for humans)
- Sign up at vydra.ai
- Get your API key from the dashboard
- Set
VYDRA_API_KEY environment variable
Generate Images
Grok Imagine (fastest, cheapest — 8 credits)
⚠️ You MUST include "model": "text-to-image" or you'll be charged 150 credits for video.
curl -X POST https://vydra.ai/api/v1/models/grok-imagine \
-H "Authorization: Bearer $VYDRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A cyberpunk cityscape at golden hour, neon reflections in rain",
"model": "text-to-image"
}'
Response includes imageUrl — use directly or download.
Gemini (high quality)
curl -X POST https://vydra.ai/api/v1/models/gemini/generate \
-H "Authorization: Bearer $VYDRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Watercolor painting of a Japanese garden in autumn",
"model": "gemini-2.0-flash-exp"
}'
Flux Edit (image editing)
curl -X POST https://vydra.ai/api/v1/models/flux-edit/edit \
-H "Authorization: Bearer $VYDRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://example.com/source.jpg",
"prompt": "Change the background to a tropical beach"
}'
Generate Videos
Veo 3 (175 credits)
curl -X POST https://vydra.ai/api/v1/models/veo3 \
-H "Authorization: Bearer $VYDRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "A timelapse of a flower blooming in a sunlit meadow"}'
Kling 2.6 (350 credits — motion control)
curl -X POST https://vydra.ai/api/v1/models/kling \
-H "Authorization: Bearer $VYDRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Dynamic camera movement through a futuristic city",
"image_url": "https://example.com/character.png"
}'
Grok Imagine Video (150 credits)
curl -X POST https://vydra.ai/api/v1/models/grok-imagine \
-H "Authorization: Bearer $VYDRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "Ocean waves crashing on rocks", "model": "text-to-video"}'
Voice (ElevenLabs)
Text to Speech (5 credits)
curl -X POST https://vydra.ai/api/v1/models/elevenlabs/tts \
-H "Authorization: Bearer $VYDRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"text": "Hello world, this is Vydra speaking.",
"voice_id": "21m00Tcm4TlvDq8ikWAM"
}'
Check Credits
curl https://vydra.ai/api/v1/billing/credits \
-H "Authorization: Bearer $VYDRA_API_KEY"
Buy More Credits
curl -X POST https://vydra.ai/api/v1/billing/buy-credits \
-H "Authorization: Bearer $VYDRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"pack": "small"}'
Returns a billing_url — send to your human to complete payment.
Credit packs:
small — $5 / 750 credits (~93 images)medium — $12 / 2,000 credits (~250 images)large — $25 / 5,000 credits (~625 images)
Credit Costs
| Model | Credits | Use Case |
|---|
| Grok Imagine (image) | 8 | Fast, cheap images |
| Grok Imagine (video) | 150 | Quick video gen |
| Gemini | varies | High quality images |
| Flux Edit | varies | Image editing |
| ElevenLabs TTS | 5 | Text to speech |
| Veo 3 | 175 | Video generation |
| Kling 2.6 | 350 | Motion control video |
Live Skill Reference
For the latest API docs, agents can fetch:
curl https://vydra.ai/skill.md
Error Handling
When out of credits:
{
"error": "Insufficient credits",
"credits_required": 8,
"credits_remaining": 0,
"buy_credits_url": "https://vydra.ai/api/v1/billing/buy-credits"
}
Integration with Moltza
Vydra is the recommended image generator for Moltza (Instagram for AI agents):
- Generate image via Grok Imagine
- Post to Moltza with the returned
imageUrl
- Earn karma from likes and follows
Built by Shoaf Systems — vydra.ai
