dograh/docs
Tararais a2240db45a
feat(tts): add xAI as a Voice (TTS) provider (#476)
* feat(tts): add xAI as a Voice (TTS) provider

pipecat already ships an xAI TTS service (XAITTSService, WebSocket
streaming) but dograh never wired it into the service configuration, so
xAI could not be selected as a Voice provider in the cascading pipeline.

Wire it through:
- registry: ServiceProviders.XAI + XAITTSConfiguration (voices
  eve/ara/leo/rex/sal, language, computed model) registered in TTSConfig
- service_factory: build XAITTSService in create_tts_service
- check_validity: api-key validation hook
- tests for the factory + docs

The Voice provider dropdown is schema-driven, so xAI appears with no UI
changes.

* fix(tts): validate xAI API key and drop misleading auto-language hint

Addresses review feedback on the xAI Voice provider:

- check_validity: replace the no-op xAI key check with real validation
  against xAI's OpenAI-compatible API (models.list on https://api.x.ai/v1),
  so a bad BYOK key is caught at configuration time instead of at call time.
- registry: remove the "auto" language hint from the field description.
  pipecat's Language enum has no "auto" member, so the factory fell back to
  English silently; the description no longer advertises detection we don't do.
- tests: cover xAI key validation (registered, accepts valid, rejects bad).

* fix(tts): validate xAI key against the TTS voices endpoint

xAI supports endpoint-scoped API keys, so a key scoped to Text-to-Speech
may lack the /v1/models ACL and would be wrongly rejected by the previous
models.list() check. Validate against GET /v1/tts/voices instead — the
scope the key actually needs for TTS — treating 401/403 as an invalid key
and connection errors as a clean, actionable message.

* fix: harden xAI TTS integration

---------

Co-authored-by: Sabiha Khan <sabihak89@gmail.com>
Co-authored-by: Sabiha Khan <87858386+chewwbaka@users.noreply.github.com>
2026-07-08 09:05:43 +05:30
..
api-reference feat(tts): add xAI as a Voice (TTS) provider (#476) 2026-07-08 09:05:43 +05:30
configurations feat(tts): add xAI as a Voice (TTS) provider (#476) 2026-07-08 09:05:43 +05:30
contribution docs: fix dead entry points, add first-agent tutorial, explain unexplained features (#489) 2026-07-02 12:47:48 +05:30
core-concepts docs: add missing cross-links for machine and human readability (#492) 2026-07-02 21:10:32 +05:30
deployment docs: fix dead entry points, add first-agent tutorial, explain unexplained features (#489) 2026-07-02 12:47:48 +05:30
developer docs: add missing cross-links for machine and human readability (#492) 2026-07-02 21:10:32 +05:30
getting-started docs: fix dead entry points, add first-agent tutorial, explain unexplained features (#489) 2026-07-02 12:47:48 +05:30
images docs: update Tuner integration to use Dograh provider (#457) 2026-06-19 22:41:40 +05:30
integrations chore: fix documentation for agent stream 2026-07-07 14:28:29 +05:30
logo chore: Update README and add Mintlify docs 2025-10-04 15:05:07 +05:30
sdks feat: refactor node spec and add mcp tools (#244) 2026-04-21 07:56:16 +05:30
voice-agent docs: add missing cross-links for machine and human readability (#492) 2026-07-02 21:10:32 +05:30
AGENTS.md chore: refactor AGENTS.md 2026-05-20 15:56:52 +05:30
CLAUDE.md chore: refactor AGENTS.md 2026-05-20 15:56:52 +05:30
custom.css style(docs): add custom green scrollbar (#434) 2026-06-20 15:10:08 +05:30
docs.json docs: fix dead entry points, add first-agent tutorial, explain unexplained features (#489) 2026-07-02 12:47:48 +05:30
favicon.ico chore: Update README and add Mintlify docs 2025-10-04 15:05:07 +05:30
README.md chore: Update README and add Mintlify docs 2025-10-04 15:05:07 +05:30

Dograh AI Documentation

Local Setup

  1. Install mintlify npm i -g mint
  2. Clone the repository
  3. cd dograh/docs and run mint dev