Μετάβαση στο περιεχόμενο

Έγγραφα προγραμματιστή UlazAI

Γενιά ήχου API

API του Στούντιο μουσικής

Suno API

Δημιουργήστε τραγούδια και συνεχίστε να εργάζεστε σε αυτά μέσω του ίδιου API που χρησιμοποιεί το Στούντιο μουσικής.

Άνοιγμα Στούντιο μουσικής

Διαβάστε τον κατάλογο λειτουργιών για τα τρέχοντα μοντέλα, τα απαιτούμενα πεδία και τις τιμές σε πιστώσεις. Υποβάλετε ένα μοναδικό αναγνωριστικό αιτήματος ώστε μια επανάληψη αιτήματος να μην χρεώνεται δύο φορές.

GET  /api/v1/music/studio/catalog/
POST /api/v1/music/studio/jobs/
GET  /api/v1/music/studio/jobs/
GET  /api/v1/music/studio/jobs/<id>/
POST /api/v1/music/studio/upload/

Η βιβλιοθήκη σας περιλαμβάνει όλες τις επιστρεφόμενες εκτελέσεις. Η επεξεργασία δημιουργεί νέο αποτέλεσμα και διατηρεί το πρωτότυπο.

Γενιά ήχου API

Δημιουργήστε μουσική, φωνές και ηχητικά εφέ χρησιμοποιώντας πιστώσεις UlazAI. Τα αποτελέσματα παραδίδονται ασύγχρονα: υποβάλετε μια εργασία και, στη συνέχεια, ρωτήστε το τελικό σημείο κατάστασης μέχρι να ολοκληρωθεί.

Έλεγχος ταυτότητας: χρήση Authorization: Bearer <ulazai_api_key> ή Authorization: Token <token>.

🎵 Μουσική

ΑΝΑΡΤΗΣΗ /api/v1/music/generate/ Απαιτείται πιστοποίηση

Δημιουργήστε ένα μουσικό κομμάτι από ένα prompt.

Σώμα αιτήματος

{
  "prompt": "Upbeat synthwave track with neon retro vibes",
  "model": "V5",               // Options: "V5", "V4_5PLUS" (default: V4_5PLUS)
  "duration": 30,              // Optional (seconds)
  "instrumental": true,        // Optional (default: true)
  "title": "Neon Nights",      // Optional
  "style": "synthwave, 120bpm" // Optional
}

Απάντηση (201 Δημιουργήθηκε)

{
  "success": true,
  "data": {
    "music_id": "uuid-here",
    "status": "processing",
    "status_url": "/api/v1/music/status/uuid-here/",
    "credits_used": 12,
    "credits_remaining": 88
  }
}

Κόστος πίστωσης: 12 πιστώσεις ανά αίτημα.

ΠΑΡΕ /api/v1/music/status/<music_id>/ Απαιτείται πιστοποίηση

Δημοσκόπηση για την ολοκλήρωση εργασίας.

Απάντηση (200 ΟΚ, ολοκληρώθηκε)

{
  "success": true,
  "data": {
    "music_id": "uuid-here",
    "status": "completed",
    "audio_url": "https://media.ulazai.com/...",
    "credits_used": 12
  }
}

🎙️ Φωνή

ΑΝΑΡΤΗΣΗ /api/v1/voiceover/generate/ Απαιτείται πιστοποίηση

Μετατροπή κειμένου σε φωνή.

Σώμα αιτήματος (TTS)

{
  "model": "tts_turbo_25",     // Options: "tts_turbo_25", "tts_v3"
  "text": "Welcome to UlazAI Studio. Let's create something amazing.",
  "voice": "Rachel",          // Optional
  "speed": 1.0                // Optional (0.7 - 1.2)
}

Σώμα αιτήματος (Διάλογος)

{
  "model": "dialogue_v3",
  "dialogue": [
    {"voice": "Rachel", "text": "We need a new hook for this ad."},
    {"voice": "Roger",  "text": "Let's make it shorter and punchier."}
  ]
}

Κόστος πίστωσης: με βάση τον αριθμό χαρακτήρων. Turbo 2.5: 12 πιστώσεις ανά 1.000 χαρακτήρες. V3/Διάλογος: 14 πιστώσεις ανά 1.000 χαρακτήρες.

ΠΑΡΕ /api/v1/voiceover/status/<voiceover_id>/ Απαιτείται πιστοποίηση

Δημοσκόπηση για ολοκλήρωση και ανάκτηση της διεύθυνσης URL ήχου.

🔊 Ηχητικά εφέ

ΑΝΑΡΤΗΣΗ /api/v1/sound-effects/generate/ Απαιτείται πιστοποίηση

Δημιουργήστε ένα ηχητικό εφέ από ένα prompt.

Σώμα αιτήματος

{
  "text": "A futuristic UI beep with a short tail",
  "loop": false,
  "duration_seconds": 2.5
}

Κόστος πίστωσης: 0,24 πιστώσεις/δευτερόλεπτο (στρογγυλοποιημένες) ελάχιστο 1 πίστωση.

ΠΑΡΕ /api/v1/sound-effects/status/<sfx_id>/ Απαιτείται πιστοποίηση

Δημοσκόπηση για ολοκλήρωση και ανάκτηση της διεύθυνσης URL ήχου.