نقاط النهاية
الموسيقى والصوت
ولّد الموسيقى والكلام المنطوق عبر نماذج المحادثة ذات المخرجات الصوتية مثل 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. والمعاملات الخاصة بالصوت:
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
model | string | نعم | معرّف نموذج صوتي، مثل google/lyria-3 أو openai/gpt-audio. |
messages | array | نعم | صِف الموسيقى أو الكلام الذي تريده. |
modalities | string[] | نعم | ["text", "audio"] لاستلام الصوت. |
audio | object | لا | خيارات المخرجات لنماذج الكلام: { "voice": "alloy", "format": "wav" }. |
stream | boolean | لا | بثّ أجزاء الصوت كأحداث 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.
الأخطاء
| الحالة | الرمز | متى يحدث |
|---|---|---|
| 402 | insufficient_balance | رصيدك بالدولار يساوي 0. |
| 403 | plan_required | خطتك لا تشمل النماذج الصوتية. |
| 404 | model_not_found | معرّف نموذج غير معروف أو معطّل. |
راجع الأخطاء.