---
title: "Import Audio"
method: POST
path: "/generate/import"
---

# Import Audio

`POST /generate/import`

## Request

- Base URL: `https://api.voicelabs.now` (the document declares no server; this is the origin it was published from)
- URL: `https://api.voicelabs.now/generate/import`
- Auth: none declared

Register an external audio file as a generation row.

Designed for the story timeline so users can drop in music or other
non-TTS audio. The row points at a singleton "Imported Audio" profile
so the existing generation/story plumbing keeps working unchanged.

## Response `200`

Successful Response

- GenerationResponse: Response model for voice generation.
  - `id` string, required
  - `profile_id` string, required
  - `text` string, required
  - `language` string, required
  - `audio_path` string, nullable
  - `duration` number, nullable
  - `seed` integer, nullable
  - `instruct` string, nullable
  - `engine` string, nullable
  - `model_size` string, nullable
  - `speed` number, nullable
  - `temperature` number, nullable
  - `chunk_count` integer, nullable
  - `status` string
  - `error` string, nullable
  - `is_favorited` boolean
  - `source` string
  - `created_at` string, date-time, required
  - `versions` GenerationVersionResponse[], nullable
    - `id` string, required
    - `generation_id` string, required
    - `label` string, required
    - `audio_path` string, required
    - `effects_chain` EffectConfig[], nullable
      - `type` string, required
      - `enabled` boolean
      - `params` object
    - `source_version_id` string, nullable
    - `is_default` boolean, required
    - `created_at` string, date-time, required
  - `active_version_id` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/voicelabs/apis/voicebox-api.md) · [All operations](https://skmtc.dev/voicelabs/apis/voicebox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voicelabs/apis/voicebox-api/revisions/a7a37d1fc02f?raw)
