LogoAI Music API

API Uç Noktaları

Yükle ve Cover

POST/v2/upload-cover/generate

Kapak Oluşturma API'sini Yükle

Orijinal melodiyi korurken ses yükleyin ve bir AI cover sürümü oluşturun.

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

tips

Modlar: özel olmayan mod (basit) ve özel mod (tam kontrol).

Notlar: dosya saklama 15 gün, her 5-10 saniyede bir anket durumu, isteğe bağlı callback_url.

requestHeaders

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

requestBody

İstek gövdesi basit modu ve özel modu destekler

commonParams

paramNameparamTyperequireddescriptionexample
paramNameupload_urlparamTypestringrequiredyesdescriptionSes dosyasının genel URL'siexamplehttps://storage.example.com/my-song.mp3
paramNamemodelparamTypestringrequiredyesdescriptionYapay zeka modeliexamplechirp-v4-5
paramNamecustom_modeparamTypebooleanrequirednodescriptionÖzel modu etkinleştirexamplefalse
paramNamemake_instrumentalparamTypebooleanrequirednodescriptionEnstrümantal versiyon oluşturexamplefalse
paramNamepromptparamTypestringrequirednodescriptionAçıklama veya şarkı sözleriexampleA calm and relaxing piano track with soft melodies
paramNamestyleparamTypestringrequirednodescriptionMüzik tarzıexamplepop, upbeat, electronic
paramNametitleparamTypestringrequirednodescriptionŞarkı adıexampleSummer Cover
paramNametagsparamTypestringrequirednodescriptionNegatif etiketlerexampleHeavy Metal, Upbeat Drums
paramNamegenderparamTypestringrequirednodescriptionVokal cinsiyet tercihiexamplefemale
paramNamestyle_weightparamTypenumberrequirednodescriptionStile bağlılık gücüexample0.65
paramNameweirdness_constraintparamTypenumberrequirednodescriptionYaratıcı sapma kontrolüexample0.65
paramNameaudio_weightparamTypenumberrequirednodescriptionSes özelliği dengesiexample0.65
paramNamecallback_urlparamTypestringrequirednodescriptionTamamlanma bildirimleri için Webhook URL'siexamplehttps://api.example.com/webhook/upload-cover

responses

json
{
  "code": 200,
  "message": "success",
  "workId": "upcov1a2b3c4d5e6f7890abcdef",
  "data": {
    "task_id": "upcov1a2b3c4d5e6f7890abcdef"
  }
}
json
{
  "code": 422,
  "message": "upload_url is required. Please provide a valid URL to your audio file (max 8 minutes)."
}
json
{
  "code": 400,
  "message": "No body provided"
}
json
{
  "code": 401,
  "message": "No API key provided in Authorization header"
}
json
{
  "code": 402,
  "message": "Insufficient credits. Required: 10, Available: 3"
}
json
{
  "code": 500,
  "message": "Internal Server Error",
  "data": {
    "task_id": "upcov1a2b3c4d5e6f7890abcdef"
  },
  "workId": "upcov1a2b3c4d5e6f7890abcdef"
}

codeExamples

curl
curl -X POST "https://udioapi.pro/api/v2/upload-cover/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chirp-v4-5",
    "upload_url": "https://storage.example.com/my-song.mp3",
    "custom_mode": false,
    "make_instrumental": false,
    "prompt": "A calm and relaxing piano cover with soft melodies"
  }'
curl
curl -X POST "https://udioapi.pro/api/v2/upload-cover/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "chirp-v4-5",
    "upload_url": "https://storage.example.com/my-song.mp3",
    "custom_mode": true,
    "make_instrumental": false,
    "prompt": "[Verse]\nWalking down the street, feeling so free\n[Chorus]\nSummer dreams are calling me",
    "style": "pop, upbeat, electronic, 120 bpm",
    "title": "Summer Cover",
    "gender": "female",
    "style_weight": 0.65,
    "weirdness_constraint": 0.65,
    "audio_weight": 0.65
  }'
javascript
const response = await fetch('https://udioapi.pro/api/v2/upload-cover/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'chirp-v4-5',
    upload_url: 'https://storage.example.com/my-song.mp3',
    custom_mode: false,
    make_instrumental: false,
    prompt: 'A calm and relaxing piano cover with soft melodies'
  })
});

