الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

استخدم مستندات نماذج الصوت في CometAPI عبر تحديد ما إذا كان تطبيقك يحتاج إلى مخرجات صوتية أو نسخ أو ترجمة. تستخدم نقاط نهاية الصوت نفس نمط مفتاح CometAPI API المستخدم في نقاط النهاية الأخرى المتوافقة مع OpenAI.

​
اختر Audio API

Create Speech

حوّل النص إلى كلام.

Create Transcription

انسخ الصوت إلى نص.

Create Translation

ترجم الصوت إلى نص باللغة الإنجليزية.

​
Create speech

استخدم model ID يدعم الصوت من صفحة النماذج أو دليل النماذج. تستدعي الأمثلة أدناه نقطة نهاية الكلام.
تستخدم هذه الأمثلة العنصر النائب your-audio-model-id. استبدله بـ model ID صوتي متاح من صفحة النماذج أو دليل النماذج قبل تشغيل الطلب.
افتح Create Speech لاستخدام ساحة التجربة ومخطط نقطة النهاية.
import os
import requests

response = requests.post(
    "https://api.cometapi.com/v1/audio/speech",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "your-audio-model-id",
        "input": "Welcome to CometAPI.",
        "voice": "alloy",
        "response_format": "mp3",
    },
    timeout=60,
)

response.raise_for_status()

with open("speech.mp3", "wb") as audio_file:
    audio_file.write(response.content)

​
مثال على الاستجابة

استجابة الكلام الناجحة تكون صوتًا ثنائيًا. يمكن أن تبدو استجابة HTTP بهذا الشكل: 
HTTP/1.1 200 OK
Content-Type: audio/mpeg

speech.mp3

​
أمثلة على سجلات النماذج

يوضح هذا المثال لاستجابة فهرس النماذج غلاف /api/models وشكل سجل نموذج صوتي واحد. وهو ليس قائمة نماذج كاملة.
cURL
curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 0,
      "id": "your-audio-model-id",
      "code": "your-audio-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example audio model",
      "model_type": "audio",
      "features": [
        "text-to-speech"
      ],
      "endpoints": [
        "openai"
      ],
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 12,
        "output": 12,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}

​
الأخطاء الشائعة

استخدم التنسيقات الموثقة في صفحة نقطة النهاية.
اضغط الملف الصوتي أو قسّم المهمة إلى ملفات أصغر.
تأكد من أن الملف يحتوي على كلام وأن اسم الحقل يطابق المستندات.
استخدم https://api.cometapi.com/v1.

​
رموز الأخطاء واستراتيجية إعادة المحاولة

لا تُعد المحاولة حتى يتم إصلاح النص أو الملف أو model ID أو voice أو التنسيق.
لا تُعد المحاولة حتى يكون مفتاح API موجودًا وصالحًا.
تحقّق من base URL والمسار وmodel ID قبل إعادة المحاولة.
قلّل حجم الرفع قبل إعادة المحاولة.
أعد المحاولة باستخدام exponential backoff وقلّل التوازي.
أعد المحاولة باستخدام backoff لأخطاء المزوّد أو الخدمة العابرة.
للاطلاع على أنماط التنفيذ، راجع Error codes and retry strategy وRate limits and concurrency.

​
التسعير ودليل النماذج

Models page

اقرأ كيف يوفّر CometAPI معرّفات النماذج في المستندات.

Model directory

تصفّح مدى توفّر النماذج وإمكاناتها.

Pricing

تحقّق من التسعير قبل استدعاء نموذج.
Last modified on May 28, 2026