Skip to main content
POST
/
v1
/
sfx-generation
Sound Effect Generation
curl --request POST \
  --url https://devapi.fineshare.net/v1/sfx-generation \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Thunderstorm with heavy rain and distant thunder",
  "negative_prompt": "music, voices",
  "sourceUrl": "<string>",
  "sourceType": "video",
  "duration": 5,
  "useAsync": true
}
'
{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Documentation Index

Fetch the complete documentation index at: https://api.finevoice.ai/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Authorization
string
required

Bearer token for authentication. Format: Bearer {your_api_key}

Body

​
prompt
string | null

Text description of the sound effect to generate.

Example:

"Thunderstorm with heavy rain and distant thunder"

​
negative_prompt
string | null

Text description of elements to avoid in the generated sound.

Example:

"music, voices"

​
sourceUrl
string | null

URL of a source video or image file to generate effects from. Required if sourceType is provided.

​
sourceType
string | null

Type of the source file. Supported values: video, image. Required if sourceUrl is provided.

Example:

"video"

​
duration
number<float>

Desired duration of the generated sound effect in seconds. Maximum allowed duration is 30 seconds.

Example:

5

​
useAsync
boolean

Set to true to process asynchronously and receive a task_id for polling.

Example:

true

Response

Task accepted. Returns a task_id for polling status.

​
task_id
string
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"