Singing Pet API

Singing Pet heeft een REST API. Nummersjablonen en prijzen staan open voor iedereen. Alles wat de video's, credits of facturatie van een persoon raakt, vraagt om een Firebase ID-token.

OpenAPI-specificatie

De machineleesbare beschrijving van de hele API, met een uniek operation id, getypeerde parameters en een responsschema per endpoint. Richt er een clientgenerator of de function-callingloader van je agent rechtstreeks op.

Bekijk de OpenAPI-spec

https://singing.pet/openapi.json

Authenticatie

Stuur een Firebase Authentication ID-token als bearer token. Inloggen met Google of via een e-maillink op deze site maakt er een aan. Endpoints die als publiek staan aangemerkt hebben helemaal geen header nodig.

Endpoints

https://api.singing.pet

GET/getServiceIndexPubliek
GET/openapi.jsongetOpenApiSpecPubliek
GET/healthgetHealthPubliek
GET/templateslistTemplatesPubliek
GET/subscription/pricinggetPricingPubliek
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/versionslistApiVersionsPubliek
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

Voorbeeldverzoek

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

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

Fouten

Elke fout komt terug als JSON. Wat geen specifiek endpoint afhandelt, gebruikt één envelop met een stabiele code, een leesbaar bericht en een hint over wat je nu moet doen.

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

Liedjes voor huisdieren

POST /v1/songs maakt van een foto van een huisdier en een paar details een persoonlijk liedje: songtekst, een opgenomen nummer en een gratis voorproefje waarin het dier zingt. Vraag GET /v1/songs/:id op. Zodra het voorproefje klaar is, bevat het liedje een betaallink waar de persoon de HD-video en een cadeaupagina om te delen koopt. Of stuur payment: "credits" om 100 credits (Standard) of 200 (Deluxe) uit te geven en meteen te renderen.

Credits

Een sleutel begint zonder credits: koop een pakket op de API-sleutelpagina (10 voor $54.99, 50 voor $269, 250 voor $1,299). Video's die met gekochte credits worden betaald, bevatten nooit een watermerk. Sleutels worden aangemaakt op singing.pet/dashboard/api-keys.

Renderen gaat asynchroon

Een create-aanroep antwoordt zodra de render in de wachtrij staat. Poll listUserVideos tot de status van pending naar completed of failed gaat, of luister op de websocket op wss://api.singing.pet.

Limieten

Audio moet tussen 2 en 30 seconden lang zijn en de video is exact even lang als de audio. Tekst-naar-spraak ondersteunt tot 500 tekens. Er zijn geen gratis video's: het wekelijkse abonnement bevat 10 video's per week, het jaarlijkse abonnement 5 per maand, en de proefperiode van 7 dagen 3.

Markdown voor agents

Elke contentpagina op deze site levert schone Markdown als je erom vraagt met een Accept-header, volgens acceptmarkdown.com. De met de hand geschreven site-index staat in llms.txt.