Uç noktalar
Müzik ve ses üretimi
Lyria 3 ve GPT Audio gibi müzik ve ses çıktılı modelleri chat completions üzerinden modalities parametresiyle çağırın; istek, yanıt ve fiyatlandırma.
Playground’da deneMüzik ve ses çıktılı modellerin (Lyria 3, GPT Audio ve diğerleri) ayrı bir uç noktası yoktur: bunları Chat completions üzerinden çağırır ve modalities ile ses çıktısı istersiniz. Üretilen ses, asistan mesajında base64 kodlu olarak döner.
POST https://api14.com/api/v1/chat/completions
İstek
Tüm chat completion parametreleri geçerlidir. Sese özgü olanlar:
| Parametre | Tür | Zorunlu | Açıklama |
|---|---|---|---|
model | string | evet | Bir ses modeli kimliği, örn. google/lyria-3 veya openai/gpt-audio. |
messages | array | evet | İstediğiniz müziği veya konuşmayı tarif edin. |
modalities | string[] | evet | Ses almak için ["text", "audio"]. |
audio | object | hayır | Konuşma modelleri için çıktı seçenekleri: { "voice": "alloy", "format": "wav" }. |
stream | boolean | hayır | Desteklenen yerlerde ses parçalarını server-sent events olarak stream eder. |
Örnek
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);
Ham bir istek:
{
"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." }
]
}
Yanıt
{
"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 değerini base64'ten çözün ve verilen format uzantısıyla kaydedin.
Ses girdisi
Bir modele ses göndermek için (örn. "bu kaydı özetle") input_audio içerik parçasını kullanın, bkz. Görsel ve dosyalar. Düz konuşmadan metne çeviri için Transkripsiyon daha basit ve daha ucuzdur; metinden konuşmaya için Konuşma sayfasına bakın.
Ses modellerini listeleme
curl "https://api14.com/api/v1/models?category=audio"
Fiyatlandırma
Ses modelleri, modele bağlı olarak ses token'ı, saniye veya istek başına listelenen fiyattan faturalandırılır. Tam maliyet usage.cost alanındadır.
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 402 | insufficient_balance | USD bakiyeniz 0. |
| 403 | plan_required | Planınız ses modellerini içermiyor. |
| 404 | model_not_found | Bilinmeyen veya devre dışı model kimliği. |
Bkz. Hatalar.