API Dokümantasyonu

API anahtarı alma ve saklama

Kimlik doğrulama uygulama sunucunuzda yapılmalıdır. Üretim anahtarını tarayıcı koduna, mobil pakete, loglara veya açık depoya koymayın.

1. 1Hesap oluşturup paneldeki API anahtarı alanını açın.
2. 2Anahtarı kopyalayıp sunucunun sır yöneticisinde veya korumalı ortamında saklayın.
3. 3Authorization başlığında Bearer token olarak gönderin ve açığa çıkarsa hemen değiştirin.

Hızlı Başlangıç

Eşzamansız müzik görevi oluşturun, dönen workId değerini saklayın ve tamamlanana kadar feed endpoint'ini sorgulayın. Sunucu anahtarı ayarlandıktan sonra istek çalıştırılabilir.

export UDIOAPI_KEY='replace-with-your-server-key'

curl --request POST \
  --url 'https://udioapi.pro/api/v2/generate' \
  --header "Authorization: Bearer $UDIOAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "chirp-v5-5",
    "gpt_description_prompt": "Warm indie pop with acoustic guitar",
    "make_instrumental": true
  }'

# Save workId from the response, then poll:
curl 'https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID'

Kaynak dosyalar UDIOAPI_KEY, sınırlı polling ve yapılandırılmış hatalar kullanır; harici bağımlılık yoktur. GitHub'da fork yayımlamadan önce tüm sırları kaldırın.

API Uç Noktaları

Varsayılan Music Generate endpoint’i olarak /v2/generate kullanın. MiniMax, /v2/minimax/generate üzerinden erişilen entegre bir sağlayıcıdır; varsayılan müzik üretim modeli değildir.

Hata yönetimi

HTTP durumunu ve yapılandırılmış yanıtı entegrasyon sözleşmesinin parçası sayın. workId ve kendi istek kimliğinizi loglayın, API anahtarını asla loglamayın.

Moderasyon hatalarını veya diğer nihai görev hatalarını yeniden denemeyin. Kullanıcının girdiyi değiştirebilmesi için fail_message ya da error_message değerini gösterin.

Değişiklik özeti

Uyumluluğu etkileyen API değişiklikleri burada özetlenir ve ilgili endpoint'e bağlanır.