OpenAI: Whisper 1
Whisper 1 מתמלל קובץ שמע שהושלם לטקסט, עם זיהוי רב־לשוני וחותמות זמן למילים או למקטעים. היצרן תומך בפורמטי כתוביות ובתהליך נפרד לתרגום לאנגלית; תוצאת התמלול משמרת את שפת ההקלטה.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Whisper 1 הוא מודל ה־API הכללי לזיהוי דיבור של OpenAI, המתועד כמופעל באמצעות מודל הקוד הפתוח Whisper V2. הוא מקבל קובץ שמע ומחזיר טקסט. היצרן מתאר זיהוי רב־לשוני, זיהוי שפה ומשימת תרגום דיבור נפרדת. התמלול משמר את השפה המדוברת; ממשק התרגום הנפרד של היצרן מחזיר טקסט באנגלית.
שימוש מועיל הוא הכנת ראיון, הודעה קולית או שיחה מוקלטת לחיפוש ולעריכה בהמשך. ספקו את ההקלטה שהושלמה, ואת שפת הקלט שלה כאשר היא ידועה. OpenAI מתעדת 98 שפות נתמכות ומציינת שדיוק הזיהוי משתנה לפי השפה. רמז השפה היחיד משתמש בקוד ISO 639-1; שדות ריבוי השפות ומילות המפתח החדשים יותר במודלי תמלול אחרים הם בקרות נפרדות.
תהליך תמלול הקבצים של היצרן מקבל קבצים בגודל של עד 25 MB בפורמט MP3, MP4, MPEG, MPGA, M4A, WAV או WebM. להקלטה גדולה יותר השתמשו בפורמט דחוס או חלקו למקטעים העומדים במגבלה. שמרו על גבולות המשפטים ועל סדר המקטעים כדי שהתמליל המורכב יישאר מחובר להקלטה המקורית. מכולת וידאו מספקת את השמע שלה למשימה הזאת, ואינה קלט לתיאור חזותי.
הנחיה יכולה לספק שמות, ראשי תיבות או אוצר מילים ייחודי להקלטה והקשר ממקטע קודם. מגבלת ההנחיה של Whisper היא 224 טוקנים, והיא צריכה להתאים לשפת השמע. היצרן מציין ש־Whisper אינו פועל לפי הוראות כמו מודל טקסט כללי. השתמשו בהנחיה כהקשר תמלול רלוונטי, ואז בדקו איותים חשובים מול ההקלטה במקום להתייחס לרשימת מונחים כאל מילים שהדובר בהכרח אמר.
היצרן מתעד פורמטי תמלול JSON, טקסט פשוט, SRT, VTT ו־JSON מפורט. חותמות זמן למילים ולמקטעים דורשות JSON מפורט; ניתן לבקש אחת מרמות הפירוט או את שתיהן. תיעוד ה־API מציין שחותמות זמן למקטעים אינן מוסיפות השהיה, ואילו חותמות זמן למילים דורשות עיבוד נוסף. הפלטים תומכים ביצירת כתוביות ובאיתור קטעים במהלך עריכה; הערות הפרדה לדוברים שייכות למודל ייעודי אחר.
Whisper 1 אינו תומך בהזרמה בתמלול קבצים. התיעוד שלו מתאר גם טמפרטורת דגימה בין אפס לאחת; באפס, המודל יכול להעלות טמפרטורה אוטומטית כאשר ספי הפענוח שלו דורשים זאת. הדבר מתאר את בקרות העיבוד של היצרן, ואינו הבטחה שכל הקלטה תפיק תמליל זהה או מדויק לחלוטין.
הגדירו את התוצר הסופי: תמליל לחיפוש, קובץ כתוביות או טקסט עם תזמון מילים או מקטעים. שמרו לצד התוצאה את ההקלטה המקורית, את סדר המקטעים ואת הפניות זמן המקור הרלוונטיות. שלב עריכת טקסט מאוחר יותר יכול לתקן איות שגוי או להכין סיכום, אך השוו את השינויים לשמע כדי לשמר את משמעות דברי הדובר. הטקסט המזוהה נעשה ראיה למשימה הבאה, ולא תשובה שנוצרה לשאלה שנאמרה בקול.
Ailoot Ultra · זיהוי דיבור POST /v1/audio/transcriptions openai/whisper-1
openai/whisper-1התחלה
Whisper 1 מתמלל קובץ שמע שהושלם לטקסט, עם זיהוי רב־לשוני וחותמות זמן למילים או למקטעים. היצרן תומך בפורמטי כתוביות ובתהליך נפרד לתרגום לאנגלית; תוצאת התמלול משמרת את שפת ההקלטה.
- סוגי קלט נתמכים
- שמע
- תוצאות
- transcription
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · זיהוי דיבור POST /v1/audio/transcriptions
- סוגי קלט
audio- סוגי פלט
transcription- פורמט פלט
- json
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות openai/whisper-1 | ברירת מחדל— |
שדהfile | סוגfile | דרישהחובה | ערכים ומגבלות סוג תוכן: multipart/form-data | ברירת מחדל— |
שדהresponse_format | סוגstring | דרישהרשות | ערכים ומגבלות json | ברירת מחדל— |
שדהinput_audio.data | סוגbase64_string | דרישהחובה | ערכים ומגבלות חל כאשר: קלט JSON של WhisperOR | ברירת מחדל— |
שדהinput_audio.format | סוגstring | דרישהחובה | ערכים ומגבלות wav, mp3, flac, ogg, m4a, webm חל כאשר: קלט JSON של WhisperOR | ברירת מחדל— |
שילובים של חומרי קלט
· נדרש: model, file
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontours | מפרט{"content_types":["application/json","multipart/form-data"],"required_json":["model","input_audio.data","input_audio.format"],"required_multipart":["model","file"],"file_formats":["wav","mp3","flac","ogg","m4a","webm"],"response_format_optional":["json"]}, {"content_types":["multipart/form-data"],"required":["model","file"],"file_formats":["mp3"],"response_format_option":false} |
פרמטרmax_bytes | מפרט26214400 |
פרמטרmaterial_types | מפרטaudio |
מחזור חיים: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · ערך task_id שהוחזר בפועל או רשומה בספריית המדיה
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
יש להשתמש בהקלטה ממשית ובפורמט תואם.
יש לשמור את התמליל המלא, המקטעים, מזהי הדוברים והתזמון.
תעריפים
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפי Ailoot
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | יחידת חיוב | חיוב |
|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | יחידת חיוב— | חיוב קלט · טוקני קלט — / 1K טוקנים פלט · טוקני פלט — / 1K טוקנים קלט · קריאה מהמטמון — / 1K טוקנים קלט · כתיבה למטמון — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה — / 1K טוקנים |
| תצורהשניית שמע בקלט | טבלת תעריפים— | יחידת חיובלכל שניית שמע בקלט | חיוב קלט · שניית שמע בקלט $0.0002 לכל שניית שמע בקלט |
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
OpenAI: Whisper 1
מחירים לפי תצורה
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהOpenAI: Whisper 1 · תצורת ברירת המחדל | תנאי חיובתצורת ברירת מחדל | חיוב קלט · שניות שמע בקלט 0.0002 $ לכל שניית שמע בקלט |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · זיהוי דיבור
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_AUDIO_FILE:?Set the path to your actual MP3 recording}"
export AILOOT_AUDIO_FILE
python3 - <<'PY_REQUEST'
import os
from pathlib import Path
p=Path(os.environ["AILOOT_AUDIO_FILE"])
if not p.is_file() or p.suffix.lower()!=".mp3":raise SystemExit("Choose an existing MP3 recording")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/transcriptions \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--form-string model=openai/whisper-1 -F "file=@$AILOOT_AUDIO_FILE" \
-D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("result.json").read_text())))
PY_RESULT
קבלה ושמירה של תוצאות
Ailoot Ultra · זיהוי דיבור
json
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
קריאות תוכן נוספות
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_MEDIA_TASK_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-task.json").read_text())))
PY_RESULT
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_ASSET_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-asset.json").read_text())))
PY_RESULT
שמירת כל התוצאות שהושלמו
שמרו כל תגובה מלאה, קובץ ומקטע תוכן שהוחזרו.
יש לשמור JSON מלא, ולא רק טקסט; יש לשמר כל מקטע, דובר וחותמת זמן זמינים ואת זהות המשימה או הנכס בפועל.
כשצריך לבדוק את התגובה המקורית
שמרו את operation_id/X-Client-Request-ID המקורי לצורך התאמת רישומים ללא שליחה מחדש; אין נתיב ייעודי לתשאול סטטוס אודיו.
שדות התגובה
| שדה | סוג |
|---|---|
שדהtext | סוגstring |
שדהsegments[] | סוגobject |
שדהtask_id | סוגstring |
שדהasset_url | סוגstring |
שדהusage | סוגobject |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה400 · invalid_request_error | תנאישדות נדרשים, ייצוג חומר או ערך פרמטר שאינם תקינים | השלב הבאתקנו את השדות שצוינו לפני בקשת יצירה חדשה. |
תגובהserver_error | תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה | השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה. |
כינויים
כינויים למודל
Ailoot Ultra openai/whisper-1
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · OpenAI: Whisper 1
- אילו קלטים ותוצאות זמינים?
POST /v1/audio/transcriptions·openai/whisper-1:audio→transcription- באילו שדות הבקשה משתמשת?
POST /v1/audio/transcriptions·openai/whisper-1:model,file,response_format