wiro-realtime-voicelisted
Install: claude install-skill wiroai/Wiro-Plugin
# Wiro Realtime Voice
A Wiro realtime model keeps a session open. One REST call starts a task, then raw PCM audio and JSON events flow over a WebSocket until the session ends. For the REST basics (auth headers, model search, prices, task lookup), use the `wiro-ai` skill.
## When to use it
| Mode | Client sends | Server sends | Good for |
| --- | --- | --- | --- |
| Voice conversation | Microphone audio | AI audio, plus `TRANSCRIPT_USER:` and `TRANSCRIPT_AI:` text | Voice assistants, interactive voice chat |
| Text-to-speech | Text in the Run call, no microphone | AI audio only | Narration, voiceover, assistants |
| Speech-to-text | Microphone audio | `TRANSCRIPT_USER:` text only, no audio | Live dictation, captioning, meeting transcription |
For a finished audio file rather than a live stream, a standard text-to-speech model through Run fits better (see `wiro-ai`).
## Start a session
1. Pick a model and read its parameters with `POST /Tool/Detail`. They differ per model.
2. From server-side code (see Credentials in apps), create the task with `POST https://api.wiro.ai/v1/Run/{owner}/{model}`. Use this asynchronous Run; the `/sync` variant is for finite models.
3. Open `wss://socket.wiro.ai/v1` and register with `task_info`.
4. Wait for `task_stream_ready`. Send no audio before it.
5. Stream microphone frames, play the audio frames that come back, or both.
6. Send `task_session_end`, wait for `task_postprocess_end`, then close the socket.
Run body for `openai/gpt-realti