API Uç Noktaları

Değişiklik günlüğü

Geliştirici güncellemeleri

API değişiklik günlüğü

Yayınlanan API özelliklerini, uyumluluk notlarını ve entegrasyonunuz için gereken işlemleri takip edin.

Son güncelleme

17 Eyl 2026

Sürüm geçmişi

6 güncelleme
  1. Değiştirildi
    Geriye dönük uyumluPOST /v2/generate · /v2/extend · /v2/upload-cover/generateAll models

    Reddedilen istekler 422 veya 500 döndürür ve hemen iade edilir

    Oluşturma uç noktaları artık doğrulama reddini eşzamanlı bildirir ve kredileri iade eder; 200 dönüp asla tamamlanmayan bir görev bırakmaz.

    Neler değişti

    • 422, bir istek parametresinin doğrulamada reddedildiğini gösterir; mesaj düzeltilecek alanı (örneğin title veya extensionStartTime) belirtir.
    • 500 geçici bir arızayı gösterir; daha sonra yeniden deneyin.
    • Her iki yanıt da data.task_id, data.refunded ve workId içerir ve görev FAILED olarak işaretlenir.
    • Kabul edildikten sonra başarısız olan görevler (uzatmalar dahil) fail_message ile FAILED olarak işaretlenir ve krediler otomatik iade edilir.
    • Önceden bu istekler 200 döndürür ve görev süresiz olarak IN_PROGRESS kalırdı.

    Entegrasyon etkisi

    422'de belirtilen parametreyi düzeltin, 500'de daha sonra yeniden deneyin. Her iki yanıt da data.refunded içerir.

    Uç nokta belgelerini görüntüle
  2. Değiştirildi
    Geriye dönük uyumluPOST /v2/extendAll models

    extend istekleri başarısız olmak yerine metni ve başlangıç zamanını normalleştirir

    POST /v2/extend artık aşırı uzun Custom Mode metnini kısaltır ve extensionStartTime'ı sınırlar; bu alanlar nedeniyle gönderim reddedilmez.

    Neler değişti

    • title 80 karakterle sınırlıdır; daha uzun değerler kısaltılır.
    • prompt 5000, style 1000 karakterle sınırlıdır; daha uzun değerler kısaltılır.
    • extensionStartTime 1 … (kaynak süresi - 1) saniye aralığına sınırlanır; eksik veya geçersiz değerler kaynak parçanın sonunu kullanır.
    • Uzatmalar orijinal parçanın model fiyatından ücretlendirilir ve chirp-v6 (chirp-v5 / chirp-v5-5 parçaları) veya chirp-v6-mini (daha eski parçalar) tarafından üretilir.

    Entegrasyon etkisi

    Bu güncelleme geriye dönük uyumludur. Kısaltmayı önlemek için title alanını 80 karakterde tutun.

    Uç nokta belgelerini görüntüle
  3. Değiştirildi
    Geriye dönük uyumluPOST /v2/generate · /v2/extend · /v2/upload-cover/generatechirp-v3-5 … chirp-v5-5

    Eski chirp-v3-5 – chirp-v5-5 tanımlayıcıları chirp-v6 ailesi tarafından sunulur

    Kullanımdan kalkan bir model tanımlayıcısı gönderen istekler çalışmaya devam eder ve eski fiyatını korur.

    Neler değişti

    • chirp-v5 ve chirp-v5-5 (12 kredi) chirp-v6 tarafından sunulur.
    • chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus ve chirp-v4-5-all chirp-v6-mini tarafından sunulur.
    • Her eski tanımlayıcı geçmiş fiyatından (5, 8, 10 veya 12 kredi) ücretlendirilmeye devam eder.
    • status, feed ve callback sonuçlarındaki model_name artık her zaman sesi üreten genel modeli bildirir, örneğin chirp-v6-mini.
    • model alanı gönderilmezse istek 5 kredilik temel kademeden ücretlendirilir ve chirp-v6-mini tarafından sunulur.

    Entegrasyon etkisi

    Değişiklik gerekmez. Uygun olduğunda model alanını chirp-v6 veya chirp-v6-mini olarak güncelleyin.

    Uç nokta belgelerini görüntüle
  4. Eklendi
    Geriye dönük uyumluPOST /v2/generate · /v2/upload-cover/generatechirp-v6 · chirp-v6-mini · chirp-v6-wild

    chirp-v6, chirp-v6-mini ve chirp-v6-wild modelleri

    Güncel model serisi artık generate, upload-cover ve extend'de kullanılabilen chirp-v6 ailesidir.

    Neler değişti

    • chirp-v6 amiral gemisi model, chirp-v6-mini hızlı ve ekonomik kademe, chirp-v6-wild daha deneysel varyanttır.
    • chirp-v6 ve chirp-v6-wild istek başına 12 kredi, chirp-v6-mini 10 kredidir.
    • Metin sınırları tüm modeller için aynıdır: özel prompt 5000, ilham prompt 3000, style 1000, title 80 (upload-cover için 100). Uzun girişler reddedilmez, kesilir.
    • chirp-v6 parçasının uzatmaları aynı modeli kullanır; Custom Mode generate isteklerinde duration alanı iletilir.

    Entegrasyon etkisi

    Bu güncelleme geriye dönük uyumludur. Yeni entegrasyonları chirp-v6-mini veya chirp-v6'ya geçirin.

    Uç nokta belgelerini görüntüle
  5. Eklendi
    Geriye dönük uyumluPOST /v2/generate · /v2/upload-cover/generatechirp-v6 family

    image_urls ile görselden müzik

    POST /v2/generate ve POST /v2/upload-cover/generate artık parçanın atmosferini belirleyen referans görseller kabul ediyor.

    Neler değişti

    • image_urls alanını herkese açık en fazla 5 görsel URL'sinden oluşan bir dizi olarak gönderin.
    • JPEG, JPG, PNG ve WEBP desteklenir; görsel başına en fazla 10MB.
    • Görseller yalnızca İlham Modu (generate) ve özel olmayan modda (upload-cover) geçerlidir; Custom Mode'da sessizce yok sayılır.
    • Görsel girişi, model fiyatına ek olarak istek başına 1 kredi ekler.
    • Görsel verildiğinde metin istemi isteğe bağlıdır; sonucu yönlendirmek için ikisini birleştirin.

    Entegrasyon etkisi

    Bu güncelleme geriye dönük uyumludur. image_urls alanını yalnızca görsellerin sonucu etkilemesini istediğinizde ekleyin.

    Uç nokta belgelerini görüntüle
  6. Eklendi
    Geriye dönük uyumluPOST /v2/generatechirp-v5-5

    chirp-v5-5 için özel süre kontrolü

    chirp-v5-5 kullanan Özel Mod istekleri artık hedef parça süresini belirtebilir.

    Neler değişti

    • duration alanı yalnızca chirp-v5-5 Özel Modunda kullanılabilir.
    • 10 ile 360 saniye arasında bir sayı gönderin.
    • Eksik veya geçersiz değerlerde 20 saniye kullanılır.
    • Diğer modeller ve İlham Modu bu alanı yok sayar.

    Entegrasyon etkisi

    Bu güncelleme geriye dönük uyumludur. Mevcut istekler değişiklik yapılmadan çalışmaya devam eder.

    Uç nokta belgelerini görüntüle