const data = await response.json();
const statusRes = await fetch(
  'https://udioapi.pro/api/v2/upload-cover/status?task_id=' + data.data.task_id,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const status = await statusRes.json();
console.log(status);
GET/v2/upload-cover/status

Kapak Durumu API'sini Yükle

Yükleme-kapak görevinin durumunu ve sonuçlarını kontrol edin.

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

tips

Durum: IN_PROGRESS, SUCCESS, FAILED, ERROR.

Görev başarısız olursa krediler otomatik olarak iade edilir.

requestParams

paramNameparamTyperequireddescription
paramNametask_idparamTypestringrequiredyesdescriptionOluşturma uç noktasından döndürülen görev kimliği

responses

json
{
  "code": 200,
  "message": "success",
  "data": {
    "type": "IN_PROGRESS",
    "request_body": {
      "model": "chirp-v4-5",
      "upload_url": "https://storage.example.com/my-song.mp3",
      "custom_mode": false,
      "prompt": "A calm and relaxing piano cover"
    },
    "response_data": null,
    "created_at": "2026-02-07T12:00:00.000Z"
  }
}
json
{
  "code": 200,
  "message": "success",
  "data": {
    "type": "SUCCESS",
    "request_body": {
      "model": "chirp-v4-5",
      "upload_url": "https://storage.example.com/my-song.mp3",
      "custom_mode": false,
      "prompt": "A calm and relaxing piano cover"
    },
    "response_data": [
      {
        "id": "e231xxxx-xxxx-xxxx-xxxx-xxxx8cadc7dc",
        "audio_url": "https://cdn1.suno.ai/xxxx.mp3",
        "image_url": "https://cdn2.suno.ai/image_xxxx.jpeg",
        "image_large_url": "https://cdn2.suno.ai/image_xxxx.jpeg",
        "created_at": "2026-02-07T12:00:00.000Z",
        "status": "complete",
        "title": "Summer Cover",
        "prompt": "[Verse] Walking down the street, feeling so free",
        "tags": "pop, upbeat",
        "duration": 198.44,
        "model_name": "chirp-v4-5",
        "extra_message": "synced_from_api",
        "fail_message": "",
        "error_message": ""
      },
      {
        "id": "bd15xxxx-xxxx-xxxx-xxxx-xxxxxxxx1873",
        "audio_url": "https://cdn1.suno.ai/yyyy.mp3",
        "image_url": "https://cdn2.suno.ai/image_yyyy.jpeg",
        "image_large_url": "https://cdn2.suno.ai/image_yyyy.jpeg",
        "created_at": "2026-02-07T12:00:00.000Z",
        "status": "complete",
        "title": "Summer Cover",
        "prompt": "[Verse] Walking down the street, feeling so free",
        "tags": "pop, upbeat",
        "duration": 228.28,
        "model_name": "chirp-v4-5",
        "extra_message": "synced_from_api",
        "fail_message": "",
        "error_message": ""
      }
    ],
    "created_at": "2026-02-07T12:00:00.000Z"
  }
}
json
{
  "code": 200,
  "message": "success",
  "data": {
    "type": "FAILED",
    "request_body": {
      "model": "chirp-v4-5",
      "upload_url": "https://storage.example.com/my-song.mp3",
      "custom_mode": false,
      "prompt": "..."
    },
    "response_data": [
      {
        "status": "FAILED",
        "fail_message": "Does Not Meet Guidelines",
        "error_message": "Does Not Meet Guidelines"
      },
      {
        "status": "FAILED",
        "fail_message": "Does Not Meet Guidelines",
        "error_message": "Does Not Meet Guidelines"
      }
    ],
    "created_at": "2026-02-07T12:00:00.000Z"
  }
}
json
{
  "code": 404,
  "message": "Task not found",
  "data": null
}
json
{
  "code": 500,
  "message": "Internal Server Error",
  "data": null
}

codeExamples

curl
curl -X GET "https://udioapi.pro/api/v2/upload-cover/status?task_id=upcov1a2b3c4d5e6f7890abcdef" \
  -H "Authorization: Bearer YOUR_API_KEY"
javascript
async function pollStatus(taskId) {
  while (true) {
    const res = await fetch(
      'https://udioapi.pro/api/v2/upload-cover/status?task_id=' + taskId,
      { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
    );
    const result = await res.json();

    if (result.data?.type === 'SUCCESS') return result;
    if (result.data?.type === 'FAILED' || result.data?.type === 'ERROR') return result;

    await new Promise(r => setTimeout(r, 5000));
  }
}