How mir-ashiq/vibesai-api works
vibes-api is an unofficial Python client and REST/CLI interface to Vibes.ai’s private API. The main workflow is to authenticate with a session cookie, manage a project, submit generation or editing requests, poll batches where needed, and download or export results. The client also exposes studio, media, collaboration, timeline, and account capabilities. The sampled files show the CLI and REST server delegating to the client, but do not expose every client method’s internal call path; the capability branches below therefore share the client implementation path.
Main entry points: client.py Vibes client · tts_fallback.py Speech synthesis · app.py REST server · cli.py Command line
Components 21
User interfaces
- Command line
vibes_api/cli.py - REST server
server/app.py
Generation lifecycle
- Vibes client
vibes_api/client.py - Auth and projects
vibes_api/client.py - Generation and edits
vibes_api/client.py - Batch polling
vibes_api/client.py
Studio and media
- Media uploads
vibes_api/client.py - Media library
vibes_api/client.py - Ingredients
vibes_api/ingredients.py - API models
vibes_api/models.py - Moodboards and music
vibes_api/client.py - Sharing and sync
vibes_api/client.py - Collaboration and account
vibes_api/client.py
Timeline and speech
- Composition builder
vibes_api/composition.py - Timeline chat and export
vibes_api/client.py - Speech synthesis
vibes_api/tts_fallback.py
Other components
- CLI user
- REST caller
- Vibes.ai API
- Edge TTS
- Google Translate TTS
Connections 22
- CLI user → Command line: runs commands
vibes_api/cli.py - Command line → Vibes client: invokes methods
vibes_api/cli.py - REST caller → REST server: calls endpoints
server/app.py - REST server → Vibes client: delegates requests
server/app.py - Vibes client → Vibes.ai API: sends API requests
vibes_api/client.py - Vibes client → Auth and projects: implements
README.md - Vibes client → Generation and edits: implements
README.md - Vibes client → Batch polling: implements
README.md - Vibes client → Media uploads: implements
README.md - Vibes client → Media library: implements
README.md - Vibes client → Moodboards and music: implements
README.md - Vibes client → Sharing and sync: implements
README.md - Vibes client → Collaboration and account: implements
vibes_api/__init__.py - Vibes client → Ingredients: uses helpers
vibes_api/client.py - Ingredients → API models: uses types
vibes_api/ingredients.py - Composition builder → Vibes client: serializes for saving
vibes_api/composition.py - Vibes client → Composition builder: exports timeline
README.md - Vibes client → Timeline chat and export: implements
README.md - REST server → Speech synthesis: calls synthesis
server/app.py - Vibes client → Speech synthesis: uses fallback
vibes_api/client.py - Speech synthesis → Edge TTS: falls back to
- Speech synthesis → Google Translate TTS: falls back to