tts-1-hd
TTS-1 HD ממיר טקסט כתוב לשמע מדובר באיכות גבוהה יותר, עם קולות מוגדרים מראש לבחירה, מהירות ושישה פורמטי פלט. OpenAI מייעדת את HD לאיכות קריינות יותר מאשר לפרופיל ההשהיה הנמוכה של TTS-1, ולכן הוא מועיל להקראות מוגמרות, לחומרי לימוד ולקטעי שמע ערוכים.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
TTS-1 HD הוא מודל המרת הטקסט לדיבור של OpenAI הממוטב לאיכות שמע. הקלט שלו הוא תסריט מוכן והפלט הוא שמע מדובר. הבחירה ב־HD נפרדת מהפרופיל מוכוון המהירות של TTS-1: OpenAI מתארת את TTS-1 כבעל השהיה נמוכה יותר אך איכות נמוכה יותר. לכן HD הוא בחירה שימושית לקריינות כאשר רצועת הקול המוגמרת חשובה יותר מהתחלת השמעה במהירות האפשרית. מאמר כתוב, קטע משיעור או הסבר מלוטש יכולים להפוך לנכס קולי.
הקלטים המרכזיים הם המודל שנבחר, הטקסט המדויק וקול. תיעוד הדיבור של היצרן מגביל את התסריט ל־4096 תווים לבקשה. הדבר מתאר אורך קלט כתוב, ולא הבטחה למשך שמע. הכינו תסריט שאפשר להבין בהאזנה: פתחו קיצורים דו־משמעיים, החליטו כיצד יוקראו כמויות ושמרו על כל קטע מגובש. לשיעור או למאמר ארוכים יותר, חלקו את הטקסט בגבולות בעלי משמעות ושמרו על הסדר שבו ייעשה שימוש בקטעים המתקבלים.
מדריך OpenAI הנוכחי מפרט תשע אפשרויות מובנות ל־TTS-1 HD: alloy, ash, coral, echo, fable, onyx, nova, sage ו־shimmer. הקולות ממוטבים לאנגלית, בעוד מדריך המרת הטקסט לדיבור תומך ביצירת דיבור בכמה שפות באמצעות הזנת טקסט בשפה הנדרשת. השוואת קולות מועילה ביותר באמצעות אותו תסריט מייצג, הכולל את השמות ואת אוצר המילים המקצועי שיופיעו בחומר הסופי. שמרו על קול ומהירות עקביים כאשר כמה קטעים מרכיבים קריינות אחת.
MP3 הוא פלט ברירת המחדל. Opus ו־AAC מספקים פורמטי שמע דחוסים חלופיים; FLAC מספק דחיסה ללא אובדן; WAV מספק שמע לא דחוס. PCM מספק דגימות גולמיות ב־24 kHz, 16 סיביות, בעלות סימן בסדר בתים little-endian, ללא כותרת קובץ. בחירות אלה משרתות שימושים שונים: קובץ הפצה קומפקטי, נכס להזרמה או שמע להעברה לתהליך עריכה. OpenAI ממליצה על WAV או PCM לזמני תגובה מהירים יותר כאשר תקורת הפענוח חשובה. בחירת פורמט קובץ אינה משנה את התסריט ואינה מוסיפה מודל נפרד לשליטה בקול.
אפשר למסור דיבור במקטעים, כך שנגן יתחיל לפני שקובץ השמע המלא מוכן. זוהי הזרמת טקסט לשמע; היא אינה מבססת שיחה קולית דו־כיוונית. התיעוד תומך בערך מהירות של 0.25 עד 4.0, כאשר 1.0 הוא ברירת המחדל. שדה ההוראות הנפרד בשפה טבעית אינו פועל עם TTS-1 HD, ופלט אירועי SSE אינו נתמך במודל זה. תסריט, קול מוגדר מראש, מהירות ופורמט פלט הם הבקרות המתועדות, ולא ממשק ההנחיות למבטא או לכיוון רגשי של מודלי הדיבור החדשים יותר.
מדריך השפות כולל רוסית, אוקראינית, אנגלית, צרפתית, גרמנית, ספרדית, פורטוגזית, איטלקית, סינית, יפנית, קוריאנית, ערבית, הינדי וקזחית בין השפות הנתמכות. הכינו את התסריט בשפת היעד; הסינתזה מממשת את הטקסט ולא מתרגמת אותו. בתוכן לימודי הבהירו הגדרות ומעברים בין מקטעים. בקטע שמע מסביר, הכינו את המסר המדויק וכל שם שחייב להישמע. המיטוב של הקול לאנגלית נשאר רלוונטי בהערכת האופן שבו שפה ואוצר מילים מסוימים נשמעים.
תהליך HD מעשי מפיק קטע שמע להאזנה, לבדיקה ולאחר מכן לשילוב בחומר המוגמר. בדקו שכל משפט מומש, ששמות וכמויות נהגו באופן מתקבל על הדעת ושהקצב שנבחר תומך בהבנה. שמרו את התסריט הכתוב לצד השמע כדי שאפשר יהיה לקשר תיקון לקטע הרלוונטי. OpenAI דורשת גילוי ברור שהקול שנוצר הוא מלאכותי. HD מתאר את משפחת ה־TTS המכוונת לאיכות; הוא אינו מבטיח כשלעצמו תזמון מדויק, זהות דובר מותאמת או בקרות הבעה של מודל אחר.
Ailoot Ultra · הקראה POST /v1/audio/speech openai/tts-1-hd
openai/tts-1-hdהתחלה
TTS-1 HD ממיר טקסט כתוב לשמע מדובר באיכות גבוהה יותר, עם קולות מוגדרים מראש לבחירה, מהירות ושישה פורמטי פלט. OpenAI מייעדת את HD לאיכות קריינות יותר מאשר לפרופיל ההשהיה הנמוכה של TTS-1, ולכן הוא מועיל להקראות מוגמרות, לחומרי לימוד ולקטעי שמע ערוכים.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- שמע
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · הקראה POST /v1/audio/speech
- סוגי קלט
text- סוגי פלט
audio- פורמט פלט
- mp3
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות openai/tts-1-hd | ברירת מחדל— |
שדהinput | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 אורך מרבי: 4,096 יחידה: תווי Unicode | ברירת מחדל— |
שדהvoice | סוגstring | דרישהחובה | ערכים ומגבלות alloy | ברירת מחדל— |
שילובים של חומרי קלט
text_to_speech · נדרש: input
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, input, voice |
פרמטרvoice_ids | מפרטalloy |
פרמטרmax_input_characters | מפרט4096 |
פרמטר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 טוקנים |
| תצורהUltra | טבלת תעריפים— | כמות לחיובכל נקודת קוד של Unicode נספרת כתו אחד, כולל סימני האן. | כמות החיוב— | יחידת חיובלכל 1K תווי קלט | חיוב קלט · תו בקלט $0.06 לכל 1K תווי קלט |
| תצורהלכל בקשה | טבלת תעריפים— | כמות לחיוב— | כמות החיובבקשה אחת | יחידת חיוב— | חיוב קלט $0 לכל בקשה |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · הקראה
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/tts-1-hd", "input": "Good afternoon! This is a short voice take.", "voice": "alloy"}')
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 openai/tts-1-hd
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · tts-1-hd
- אילו קלטים ותוצאות זמינים?
POST /v1/audio/speech·openai/tts-1-hd:text→audio- באילו שדות הבקשה משתמשת?
POST /v1/audio/speech·openai/tts-1-hd:model,input,voice- אילו מגבלות חלות?
POST /v1/audio/speech·openai/tts-1-hd:input.maximum_length:4096