API Docs
Lyria 3 Pro Preview for music generation, clips, songs, or realtime music workflows.
Prompted music generation, clip creation, tempo control, and realtime music descriptors. Endpoint: https://omixa.cloud/api/v1/music/jobs
Lyria 3 Pro Preview for music generation, clips, songs, or realtime music workflows.
Use Omixa's unified endpoint and your workspace API key. Provider routing, billing, failover, and usage records are handled by Omixa.
https://omixa.cloud/api/v1/music/jobs
Only send options supported by this model. Required fields and accepted values are listed below.
| Field | يكتب | Required | Accepted values | وصف |
|---|---|---|---|---|
model |
string | Yes | lyria-3-pro-preview | Use `lyria-3-pro-preview`. Omixa resolves the active provider route and failover key automatically. |
prompt |
string | Yes | Any valid value | Music description: genre, instrumentation, mood, tempo, vocals, and structure. |
duration_seconds |
number | No | 1-240 | Target duration. |
bpm |
integer | No | 40-240 | Tempo in beats per minute. |
temperature |
number | No | 0-3 | Creative variation control. |
style |
string | No | Any valid value | Optional style/motion hint used by the playground and compatible provider routes. |
Start with this model-safe payload and expect the normalized Omixa response shape shown beside it.
{
"model": "lyria-3-pro-preview",
"prompt": "A clean electronic intro with warm bass, light percussion, and optimistic movement.",
"duration_seconds": 30,
"bpm": 112,
"temperature": 0.8
}{
"provider": "google",
"model": "lyria-3-pro-preview",
"status": "succeeded",
"data": [
{
"audio_base64": "<base64-audio>",
"content_type": "audio/wav"
}
]
}Replace the example API key with a workspace key and keep model-specific fields unchanged unless the table above marks them optional.
curl -X POST https://omixa.cloud/api/v1/music/jobs \
-H "Authorization: Bearer omx_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "lyria-3-pro-preview",
"prompt": "A clean electronic intro with warm bass, light percussion, and optimistic movement.",
"duration_seconds": 30,
"bpm": 112,
"temperature": 0.8
}'const response = await fetch('https://omixa.cloud/api/v1/music/jobs', {
method: 'POST',
headers: {
'Authorization': 'Bearer omx_live_xxx',
'Content-Type': 'application/json'
},
body: "{\n \"model\": \"lyria-3-pro-preview\",\n \"prompt\": \"A clean electronic intro with warm bass, light percussion, and optimistic movement.\",\n \"duration_seconds\": 30,\n \"bpm\": 112,\n \"temperature\": 0.8\n}"
});
const data = await response.json();import requests
response = requests.post(
'https://omixa.cloud/api/v1/music/jobs',
headers={'Authorization': 'Bearer omx_live_xxx', 'Content-Type': 'application/json'},
json={
"model": "lyria-3-pro-preview",
"prompt": "A clean electronic intro with warm bass, light percussion, and optimistic movement.",
"duration_seconds": 30,
"bpm": 112,
"temperature": 0.8
}
)
print(response.json())$ch = curl_init('https://omixa.cloud/api/v1/music/jobs');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer omx_live_xxx', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{
"model": "lyria-3-pro-preview",
"prompt": "A clean electronic intro with warm bass, light percussion, and optimistic movement.",
"duration_seconds": 30,
"bpm": 112,
"temperature": 0.8
}',
CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "omx_live_xxx");
var json = @"{
""model"": ""lyria-3-pro-preview"",
""prompt"": ""A clean electronic intro with warm bass, light percussion, and optimistic movement."",
""duration_seconds"": 30,
""bpm"": 112,
""temperature"": 0.8
}";
var response = await client.PostAsync("https://omixa.cloud/api/v1/music/jobs", new StringContent(json, System.Text.Encoding.UTF8, "application/json"));
var body = await response.Content.ReadAsStringAsync();payload := []byte(`{
"model": "lyria-3-pro-preview",
"prompt": "A clean electronic intro with warm bass, light percussion, and optimistic movement.",
"duration_seconds": 30,
"bpm": 112,
"temperature": 0.8
}`)
req, _ := http.NewRequest("POST", "https://omixa.cloud/api/v1/music/jobs", bytes.NewReader(payload))
req.Header.Set("Authorization", "Bearer omx_live_xxx")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)