الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
audio
/
translations
Python (OpenAI SDK)
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["COMETAPI_KEY"],
    base_url="https://api.cometapi.com/v1"
)

audio_file = open("audio.mp3", "rb")
translation = client.audio.translations.create(
    model="whisper-1",
    file=audio_file
)
print(translation.text)
{
  "text": "Hello, welcome to CometAPI."
}
استخدم نقطة النهاية هذه لترجمة الصوت المنطوق إلى نص إنجليزي. وهي مناسبة لقوائم انتظار الدعم متعددة اللغات، ومراجعة الوسائط، وسير العمل الذي يحتاج إلى نسخة نصية واحدة باللغة الإنجليزية من صوت بلغة أخرى.

​
الطلب الأول

أرسل ملفًا صوتيًا مدعومًا مع model وfile. استخدم عينة قصيرة أولًا حتى تتمكن من التحقق من معالجة الرفع، واكتشاف اللغة، وتحليل الإخراج.

​
قراءة الاستجابة

تتضمن الاستجابة الافتراضية text الإنجليزي المترجم. إذا طلبت تنسيق استجابة مختلفًا، فقم بتحليل الاستجابة وفقًا لذلك التنسيق.

​
الخطوات التالية

  • استخدم Create Transcription عندما تحتاج إلى نص باللغة الأصلية.
  • استخدم Create Speech عندما تحتاج إلى إنشاء صوت من نص.

التفويضات

​
Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

multipart/form-data
​
file
file
مطلوب

The audio file to translate. Supported formats: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm.

​
model
string
افتراضي:whisper-1
مطلوب

The audio translation model to use. Choose a current speech model from the Models page.

​
prompt
string

Optional text to guide the model's style or continue a previous audio segment. The prompt should be in English.

​
response_format
enum<string>
افتراضي:json

The output format for the translation.

الخيارات المتاحة:
json,
text,
srt,
verbose_json,
vtt
​
temperature
number
افتراضي:0

Sampling temperature between 0 and 1. Higher values produce more random output; lower values are more focused. When set to 0, the model auto-adjusts temperature using log probability.

النطاق المطلوب: 0 <= x <= 1

الاستجابة

200 - application/json

The translation result in English.

​
text
string
مطلوب

The translated text in English.