Write a song for a pet
create_pet_songWrite and record a custom song about a pet from one photo, then make a short preview of the pet singing it. Use it when someone wants a personalised song or singing video of their own pet, for themselves or as a gift (birthday, Christmas, Mother's Day, gotcha day...). Needs a photo (image_url, or the attached photo), the pet's name, species and the occasion; ask for anything missing rather than inventing it. The preview (the whole song plus a 5 second singing clip) is free and takes one to two minutes; the HD video of the pet singing the whole song is bought at the checkout link that appears once the preview is ready. Returns at once with the song id and status previewing.
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": {
"pet_name": "<pet_name>",
"species": "<species>",
"occasion": "<occasion>"
},
"name": "create_pet_song"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | standard (768p) or deluxe (1080p). Only changes the paid HD video and its price or credit cost. | |
| photo | No | A photo the person attached in the chat. ChatGPT fills this in; other clients send image_url. | |
| style | No | Musical style. Defaults to pop. | |
| voice | No | The singing voice. Defaults to female. | |
| details | No | Quirks, nicknames, favourite toys or habits, up to 300 characters. They make the lyrics personal. | |
| payment | No | checkout (default): the preview is free and the person buys the HD video at a checkout link. credits: spend this account's API credits (100 for a standard song, 200 for deluxe) and render the HD video straight after the preview with no checkout. Only for developers who have bought credits; refused otherwise. | |
| species | Yes | What the pet is: dog, cat, rabbit, parrot... | |
| language | No | Language the song is sung in. Defaults to the conversation's language, else English. | |
| occasion | Yes | What the song is for. | |
| pet_name | Yes | The pet's name, as it should be sung. | |
| image_url | No | Public URL to a photo of the pet: one pet, facing the camera, well lit. JPEG, PNG, WebP or HEIC, up to 15MB. Send this or photo. | |
| relationship | No | Who the recipient is to the person buying it. 'myself' when it is for them. | |
| recipient_name | No | Who the song is for, if it is a gift for someone else. Their first name is sung. |
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 |