ElevenLabs: Eleven Turbo v2
Eleven Turbo v2 הוא גרסת המרת הטקסט לדיבור באנגלית בלבד של ElevenLabs, המיועדת ליישומים קוליים המגיבים במהירות. הוא מקריא את הטקסט שסופק בקול שנבחר, ומתאים לתשובות של עוזרים, להתראות ולהסברים קצרים שהוכנו להאזנה.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Eleven Turbo v2 הוא מודל המרת הטקסט לדיבור באנגלית בלבד של ElevenLabs, ליישומים הזקוקים לתשובות קוליות מהירות. הוא מקבל את הטקסט המוכן של אמירה ומחזיר שמע בקול שנבחר. היצרן מבדיל בין Turbo v2 לבין Turbo v2.5 הרב־לשוני וקו Flash. תפקידו השימושי הוא תגובה קולית באנגלית, כגון אישור, הסבר קצר או ההנחיה הבאה בממשק שיחתי.
אנגלית היא גבול השפה המגדיר את הגרסה הזאת. הזנת שפה אחרת אינה מעניקה ל־Turbo v2 את הפרופיל הרב־לשוני של v2.5. בחרו קול בעל המבטא ואופן ההגשה הדרושים לתסריט באנגלית. קול חם ושיחתי, קריין מאופק ודמות נמרצת עשויים להעניק לאותו משפט צליל שונה, ולכן הקול שנבחר הוא חלק מהבריף ולא ברירת מחדל קבועה הנגזרת משם המודל.
הכינו תסריט נקי להקראה. המודל מסנתז את המילים שסופקו לו; הוא אינו קובע אם פעולה הצליחה ואינו מייצר את ההנמקה של היישום. בתשובת עוזר, כללו תוצאה אחת ברורה וצעד המשך טבעי. למשל, משפט יכול לאשר שמסמך התקבל ולבקש את מספר האסמכתה החסר שלו. השאירו הוראות פנימיות ומטא־נתונים מחוץ למילים המיועדות להאזנה, משום שגם טקסט תיאורי רגיל עלול להיות מוקרא.
שמות, קיצורים ומספרים דורשים הכנה מכוונת. כתבו מזהה כספרות נפרדות כאשר צריך לחזור עליו כך, ופתחו קיצור כאשר המאזין אמור לשמוע את משמעותו המלאה. לתאריך השתמשו בניסוח חד־משמעי להקראה. כינויי הגייה או איות חלופי יכולים לציין כיצד לבטא שם קשה. שמרו בנפרד את האיות המקורי לתצוגה ואת הצורה להקראה אם היישום מציג את ההודעה גם כטקסט.
הגדרות הקול של היצרן משפיעות על עקביות, דמיון וקצב. במדריך המוצר המשותף ל־TTS, הערך 1.0 בהגדרת המהירות משאיר אותה ללא שינוי, והטווח הוא 0.7 עד 1.2; התאמות קיצוניות עשויות להשפיע על התוצאה. יציבות משנה את השונות ואת הטווח הרגשי, ואילו דמיון שולט במידת הדמיון לקול שנבחר. בקרות אלה אינן הופכות את הסינתזה לדטרמיניסטית ואינן קובעות משך מדויק לשורה. פיסוק ומבנה של משפטים שלמים נשארים חשובים לאופן ההקראה.
מגבלת ה־API המדויקת של היצרן ל־Turbo v2 היא 30,000 תווים לבקשה. זוהי תקרת קלט ולא משך שמע קבוע; בהכנת טקסט ארוך יותר השתמשו במשפטים או במקטעים שלמים. משפחת פורמטי ה־TTS של ElevenLabs כוללת MP3 להאזנה כללית, PCM לא דחוס של 16 סיביות, קידודי טלפוניה כגון μ-law ו־A-law, ו־Opus. תהליך עבודה בהזרמה יכול להחזיר שמע בהדרגה, ואילו בקשת טקסט מלאה ניתנת לאיסוף כהקלטה. בחרו את הפלט בהתאם ליעד ההשמעה ושמרו את התסריט בפועל לצד השמע שנבחר. בהסבר ארוך יותר, חלקו את הטקסט בגבולות בעלי משמעות במקום לבקש מהמאזין לעקוב אחר רשימה ממושכת אחת.
לתשובת תמיכה מעשית באנגלית, הכינו את התוצאה המדויקת, שם או מזהה המבוטאים בבירור ואת הפעולה הבאה. בדקו את החלק הרלוונטי בהקלטה מבחינת מובנות, מבטא וקצב טבעי. היצרן מתעד פלט שאינו דטרמיניסטי, ולכן גם אותן הגדרות עשויות להפיק ביצוע מעט שונה. התוצר לשימוש חוזר הוא הקלטת הדיבור שנבחרה יחד עם הנוסח המוכן והגדרות הקול, עבור עוזר, התראה, הוראת הדרכה או הסבר מוקלט קצר.
Ailoot Ultra · הקראה POST /v1/audio/speech elevenlabs/eleven-turbo-v2
elevenlabs/eleven-turbo-v2התחלה
Eleven Turbo v2 הוא גרסת המרת הטקסט לדיבור באנגלית בלבד של ElevenLabs, המיועדת ליישומים קוליים המגיבים במהירות. הוא מקריא את הטקסט שסופק בקול שנבחר, ומתאים לתשובות של עוזרים, להתראות ולהסברים קצרים שהוכנו להאזנה.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- שמע
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · הקראה POST /v1/audio/speech
- סוגי קלט
text- סוגי פלט
audio- פורמט פלט
- mp3
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות elevenlabs/eleven-turbo-v2 | ברירת מחדל— |
שדהinput | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 אורך מרבי: 30,000 יחידה: תווי Unicode | ברירת מחדל— |
שדהvoice | סוגstring | דרישהחובה | ערכים ומגבלות george, sarah, adam, alice, bella, bill, brian, callum, charlie, chris, daniel, eric, harry, jessica, laura, liam, lily, matilda, river, roger, will | ברירת מחדל— |
שדהresponse_format | סוגstring | דרישהחובה | ערכים ומגבלות mp3 | ברירת מחדל— |
שילובים של חומרי קלט
text_to_speech · נדרש: input
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, input, voice, response_format |
פרמטרvoice_ids | מפרטgeorge, sarah, adam, alice, bella, bill, brian, callum, charlie, chris, daniel, eric, harry, jessica, laura, liam, lily, matilda, river, roger, will |
פרמטרresponse_format | מפרטmp3 |
פרמטרmax_input_characters | מפרט30000 |
פרמטרother_options | מפרטfalse |
פרמטרinput | מפרטטקסט UTF-8 מדויק; ספירת תווי Unicode ללא נרמול |
פרמטרmaterial_types | מפרטtext |
מחזור חיים: 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.00008 לכל תו בקלט |
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
ElevenLabs: Eleven Turbo v2
מחירים לפי תצורה
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהElevenLabs: Eleven Turbo v2 · תצורת ברירת המחדל | תנאי חיובתצורת ברירת מחדל | חיוב קלט · תווי קלט 0.00004 $ לכל תו בקלט |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · הקראה
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VOICE_ID:?Choose an accepted voice ID from this exact model profile}"
export AILOOT_VOICE_ID
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "elevenlabs/eleven-turbo-v2", "input": "Good afternoon! This is a short voice take."}')
voice=os.environ["AILOOT_VOICE_ID"]
allowed=json.loads('["george", "sarah", "adam", "alice", "bella", "bill", "brian", "callum", "charlie", "chris", "daniel", "eric", "harry", "jessica", "laura", "liam", "lily", "matilda", "river", "roger", "will"]')
if voice not in allowed: raise SystemExit("Choose an accepted voice ID from this exact model profile")
p["voice"]=voice
p["response_format"]="mp3"
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o speech.mp3
קבלה ושמירה של תוצאות
Ailoot Ultra · הקראה
mp3
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 או פלטים מרובים, שמרו כל פריט נתונים והורידו כל נכס מה־URL החתום שלו שהוחזר בפועל.
כשצריך לבדוק את התגובה המקורית
שמרו את operation_id/X-Client-Request-ID המקורי לצורך התאמת רישומים ללא שליחה מחדש; אין נתיב ייעודי לתשאול סטטוס אודיו.
שדות התגובה
| שדה | סוג |
|---|---|
שדהbinary audio | סוגbytes |
שדהresponse headers | סוגheaders |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה400 · invalid_request_error | תנאישדות נדרשים, ייצוג חומר או ערך פרמטר שאינם תקינים | השלב הבאתקנו את השדות שצוינו לפני בקשת יצירה חדשה. |
תגובהserver_error | תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה | השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה. |
כינויים
כינויים למודל
Ailoot Ultra elevenlabs/eleven-turbo-v2
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · ElevenLabs: Eleven Turbo v2
- אילו קלטים ותוצאות זמינים?
POST /v1/audio/speech·elevenlabs/eleven-turbo-v2:text→audio- באילו שדות הבקשה משתמשת?
POST /v1/audio/speech·elevenlabs/eleven-turbo-v2:model,input,voice,response_format- אילו מגבלות חלות?
POST /v1/audio/speech·elevenlabs/eleven-turbo-v2:input.maximum_length:30000