Skip to main content
GET
/
api
/
v1
/
wav
/
record-info
Get WAV Conversion Details
curl --request GET \
  --url https://api.api.box/api/v1/wav/record-info \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "988e****c8d3",
    "musicId": "8551****662c",
    "callbackUrl": "https://api.example.com/callback",
    "completeTime": "2025-01-01 00:10:00",
    "response": {
      "audioWavUrl": "https://example.com/s/04e6****e727.wav"
    },
    "successFlag": "SUCCESS",
    "createTime": "2025-01-01 00:00:00",
    "errorCode": null,
    "errorMessage": null
  }
}

​
Status Descriptions

  • PENDING: Task is waiting to be processed
  • SUCCESS: WAV conversion completed successfully
  • CREATE_TASK_FAILED: Failed to create the conversion task
  • GENERATE_WAV_FAILED: Failed to convert to WAV format
  • CALLBACK_EXCEPTION: Error occurred during callback

​
Developer Notes

  • Use this endpoint to check conversion status instead of waiting for callbacks
  • The response includes the WAV file download URL when status is SUCCESS
  • Task creation and completion times are included in the response

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

Query Parameters

​
taskId
string
required

The task ID returned from the Convert to WAV Format endpoint. Used to retrieve details about the conversion process, including status and download URL if available.

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