Skip to main content
POST
/
api
/
v1
/
wav
/
generate
Convert to WAV Format
curl --request POST \
  --url https://api.api.box/api/v1/wav/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "taskId": "5c79****be8e",
  "audioId": "e231****-****-****-****-****8cadc7dc",
  "callBackUrl": "https://api.example.com/callback"
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e"
  }
}

​
Usage Guide

  • Provide either taskId or audioId to identify the source track
  • WAV format is ideal for professional audio editing and production
  • The conversion preserves full audio quality

​
Developer Notes

  1. Generated WAV files are retained for 15 days
  2. WAV files are significantly larger than MP3 files
  3. This format is recommended for further audio processing or professional use
  4. Callback provides a single download URL when conversion is complete

Authorizations

​
Authorization
string
header
required

🔑 API Authentication

All endpoints require authentication using Bearer Token.

Get API Key

  1. Visit the API Key Management Page to obtain your API Key

Usage

Add to request headers:

Authorization: Bearer YOUR_API_KEY

⚠️ Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately from the management page

Body

application/json
​
taskId
string
required

The task ID of the music generation task.

Example:

"5c79****be8e"

​
audioId
string
required

The audio ID of the specific track to convert.

  • Providing the specific audioId ensures the exact track is converted, especially when a task has multiple tracks.
Example:

"e231****-****-****-****-****8cadc7dc"

​
callBackUrl
string<uri>
required

The URL to receive WAV conversion completion notification.

  • Required.
  • The callback includes a single download URL for the converted WAV file.

For detailed callback format and implementation guide, see WAV Format Conversion Callbacks

  • Alternatively, you can use the Get WAV Conversion Details interface to poll task status
Example:

"https://api.example.com/callback"

Response

Request successful

​
code
enum<integer>

Status Codes

  • ✅ 200 - Request successful
  • ⚠️ 400 - Invalid parameters
  • ⚠️ 401 - Unauthorized access
  • ⚠️ 404 - Invalid request method or path
  • ⚠️ 405 - Rate limit exceeded
  • ⚠️ 409 - Conflict - WAV record already exists
  • ⚠️ 413 - Theme or prompt too long
  • ⚠️ 429 - Insufficient credits
  • ⚠️ 430 - Your call frequency is too high. Please try again later.
  • ⚠️ 455 - System maintenance
  • ❌ 500 - Server error
Available options:
200,
400,
401,
404,
405,
409,
413,
429,
430,
455,
500
​
msg
string

Error message when code != 200

Example:

"success"

​
data
object