תמלול, דוברים וכתוביות,
בתוך המוצר שלכם.

יצירת Login token

שולחים שם משתמש וסיסמה ומקבלים JWT לשימוש בכותרת Authorization.

curl -X POST https://skyvoice.info/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"YOUR_USER","password":"YOUR_PASSWORD"}'

תמלול קובץ

בקשת multipart/form-data עם השדה file. התגובה כוללת טקסט, חותמות זמן ו‑speakerId כאשר זוהו דוברים. השדה האופציונלי temporary קובע אם התוצאה תישמר בהיסטוריה.

mode=speech לדיבור רגיל, או mode=music להפרדת הקול מהליווי ותמלול מילים מושרות (עד 180 שניות ו־25 MiB). language=he לעברית או auto לזיהוי שפה. diarize=true מפעיל הפרדה לדוברים. מוזיקה ללא קול אינה תמלול מילולי; שמות הדוברים אינם מזוהים.

בדקו diarizationStatus ו־warnings בתגובה. speakerTurns מכיל את חלונות הדוברים. כשזוהו כמה דוברים ועד 32 חלונות, כל חלון מתומלל בנפרד (speakerAssignment=speaker_window_asr); אחרת השיוך מבוסס על חפיפת מקטעים (segment_overlap). אין כאן יישור מדויק של כל מילה או זיהוי זהות. vocalSeparation=htdemucs מאשר שמצב מוזיקה בוצע. מפתח API נשמר בצד השרת בלבד ונשלח בכותרת Authorization: Bearer.

מצב מוזיקה עובד בתור עיבוד יחיד ועלול להימשך מספר דקות. איכות מילים מושרות תלויה בהקלטה; ליווי מוזיקלי ודיבור נבדקו על קטעים סינתטיים, ולא הושלם מבחן איכות לשירה בעברית.

curl -X POST https://skyvoice.info/v1/transcribe \
  -H "Authorization: Bearer $SKYVOICE_API_KEY" \
  -F "file=@meeting.wav" \
  -F "temporary=false"

{
  "transcription": "Welcome. Thank you.",
  "speakerCount": 2,
  "segments": [
    {"text":"Welcome.","startMs":0,"endMs":1460,"speakerId":1},
    {"text":"Thank you.","startMs":1460,"endMs":2870,"speakerId":2}
  ],
  "diarization": "זוהו 2 דוברים...",
  "saved": true,
  "subscription": {"remaining": 499}
}

תמלול וסיכום דרך תור עמיד

לקבצים ארוכים או לעבודה מיישום שרת, שולחים multipart ומקבלים מיד מזהה עבודה. summarize=true מפעיל לאחר התמלול סיכום מובנה עם החלטות ומשימות. אפשר גם לשלוח טקסט שכבר תומלל אל POST /v1/jobs/summaries.

curl -X POST https://skyvoice.info/v1/jobs/transcriptions \
  -H "Authorization: Bearer $SKYVOICE_API_KEY" \
  -F "file=@meeting.wav" \
  -F "summarize=true"

curl https://skyvoice.info/v1/jobs/$JOB_ID \
  -H "Authorization: Bearer $SKYVOICE_API_KEY"

יצירת SRT או WebVTT

מעבירים format=srt ל-Premiere Pro או format=vtt לנגני Web. כאשר זוהה דובר, כל כתובית מקבלת תחילית כמו [דובר 2]. התגובה היא attachment מוכן לשמירה.

curl -X POST https://skyvoice.info/v1/captions \
  -H "Authorization: Bearer $SKYVOICE_API_KEY" \
  -F "file=@interview.wav" \
  -F "format=srt" \
  -o interview.srt

סטטוס חבילה ומכסה

מחזיר את התוכנית הפעילה, היתרה הנוכחית והרשאת השימוש ב-API.

curl https://skyvoice.info/v1/subscription/status \
  -H "Authorization: Bearer $SKYVOICE_API_KEY"

היסטוריה מסונכרנת

קוראים את היסטוריית המשתמש או מוחקים תוצאה. POST /v1/history/{id}/delete מוחק פריט ו-POST /v1/history/clear מנקה הכול. נתיבי DELETE נשמרים גם לתשתיות שמאפשרות אותם.