Endpoint
Musik dan audio
Buat musik dan audio ucapan lewat chat completions memakai model keluaran audio seperti Lyria 3 dan GPT Audio, lengkap dengan harga.
Coba di playgroundModel musik dan keluaran audio (Lyria 3, GPT Audio, dan lainnya) tidak punya endpoint khusus: Anda memanggilnya lewat Chat completions dan meminta keluaran audio dengan modalities. Audio yang dihasilkan dikembalikan dalam encoding base64 di pesan assistant.
POST https://api14.com/api/v1/chat/completions
Request
Semua parameter chat completion berlaku. Parameter khusus audio:
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
model | string | ya | ID model audio, mis. google/lyria-3 atau openai/gpt-audio. |
messages | array | ya | Deskripsikan musik atau ucapan yang Anda inginkan. |
modalities | string[] | ya | ["text", "audio"] untuk menerima audio. |
audio | object | tidak | Opsi keluaran untuk model ucapan: { "voice": "alloy", "format": "wav" }. |
stream | boolean | tidak | Stream potongan audio sebagai server-sent events jika didukung. |
Contoh
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);
Request mentah:
{
"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." }
]
}
Respons
{
"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 }
}
Decode choices[0].message.audio.data dari base64 dan simpan dengan ekstensi sesuai format yang diberikan.
Input audio
Untuk mengirim audio ke dalam model (mis. "rangkum rekaman ini"), gunakan content part input_audio, lihat Vision dan file. Untuk speech-to-text biasa, Transkripsi lebih sederhana dan lebih murah; untuk text-to-speech, gunakan Suara.
Menampilkan daftar model audio
curl "https://api14.com/api/v1/models?category=audio"
Harga
Model audio ditagih sesuai harga yang tercantum (per token audio, per detik, atau per request, tergantung model). Biaya pastinya ada di usage.cost.
Error
| Status | Kode | Kapan |
|---|---|---|
| 402 | insufficient_balance | Saldo USD Anda $0. |
| 403 | plan_required | Paket Anda tidak mencakup model audio. |
| 404 | model_not_found | ID model tidak dikenal atau dinonaktifkan. |
Lihat Error.