API Singing Pet
Singing Pet ma API REST. Szablony piosenek i cennik są otwarte dla każdego. Wszystko, co dotyka filmów, kredytów albo płatności konkretnej osoby, wymaga tokenu Firebase.
Specyfikacja OpenAPI
Czytelny maszynowo opis całego API, z unikalnym operation id, typowanymi parametrami i schematem odpowiedzi dla każdego endpointu. Skieruj na niego generator klienta albo loader function callingu swojego agenta.
Zobacz specyfikację OpenAPIhttps://singing.pet/openapi.json
Uwierzytelnianie
Wyślij ID token z Firebase Authentication jako bearer token. Logowanie przez Google albo linkiem e-mail na tej stronie tworzy taki token. Endpointy oznaczone jako publiczne nie potrzebują żadnego nagłówka.
Endpointy
https://api.singing.pet
| GET | / | getServiceIndex | Publiczny |
| GET | /openapi.json | getOpenApiSpec | Publiczny |
| GET | /health | getHealth | Publiczny |
| GET | /templates | listTemplates | Publiczny |
| GET | /subscription/pricing | getPricing | Publiczny |
| 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 | Publiczny |
| 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 |
Przykładowe żądanie
curl https://api.singing.pet/templates
curl https://api.singing.pet/user/videos?page=1 \
-H "Authorization: Bearer $FIREBASE_ID_TOKEN"Błędy
Każdy błąd wraca jako JSON. To, czego nie obsługuje konkretny endpoint, korzysta z jednej koperty ze stałym kodem, czytelnym komunikatem i podpowiedzią, co zrobić dalej.
{
"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"
}Piosenki o zwierzakach
POST /v1/songs zamienia zdjęcie zwierzaka i kilka szczegółów w spersonalizowaną piosenkę: tekst, nagraną ścieżkę i darmowy podgląd, w którym zwierzak śpiewa. Odpytuj GET /v1/songs/:id. Gdy podgląd jest gotowy, piosenka zawiera link do płatności, pod którym można kupić wideo w HD i stronę prezentu do udostępnienia. Możesz też wysłać payment: "credits", aby wydać 100 kredytów (Standard) lub 200 (Deluxe) i od razu wyrenderować wideo.
Kredyty
Klucz zaczyna się bez kredytów: kup pakiet na stronie kluczy API (10 za $54.99, 50 za $269, 250 za $1,299). Filmy opłacone zakupionymi kredytami nigdy nie mają znaku wodnego. Klucze są tworzone na stronie singing.pet/dashboard/api-keys.
Renderowanie jest asynchroniczne
Wywołanie tworzące odpowiada, gdy tylko render trafi do kolejki. Odpytuj listUserVideos, aż status zmieni się z pending na completed albo failed, albo słuchaj websocketu na wss://api.singing.pet.
Limity
Dźwięk musi trwać od 2 do 30 sekund, a film ma dokładnie taką samą długość jak dźwięk. Funkcja zamiany tekstu na mowę obsługuje do 500 znaków. Nie ma darmowych filmów: plan tygodniowy obejmuje 10 filmów tygodniowo, plan roczny 5 miesięcznie, a 7-dniowy okres próbny 3.
Markdown dla agentów
Każda strona z treścią serwuje czysty Markdown, jeśli poprosisz o niego nagłówkiem Accept, zgodnie z acceptmarkdown.com. Ręcznie pisany indeks strony leży w llms.txt.