Herkese açık Lumean API'si — HTTP üzerinden seslendirme, ses efektleri ve müzik

İşlem hattı nasıl çalışır

Anahtar, izinler, ses ve şablon bir kez ayarlanır. Sonrasında her sipariş hazır bir şablondan oluşturulur: sunucu metni parçalar halinde seslendirir, dosyalar siparişte görünür ve indirme bağlantısını ayrı bir istek verir.

Nereden başlamalı

• Hızlı başlangıcı tamamlayınSes seçiminden indirilen mp3 dosyasına kadar metin seslendirme, istek istek.İlk mp3
• Başvuruyu açınHer işlemin parametreleri, yanıt alanları ve hata kodları. İsteği doğrudan sayfadan gönderebilirsiniz.Tüm işlemler
• Temel kavramları öğreninAnahtarlar ve izinler, yanıt biçimi, eşzamansız siparişler, şablonlar, limitler ve ödeme.Anahtar, izinler ve başlıklar

Bir anahtar neler yapabilir

API anahtarıyla dört türde sipariş oluşturulabilir. Başka bir tür için API, reason service_not_found ile 422 döndürür.

tts siparişinin voice_id alanı yoktur. Ses şablonda, config.tts_settings.voice_id içinde saklanır, bu yüzden seslendirme için template_id gerekir. TTS için şablonlar zorunludur

API anahtarı ve yapay zekâ için dokümantasyon

Entegrasyondan önce

İlk istekten önce bilmeniz gerekenler. Ayrıntılar rehberlerde.

• Ses şablonda belirlenir

  Siparişin voice_id alanı yoktur. Ses, şablonun config.tts_settings.voice_id alanında saklanır ve sipariş şablona template_id ile başvurur. Tek bir siparişi başka bir sesle seslendirmek için config_override.tts_settings.voice_id gönderin. Seslendirilecek metin input_text alanına yazılır.

• Siparişler eşzamansız çalışır

  POST /orders, created durumuyla 201 döndürür; yanıtta henüz sonuç yoktur. Durumu GET /orders/{order} sorgulayarak veya WebSocket üzerinden izleyin. partially_completed son durum değildir: bazı parçalar başarısız oldu, onları yeniden deneyebilir veya siparişi iptal edebilirsiniz.

• result.files[] bağlantı değil, yol içerir

  İndirme bağlantısını POST /storage/url verir ve bağlantı bir saat geçerlidir. Sipariş dosyaları sipariş tamamlandıktan sonra 7 gün saklanır.

• Siparişi yinelemek yeni bir sipariştir

  POST /orders/{order}/retry aynı parametrelerle yeni bir sipariş oluşturur ve yeniden ücretlendirilir. Başarısız parçalar asıl sipariş içinde yinelenir: POST /orders/{order}/items/retry-failed. POST /orders için idempotency anahtarı yoktur; bağlantı koptuğunda isteği yeniden göndermeden önce siparişi listede arayın.

• 429'un birden fazla nedeni vardır

  İstek hızı limiti, anahtarın token kotası, abonelik limiti, eşzamanlı görev limiti veya içerik politikası engellerinden sonraki bekleme olabilir. Nedeni reason alanı belirtir. Yanıtta Retry-After başlığı varsa belirtilen süre kadar bekleyin. concurrency_limit_exceeded bu başlık olmadan gelir ve etkin siparişleriniz bittiğinde kalkar. limit_exceeded abonelik limitidir: dönem sıfırlanana veya tarife değişene kadar yeniden denemek işe yaramaz.

İlk isteğiniz

GET /key hiçbir şey oluşturmaz, ücret almaz ve izin gerektirmez, bu yüzden anahtarı denetlemek için uygundur. 200 — anahtar çalışıyor, yanıtta adı ve izinleri yer alır. 401 — anahtar gönderilmedi veya geçersiz.

{
  "success": true,
  "message": "string",
  "data": {
    "id": "string",
    "name": "string",
    "permissions": [
      "string"
    ],
    "is_active": true,
    "expires_at": "string",
    "limits": {
      "requests": {
        "per_minute": 1,
        "per_hour": 1,
        "per_day": 1
      },
      "tokens": {
        "per_minute": 1,
        "per_hour": 1,
        "per_day": 1,
        "per_month": 1,
        "quota": {
          "limit": 1,
          "used": 1,
          "remaining": 1
        }
      }
    }
  }
}