Announcements

Get an announcement

GET

https://api.tunio.ai/v1/announcements/{announcement_id}

Get a single announcement by UUID

路径参数

名称	类型	说明
announcement_idRequired	string	Announcement ID

响应

名称	类型	说明
announcement	object	Announcement provides the requested announcement data.
announcement_id	string	UUID uniquely identifies the announcement.
background_uuid	string	BackgroundUUID references selected background track.
background_volume	number	BackgroundVolume stores chosen background volume (0..1).
created_at	string	CreatedAt is when the announcement was created.
end_date	string	EndDate optionally defines when playback must end.
has_audio_warning	boolean	HasAudioWarning tells whether to prepend alert audio.
message	string	Message stores the generated announcement text.
mix_uuid	string	MixUUID references the generated mix file UUID.
model_id	string	Model references the TTS model UUID used.
speed	number	Speed indicates final playback speed.
start_date	string	StartDate optionally defines when playback can start.
state	string	State describes the rendering state (queued/completed/etc).
title	string	Title shows the announcement title.
tts_audio_uuid	string	TTSAudioUUID references stored TTS audio for this announcement.
tts_duration	integer	TTSDuration stores generated TTS duration in seconds.
success	boolean	Success indicates retrieval succeeded.

名称	类型	说明
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.

GET/v1/announcements/{announcement_id}

01curl -X GET "https://api.tunio.ai/v1/announcements/{announcement_id}" \
02  -H "Authorization: Bearer YOUR_API_TOKEN"

200Success response with announcement

01{
02  "announcement": {
03    "announcement_id": "123e4567-e89b-12d3-a456-426614174002",
04    "background_uuid": "123e4567-e89b-12d3-a456-426614174001",
05    "background_volume": 0.3,
06    "created_at": "2024-01-15T14:30:00Z",
07    "end_date": "2024-12-31T23:59:59Z",
08    "has_audio_warning": false,
09    "message": "Today's weather will be sunny",
10    "mix_uuid": "123e4567-e89b-12d3-a456-426614174100",
11    "model_id": "123e4567-e89b-12d3-a456-426614174000",
12    "speed": 1,
13    "start_date": "2024-01-15T14:30:00Z",
14    "state": "completed",
15    "title": "Daily Weather Update",
16    "tts_audio_uuid": "123e4567-e89b-12d3-a456-426614174099",
17    "tts_duration": 10
18  },
19  "success": true
20}