Endpoints
Musik och ljud
Generera musik och talat ljud med chattmodeller som ger ljud som utdata via chat completions och modalities, med exempel, svar, priser och planer.
Testa i playgroundModeller för musik och ljudutdata (Lyria 3, GPT Audio med flera) har ingen egen endpoint: du anropar dem via Chat completions och ber om ljudutdata med modalities. Det genererade ljudet kommer tillbaka base64-kodat i assistentmeddelandet.
POST https://api14.com/api/v1/chat/completions
Anrop
Alla parametrar för chat completions gäller. De ljudspecifika:
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
model | string | ja | Ett ljudmodell-id, t.ex. google/lyria-3 eller openai/gpt-audio. |
messages | array | ja | Beskriv musiken eller talet du vill ha. |
modalities | string[] | ja | ["text", "audio"] för att få ljud. |
audio | object | nej | Utdataalternativ för talmodeller: { "voice": "alloy", "format": "wav" }. |
stream | boolean | nej | Strömma ljudbitar som server-sent events där det stöds. |
Exempel
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);
Ett rått anrop:
{
"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." }
]
}
Svar
{
"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 }
}
Avkoda choices[0].message.audio.data från base64 och spara den med filändelsen för angivet format.
Ljud som indata
För att skicka ljud till en modell (t.ex. "sammanfatta den här inspelningen"), använd en innehållsdel av typen input_audio, se Vision och filer. För ren tal-till-text är Transkribering enklare och billigare, och för text-till-tal, använd Tal.
Lista ljudmodeller
curl "https://api14.com/api/v1/models?category=audio"
Priser
Ljudmodeller faktureras till sitt listade pris (per ljudtoken, per sekund eller per anrop, beroende på modell). Den exakta kostnaden finns i usage.cost.
Fel
| Status | Kod | När |
|---|---|---|
| 402 | insufficient_balance | Ditt USD-saldo är 0 USD. |
| 403 | plan_required | Din plan omfattar inte ljudmodeller. |
| 404 | model_not_found | Okänt eller inaktiverat modell-id. |
Se Fel.