---
title: "Enqueue an audio generation job (Roles: user)"
method: POST
path: "/jobs/generate-audio"
tags: ["Jobs"]
---

# Enqueue an audio generation job (Roles: user)

`POST /jobs/generate-audio`

## Request body

- GenerateAudioPayload
  - `request_id` string
  - `audio_type` 'sfx' | 'ambiance' | 'music' | 'audio-transform' | 'human-voice' | 'non-human-voice' | 'speech' | 'speech-preset'
  - `prompt` string
  - `text` string
  - `duration` number, float
  - `modification_strength` number, float — For audio-transform, controls how strongly the source sample is modified. 0 keeps it close to the original, 1 transforms it fully.
  - `loop` boolean
  - `n` integer
  - `voice_preset` VoicePreset
    - `id` string
    - `language` string
    - `emotion` string
  - `sample` GeneratedAudio
    - `tags` string[]
    - `id` string
    - `audio_b64` string
    - `original_prompt` string
    - `original_text` string
    - `prompt` string
    - `text` string
    - `sample_url` string
    - `seed` integer
    - `type` string
    - `loop` boolean
    - `duration` number, float
    - `voice_preset` VoicePreset
      - `id` string
      - `language` string
      - `emotion` string

## Response `202`

Accepted

- JobAcceptedResponse
  - `jobId` string, required
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required
  - `queue_position` integer

## Other responses

- `400` — Error
- `402` — Insufficient credits

---

[API](https://skmtc.net/ludo/apis/ludo-ai-api.md) · [All operations](https://skmtc.net/ludo/apis/ludo-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ludo/ludo-ai-api/revisions/3af866d68651/schema)