Music & speech

Two job surfaces sit next to the image and video ones and follow the same kickoff-then-poll contract:

Both return a job_id in under a second, charge only when a poll returns the finished media, and cost nothing on a failure. Auth is X-API-Key: gpuniq_... (Authorization: Bearer gpuniq_... and a dashboard JWT work too).

Music

One call buys one generation and is billed once, however many tracks come back. music-v5, music-v5-5, music-v4-5 and generate-music return two tracks per call — an A/B pair for the price of one render.

Extending an existing track is not available through the API yet.

Two prompt modes

The fields you send decide how much freedom the model gets:

• Inspire — send only prompt. The model writes the lyrics, picks a style and titles the track itself. Best for a first pass.
• Custom — send lyrics, or style + title. Your words are used as written and the style is followed.

Request fields

Example

import time, requests

BASE = "https://api.gpuniq.com/v1/llm"
HEADERS = {"X-API-Key": "gpuniq_your_key"}

body = requests.post(f"{BASE}/music/jobs", headers=HEADERS, json={
    "model": "music-v5",
    "prompt": "a slow synthwave track for a night drive through empty streets",
    "style": "Synthwave, analog pads, 90 BPM",
    "title": "Night Drive",
    "instrumental": True,
}).json()
if body["exception"] != 0:              # refusals arrive as HTTP 200
    raise RuntimeError(body["data"]["error_code"])

start = body["data"]
job_id = start["job_id"]
print("estimated:", start["estimated_cost_usd"])   # 0.12

deadline = time.time() + 600          # music renders run minutes, not seconds
while time.time() < deadline:
    time.sleep(4)
    d = requests.get(f"{BASE}/music/jobs/{job_id}", headers=HEADERS).json()["data"]
    if d["status"] == "completed":
        for t in d["tracks"]:
            print(t["url"])           # two tracks on the music-v* slugs
        print("cost:", d["cost_usd"], "balance:", d["balance_usd"])
        break
    if d["status"] == "failed":
        print("failed:", d.get("error"))
        break

Speech, dialogue, sound effects & isolation

One endpoint, four kinds of work. The model slug decides which fields are read. A missing required field is refused at kickoff with invalid_request naming it. A field the SKU does not use is silently dropped, not refused — so check the table below rather than assuming a knob took effect.

Which fields each SKU needs

Example: text-to-speech

import time, requests

BASE = "https://api.gpuniq.com/v1/llm"
HEADERS = {"X-API-Key": "gpuniq_your_key"}

body = requests.post(f"{BASE}/audio/jobs", headers=HEADERS, json={
    "model": "elevenlabs-tts-turbo-2-5",
    "text": "Your instance is ready. SSH credentials are in the dashboard.",
    "speed": 1.0,
}).json()
if body["exception"] != 0:              # refusals arrive as HTTP 200
    raise RuntimeError(body["data"]["error_code"])

job_id = body["data"]["job_id"]

deadline = time.time() + 300
while time.time() < deadline:
    time.sleep(3)
    d = requests.get(f"{BASE}/audio/jobs/{job_id}", headers=HEADERS).json()["data"]
    if d["status"] == "completed":
        print(d["audio"]["url"], d["characters"], "chars", "$", d["cost_usd"])
        break
    if d["status"] == "failed":
        print("failed:", d.get("error"))
        break

Example: two-speaker dialogue

curl -X POST https://api.gpuniq.com/v1/llm/audio/jobs \
  -H "X-API-Key: gpuniq_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "elevenlabs-v3-dialogue",
    "dialogue": [
      {"text": "[cheerfully] The build is green.", "voice": "<voice_id_a>"},
      {"text": "[skeptical] On which branch?",      "voice": "<voice_id_b>"}
    ]
  }'

How the balance gate works

Character-metered SKUs know the exact charge before the job starts — the character count is deterministic from your input, so estimated_cost_usd is the final price.

Per-second SKUs do not: the length of a sound effect or a source file isn't known at submit. Those gate your balance against a conservative assumption (30 s for a sound effect, 600 s for an isolation job) and the precise charge lands at completion, recovered from the upstream's own metering. A job that turns out shorter settles well under its estimate.

Where the delivered media lives

Unlike images and video, music tracks and audio files are not mirrored to GPUniq storage. The completion response carries only the upstream URL, whose lifetime is set by the rendering provider, not by us — and the job record itself expires after 60 minutes. Download the bytes as soon as the job completes.

Errors

Both surfaces use the same typed error codes as the video job API — insufficient_balance, model_not_found, invalid_request, content_moderation, upstream_validation_error, provider_unavailable, and job_not_found (exception: 404, still HTTP 200) for an unknown, expired or foreign-owned job id. Full catalog and recovery recipes: Error reference.