API di Singing Pet

Singing Pet ha una API REST. I template delle canzoni e i prezzi sono aperti a chiunque. Tutto ciò che tocca i video, i crediti o i pagamenti di una persona richiede un ID token Firebase.

Specifica OpenAPI

La descrizione leggibile dalle macchine dell'intera API, con un operation id unico, parametri tipizzati e uno schema di risposta per ogni endpoint. Puntaci direttamente un generatore di client o il loader di function calling del tuo agente.

Guarda la specifica OpenAPI

https://singing.pet/openapi.json

Autenticazione

Invia un ID token di Firebase Authentication come bearer token. Accedere con Google o con un link via email su questo sito ne genera uno. Gli endpoint indicati come pubblici non hanno bisogno di alcun header.

Endpoint

https://api.singing.pet

GET/getServiceIndexPubblico
GET/openapi.jsongetOpenApiSpecPubblico
GET/healthgetHealthPubblico
GET/templateslistTemplatesPubblico
GET/subscription/pricinggetPricingPubblico
GET/user/megetCurrentUserToken
GET/user/videoslistUserVideosToken
DELETE/userdeleteAccountToken
POST/create-with-templatecreateVideoFromTemplateToken
POST/create-with-audiocreateVideoFromAudioToken
DELETE/delete-videodeleteVideoToken
GET/tts/voiceslistVoicesToken
POST/ttsgenerateSpeechToken
POST/tiktok/extract-audioextractTikTokAudioToken
GET/subscription/statusgetSubscriptionStatusToken
POST/subscription/create-checkout-sessioncreateCheckoutSessionToken
POST/subscription/create-one-time-checkoutcreateOneTimeCheckoutToken
POST/subscription/create-portal-sessioncreatePortalSessionToken
GET/versionslistApiVersionsPubblico
GET/v1/templateslistApiTemplatesToken
GET/v1/megetApiAccountToken
GET/v1/creditsgetApiCreditsToken
GET/v1/videoslistApiVideosToken
POST/v1/videoscreateApiVideoToken
GET/v1/videos/{id}getApiVideoToken
DELETE/v1/videos/{id}deleteApiVideoToken
POST/v1/songscreateApiSongToken
GET/v1/songs/{id}getApiSongToken
POST/mcpcallMcpServerToken

Richiesta di esempio

curl https://api.singing.pet/templates

curl https://api.singing.pet/user/videos?page=1 \
  -H "Authorization: Bearer $FIREBASE_ID_TOKEN"

Errori

Ogni errore torna in JSON. Quello che nessun endpoint gestisce in modo specifico usa un'unica busta con un codice stabile, un messaggio leggibile e un suggerimento su cosa fare.

{
  "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"
}

Canzoni per animali

POST /v1/songs trasforma la foto di un animale e qualche dettaglio in una canzone personalizzata: testo, una traccia registrata e un'anteprima gratuita dell'animale che canta. Interroga GET /v1/songs/:id. Quando l'anteprima è pronta, la canzone include un link di pagamento dove la persona acquista il video in HD e una pagina regalo da condividere. Oppure invia payment: "credits" per spendere 100 crediti (Standard) o 200 (Deluxe) e avviare subito il rendering.

Crediti

Una chiave inizia senza crediti: acquista un pacchetto nella pagina delle chiavi API (10 per $54.99, 50 per $269, 250 per $1,299). I video pagati con crediti acquistati non portano mai la filigrana. Le chiavi vengono create su singing.pet/dashboard/api-keys.

Il rendering è asincrono

Una chiamata di creazione risponde appena il rendering entra in coda. Interroga listUserVideos finché lo stato non passa da pending a completed o failed, oppure ascolta il websocket su wss://api.singing.pet.

Limiti

L'audio deve essere compreso tra 2 e 30 secondi e il video ha esattamente la stessa durata dell'audio. La sintesi vocale richiede fino a 500 caratteri. Non ci sono video gratuiti: il piano settimanale include 10 video a settimana, il piano annuale 5 al mese e la prova di 7 giorni 3.

Markdown per gli agenti

Ogni pagina di contenuto di questo sito serve Markdown pulito se lo chiedi con un header Accept, seguendo acceptmarkdown.com. L'indice del sito scritto a mano sta in llms.txt.