Streaming API

Stream output chunks in real-time as the model generates them. This is useful for supported text-to-speech, music, and streaming model endpoints.

Note: A streaming request is authenticated, billed, and associated with a prediction. Capture the streamed data you need and avoid blindly replaying the POST after an ambiguous disconnect.

Endpoint

POST https://api.wavespeed.ai/api/v3/{model_id}/stream

Add /stream to a model endpoint that explicitly supports streaming. The request payload uses that model’s normal input schema; the /stream path selects streaming mode, not a stream field in the JSON body.

Request

curl --fail-with-body --no-buffer --connect-timeout 10 --max-time 600 \
-X POST "https://api.wavespeed.ai/api/v3/minimax/speech-02-turbo/stream" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "text": "Hello world! This is a test of the text-to-speech system.",
  "voice_id": "Energetic_Girl",
  "emotion": "happy",
  "speed": 1,
  "volume": 1
}'

Response

The response is an event stream (text/event-stream). Chunks are relayed from the upstream model as SSE data: events.

• Stream closes when the provider finishes
• Terminal status payload (if any) is included in the stream
• Event JSON is model-specific; consult the selected model’s schema and do not assume progress-percentage events are present

Supported Models

Requests to /stream for unsupported models will return an error.

Notes

• Your client must support Server-Sent Events (SSE) or chunked responses
• Authentication, rate limits, and billing are the same as non-streaming endpoints
• Use stream=True in Python requests to consume the HTTP response incrementally; do not add "stream": true to the model input unless that model’s schema separately defines it
• The server terminates a stream after 10 minutes without output