LogoAI Music API

API Uç Noktaları

Kapak Görseli

POST/v2/cover/generate

Müzik Kapağı API'si Oluştur

Müzik parçalarınız için AI kapak görselleri oluşturun. İstek başına 1 kredi tüketir.

POSThttps://udioapi.pro/api/v2/cover/generate

tips

Nasıl çalışır: görev oluşturun, durumu yoklayın ve ardından görselleri getirin.

Not: URL'ler 14 gün boyunca saklanır.

requestHeaders

namerequireddescription
nameAuthorizationrequiredyesdescriptionKimlik doğrulama için taşıyıcı belirteci
nameContent-Typerequiredyesdescriptionapplication/json

requestBody

Teminat oluşturma için gövde talebi

commonParams

paramNameparamTyperequireddescriptionexample
paramNametaskIdparamTypestringrequiredyesdescriptionOrijinal müzik oluşturma görev kimliğiexamplegen123213213213123bksv

responses

json
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "cover123123213213b880d2"
  }
}
json
{
  "code": 400,
  "msg": "Cover already exists for this task"
}
json
{
  "code": 401,
  "message": "No API key provided in Authorization header"
}
json
{
  "code": 402,
  "message": "Insufficient balance, please recharge"
}
json
{
  "code": 404,
  "message": "Original music task not found, please check your task id"
}

codeExamples

curl
curl -X POST "https://udioapi.pro/api/v2/cover/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "gen123213213213123bksv"
  }'
javascript
// Step 1: Generate cover
const generateResponse = await fetch('https://udioapi.pro/api/v2/cover/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    taskId: 'gen123213213213123bksv'
  })
});

const generateData = await generateResponse.json();
console.log('Cover task created:', generateData.data.taskId);

// Step 2: Poll for status
const checkStatus = async (coverTaskId) => {
  const statusResponse = await fetch(
    `https://udioapi.pro/api/v2/cover/status?task_id=${coverTaskId}`,
    {
      method: 'GET',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  );
  return await statusResponse.json();
};

let status = await checkStatus(generateData.data.taskId);
while (status.data?.status === 'IN_PROGRESS') {
  await new Promise(resolve => setTimeout(resolve, 5000));
  status = await checkStatus(generateData.data.taskId);
}

console.log('Cover images:', status.data.images);
GET/v2/cover/status

Müzik Kapağı Durumu API'sı

Kapak oluşturma durumunu kontrol edin ve görüntüleri alın.

GEThttps://udioapi.pro/api/v2/cover/status

requestHeaders

namerequireddescription
nameAuthorizationrequiredyesdescriptionKimlik doğrulama için taşıyıcı belirteci

requestParams

paramNameparamTyperequireddescription
paramNametask_idparamTypestringrequiredyesdescription/v2/cover/generate dosyasından döndürülen kapak görevi kimliği

responses

json
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "cover123123213213b880d2",
    "status": "SUCCESS",
    "images": [
      "https://tempcover.storage.com/s/123.png",
      "https://tempcover.storage.com/s/456.png"
    ],
    "created_at": "2026-01-01 00:00:30"
  }
}
json
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "cover123123213213b880d2",
    "status": "IN_PROGRESS",
    "images": null,
    "created_at": "2026-01-01 00:00:00"
  }
}
json
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "cover123123213213b880d2",
    "status": "FAILED",
    "error": "Cover generation failed",
    "images": null,
    "created_at": "2026-01-01 00:00:00"
  }
}
json
{
  "code": 404,
  "msg": "Cover task not found",
  "data": null
}

codeExamples

curl
curl -X GET "https://udioapi.pro/api/v2/cover/status?task_id=cover123123213213b880d2" \
  -H "Authorization: Bearer YOUR_API_KEY"