API do Singing Pet
O Singing Pet tem uma API REST. Os templates de música e os preços são abertos. Tudo o que toca os vídeos, os créditos ou a cobrança de uma pessoa exige um token do Firebase.
Especificação OpenAPI
A descrição legível por máquina de toda a API, com um operation id único, parâmetros tipados e um schema de resposta para cada endpoint. Aponte para ela um gerador de clientes ou o carregador de function calling do seu agente.
Ver a especificação OpenAPIhttps://singing.pet/openapi.json
Autenticação
Envie um ID token do Firebase Authentication como bearer token. Entrar com o Google ou com um link por email neste site gera um. Endpoints marcados como públicos não precisam de cabeçalho nenhum.
Endpoints
https://api.singing.pet
| GET | / | getServiceIndex | Público |
| GET | /openapi.json | getOpenApiSpec | Público |
| GET | /health | getHealth | Público |
| GET | /templates | listTemplates | Público |
| GET | /subscription/pricing | getPricing | Público |
| GET | /user/me | getCurrentUser | Token |
| GET | /user/videos | listUserVideos | Token |
| DELETE | /user | deleteAccount | Token |
| POST | /create-with-template | createVideoFromTemplate | Token |
| POST | /create-with-audio | createVideoFromAudio | Token |
| DELETE | /delete-video | deleteVideo | Token |
| GET | /tts/voices | listVoices | Token |
| POST | /tts | generateSpeech | Token |
| POST | /tiktok/extract-audio | extractTikTokAudio | Token |
| GET | /subscription/status | getSubscriptionStatus | Token |
| POST | /subscription/create-checkout-session | createCheckoutSession | Token |
| POST | /subscription/create-one-time-checkout | createOneTimeCheckout | Token |
| POST | /subscription/create-portal-session | createPortalSession | Token |
| GET | /versions | listApiVersions | Público |
| GET | /v1/templates | listApiTemplates | Token |
| GET | /v1/me | getApiAccount | Token |
| GET | /v1/credits | getApiCredits | Token |
| GET | /v1/videos | listApiVideos | Token |
| POST | /v1/videos | createApiVideo | Token |
| GET | /v1/videos/{id} | getApiVideo | Token |
| DELETE | /v1/videos/{id} | deleteApiVideo | Token |
| POST | /v1/songs | createApiSong | Token |
| GET | /v1/songs/{id} | getApiSong | Token |
| POST | /mcp | callMcpServer | Token |
Exemplo de requisição
curl https://api.singing.pet/templates
curl https://api.singing.pet/user/videos?page=1 \
-H "Authorization: Bearer $FIREBASE_ID_TOKEN"Erros
Toda falha volta em JSON. O que não é tratado por um endpoint específico usa um único envelope com um código estável, uma mensagem legível e uma dica sobre o que fazer.
{
"error": {
"code": "not_found",
"message": "No route matches GET /nope",
"status": 404,
"hint": "Check the path against https://singing.pet/openapi.json.",
"documentation_url": "https://singing.pet/developers"
},
"message": "No route matches GET /nope"
}Músicas de pets
POST /v1/songs transforma uma foto de pet e alguns detalhes em uma música personalizada: letra, uma faixa gravada e uma prévia grátis do pet cantando. Consulte GET /v1/songs/:id. Quando a prévia fica pronta, a música traz um link de pagamento onde a pessoa compra o vídeo em HD e uma página de presente para compartilhar. Ou envie payment: "credits" para gastar 100 créditos (Standard) ou 200 (Deluxe) e renderizar na hora.
Créditos
Uma chave começa sem créditos: compre um pacote na página de chaves de API (10 por $54.99, 50 por $269, 250 por $1.299). Vídeos pagos com créditos comprados nunca possuem marca d'água. As chaves são criadas em singing.pet/dashboard/api-keys.
A renderização é assíncrona
Uma chamada de criação responde assim que a renderização entra na fila. Consulte listUserVideos até o status sair de pending para completed ou failed, ou escute o websocket em wss://api.singing.pet.
Limites
O áudio deve ter entre 2 e 30 segundos e o vídeo tem exatamente a mesma duração do áudio. O text-to-speech aceita até 500 caracteres. Não há vídeos gratuitos: o plano semanal inclui 10 vídeos por semana, o plano anual 5 por mês, e o teste de 7 dias 3.
Markdown para agentes
Cada página de conteúdo deste site serve Markdown limpo quando você pede com um cabeçalho Accept, seguindo o acceptmarkdown.com. O índice do site escrito à mão fica em llms.txt.