Get a pet song
get_pet_songThe state of a song made with create_pet_song: its status, lyrics, preview links, the checkout link once the preview is ready, and the HD video and gift page once paid and rendered. Poll it about every 15 seconds while the status is previewing, and every 30 seconds while paid or rendering. Follow next_step.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"song_id": "<song_id>"
},
"name": "get_pet_song"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| song_id | Yes | The id create_pet_song returned. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| tier | Yes | ||
| price | Yes | ||
| style | Yes | ||
| title | Yes | ||
| voice | Yes | ||
| lyrics | Yes | ||
| object | Yes | ||
| status | Yes | draft, previewing, preview_ready, preview_failed, paid, rendering, ready, render_failed or refunded. | |
| payment | Yes | ||
| species | Yes | ||
| language | Yes | ||
| occasion | Yes | ||
| pet_name | Yes | ||
| poll_url | Yes | ||
| ready_at | Yes | ||
| next_step | Yes | What to do next, for the assistant. | |
| photo_url | Yes | ||
| video_url | Yes | The HD MP4, once ready. | |
| created_at | Yes | ||
| duration_s | Yes | ||
| manage_url | Yes | ||
| checkout_url | Yes | Where the person pays for the HD video. Present once the preview is ready. | |
| credits_cost | Yes | ||
| relationship | Yes | ||
| gift_page_url | Yes | A page to send the recipient, once ready. | |
| thumbnail_url | Yes | ||
| recipient_name | Yes | ||
| credits_refunded | Yes | ||
| preview_clip_url | Yes | A 5 second watermarked clip of the pet singing. | |
| preview_audio_url | Yes | The whole song as an MP3, free to play. | |
| video_vertical_url | Yes | ||
| checkout_expires_at | Yes |