نستخدم ملفات تعريف الارتباط. تُبقيك ملفات تعريف الارتباط وتخزين المتصفح مسجّلًا للدخول وتتذكر تفضيلاتك. وبإذنك نقيس أيضًا كيفية استخدام الموقع. يمكنك في أي وقت. راجع سياسة ملفات تعريف الارتباط.

الموسيقى والصوت

نقاط النهاية

الموسيقى والصوت

ولّد الموسيقى والكلام المنطوق عبر نماذج المحادثة ذات المخرجات الصوتية مثل Lyria 3 وGPT Audio باستخدام modalities في chat completions.

جرّبه في ساحة التجربة

نماذج الموسيقى والمخرجات الصوتية (Lyria 3 وGPT Audio وغيرها) ليس لها نقطة نهاية مخصصة: تستدعيها عبر Chat completions وتطلب مخرجات صوتية بالمعامل modalities. يعود الصوت المولَّد بترميز base64 داخل رسالة المساعد.

POST https://api14.com/api/v1/chat/completions

الطلب

تنطبق كل معاملات chat completion. والمعاملات الخاصة بالصوت:

المعاملالنوعمطلوبالوصف
modelstringنعممعرّف نموذج صوتي، مثل google/lyria-3 أو openai/gpt-audio.
messagesarrayنعمصِف الموسيقى أو الكلام الذي تريده.
modalitiesstring[]نعم["text", "audio"] لاستلام الصوت.
audioobjectلاخيارات المخرجات لنماذج الكلام: { "voice": "alloy", "format": "wav" }.
streambooleanلابثّ أجزاء الصوت كأحداث server-sent events حيث يكون مدعومًا.

مثال

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

const result = await client.chat.completions.create({
  "model": "google/lyria-3",
  "messages": [
    {
      "role": "user",
      "content": "Explain vector databases in two sentences."
    }
  ]
});
console.log(result.choices[0].message.content);

طلب خام:

{
  "model": "google/lyria-3",
  "modalities": ["text", "audio"],
  "messages": [
    { "role": "user", "content": "A 30-second lo-fi hip hop loop with soft piano and vinyl crackle." }
  ]
}

الاستجابة

{
  "id": "gen-1791100000-xyz",
  "object": "chat.completion",
  "model": "google/lyria-3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is your loop.",
        "audio": { "id": "audio_01", "data": "UklGRiQAAABXQVZFZm10...", "format": "wav" }
      },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 1500, "total_tokens": 1524, "cost": 0.06 }
}

فُكّ ترميز choices[0].message.audio.data من base64 واحفظه بامتداد format المعطى.

إدخال الصوت

لإرسال الصوت إلى النموذج (مثل "لخّص هذا التسجيل") استخدم جزء محتوى input_audio، راجع الرؤية والملفات. لتحويل الكلام إلى نص فقط، التفريغ النصي أبسط وأرخص، ولتحويل النص إلى كلام استخدم الكلام.

عرض النماذج الصوتية

curl "https://api14.com/api/v1/models?category=audio"

الأسعار

تُحاسَب النماذج الصوتية بسعرها المعلن (لكل رمز صوتي أو لكل ثانية أو لكل طلب بحسب النموذج). التكلفة الدقيقة في usage.cost.

الأخطاء

الحالةالرمزمتى يحدث
402insufficient_balanceرصيدك بالدولار يساوي 0.
403plan_requiredخطتك لا تشمل النماذج الصوتية.
404model_not_foundمعرّف نموذج غير معروف أو معطّل.

راجع الأخطاء.