Get Lyrics Generation Details
curl --request GET \
--url https://apibox.erweima.ai/api/v1/lyrics/record-info \
--header 'Authorization: Bearer <token>'import requests
url = "https://apibox.erweima.ai/api/v1/lyrics/record-info"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://apibox.erweima.ai/api/v1/lyrics/record-info', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://apibox.erweima.ai/api/v1/lyrics/record-info",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://apibox.erweima.ai/api/v1/lyrics/record-info"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://apibox.erweima.ai/api/v1/lyrics/record-info")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apibox.erweima.ai/api/v1/lyrics/record-info")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"code": 200,
"msg": "success",
"data": {
"taskId": "11dc****8b0f",
"param": "{\"prompt\":\"A song about peaceful night in the city\"}",
"response": {
"taskId": "11dc****8b0f",
"data": [
{
"text": "[Verse]\n我穿越城市黑暗夜\n心中燃烧梦想的烈火",
"title": "钢铁侠",
"status": "complete",
"errorMessage": ""
}
]
},
"status": "SUCCESS",
"type": "LYRICS",
"errorCode": null,
"errorMessage": null
}
}Lyrics Generation
Get Lyrics Generation Details
Retrieve detailed information about a lyrics generation task, including status, parameters, and results.
GET
/
api
/
v1
/
lyrics
/
record-info
Get Lyrics Generation Details
curl --request GET \
--url https://apibox.erweima.ai/api/v1/lyrics/record-info \
--header 'Authorization: Bearer <token>'import requests
url = "https://apibox.erweima.ai/api/v1/lyrics/record-info"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://apibox.erweima.ai/api/v1/lyrics/record-info', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://apibox.erweima.ai/api/v1/lyrics/record-info",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://apibox.erweima.ai/api/v1/lyrics/record-info"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://apibox.erweima.ai/api/v1/lyrics/record-info")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apibox.erweima.ai/api/v1/lyrics/record-info")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"code": 200,
"msg": "success",
"data": {
"taskId": "11dc****8b0f",
"param": "{\"prompt\":\"A song about peaceful night in the city\"}",
"response": {
"taskId": "11dc****8b0f",
"data": [
{
"text": "[Verse]\n我穿越城市黑暗夜\n心中燃烧梦想的烈火",
"title": "钢铁侠",
"status": "complete",
"errorMessage": ""
}
]
},
"status": "SUCCESS",
"type": "LYRICS",
"errorCode": null,
"errorMessage": null
}
}Status Descriptions
- PENDING: Task is waiting to be processed
- SUCCESS: Lyrics generated successfully
- CREATE_TASK_FAILED: Failed to create the task
- GENERATE_LYRICS_FAILED: Failed to generate lyrics
- CALLBACK_EXCEPTION: Error occurred during callback
- SENSITIVE_WORD_ERROR: Content contains prohibited words
Developer Notes
- Use this endpoint to check task status instead of waiting for callbacks
- This returns all generated lyrics variations from a single task
- Each lyrics variation includes a title and complete lyrics text
Authorizations
🔑 API Authentication
All endpoints require authentication using Bearer Token.
Get API Key
- 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
The task ID returned from the Generate Lyrics endpoint. Used to retrieve detailed information about a specific lyrics generation task.
Response
Request successful
Status Codes
- ✅ 200 - Request successful
- ⚠️ 400 - Invalid parameters
- ⚠️ 401 - Unauthorized access
- ⚠️ 404 - Invalid request method or path
- ⚠️ 405 - Rate limit exceeded
- ⚠️ 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, 413, 429, 430, 455, 500 Example:
200
Error message when code != 200
Example:
"success"
Show child attributes
Show child attributes
