Announcements

Create a new announcement

POST

https://api.tunio.ai/v1/announcements

Create a new announcement for a stream

请求体

Announcement data

名称	类型	说明
background_uuid	string	BackgroundUUID optionally links a background track.
background_volume	number	BackgroundVolume defines background volume (0..1).
end_date	string	EndDate limits the latest playback date.
has_audio_warning	boolean	HasAudioWarning toggles an audible warning tone before playback.
messageRequired	string	Message contains the announcement text or TTS script (max 500 characters).
model_id	string	Model is the UUID of the TTS model used for generation. If omitted, a default is used.
speed	number	Speed optionally customizes playback speed multiplier.
start_date	string	StartDate limits the earliest playback date.
titleRequired	string	Title is the displayed announcement header (max 500 characters).

请求示例

01{
02  "background_uuid": "123e4567-e89b-12d3-a456-426614174001",
03  "background_volume": 0.3,
04  "end_date": "2024-12-31T23:59:59Z",
05  "has_audio_warning": false,
06  "message": "Today's weather will be sunny with temperatures reaching 25°C",
07  "model_id": "123e4567-e89b-12d3-a456-426614174000",
08  "speed": 1,
09  "start_date": "2024-01-15T14:30:00Z",
10  "title": "Daily Weather Update"
11}

响应

名称	类型	说明
announcement_id	string	UUID is the created announcement identifier.
success	boolean	Success signals the create finished successfully.

名称	类型	说明
message	string	Message contains human readable error details.
success	boolean	Success is always false for error payloads.

名称	类型	说明
message	string	Message contains human readable error details.
success	boolean	Success is always false for error payloads.

名称	类型	说明
message	string	Message contains human readable error details.
success	boolean	Success is always false for error payloads.

名称	类型	说明
message	string	Message contains human readable error details.
success	boolean	Success is always false for error payloads.