Suno API: Tek uç nokta üzerinden istem ve senaryolar

Kimlik Doğrulama ve Base URL

API'miz standart OpenAI kimlik doğrulamasını kullanır. API anahtarını al sayfasından bir API anahtarı oluşturmanız yeterlidir. Başlamak için telefon numarası veya kredi kartı gerekmez; her yeni hesap, 7 gün boyunca geçerli olmak üzere $0.50 ücretsiz deneme kredisi alır.

İstemci yapılandırmanızda temel URL'yi https://api.sunoapis.com/v1 olarak ayarlayın. Her istekte göndermeniz gereken model tanımlayıcısı uncensored'dir. Bu, büyük sağlayıcılarda görülen reddetmelerden arındırılmış, yasal yetişkin ve yaratıcı kullanım için ayarlanmış, kendi GPU sunucularımızda barındırılan açık ağırlıklı bir modeldir.

• Base URL: https://api.sunoapis.com/v1
• Model Kimliği: sansürsüz
• Kimlik Doğrulama Başlığı: Authorization: Bearer YOUR_API_KEY

İlk İstek

Standart bir sohbet tamamlama isteğiyle hemen başlayın. Uç nokta, sistem isteminizi, kullanıcı talimatlarınızı ve metin-video veya AI müzik iş akışınız için gereken herhangi bir meta veriyi içeren JSON yüklerini kabul eder.

Bu, metin içeren bir API'dir. Ses, video veya görsel üretmez; bu araçları yönlendiren metin istemlerini üretir. Sahne senaryoları yazmak, şarkı sözü oluşturmak veya yaratıcı varlıklarınızdan yapılandırılmış veri çıkarmak için bu uç noktasını kullanın.

Copycurl https://api.sunoapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK

API'yi resmi OpenAI SDK'sını kullanarak Python uygulamalarınıza entegre edin. OpenAI uyumlu olduğumuzdan, base URL ve API anahtarını değiştirerek mevcut kodunuzu yeniden kullanabilirsiniz.

Bu yaklaşım, video oluşturma araçları için senaryo oluşturmak veya müzik API'leri için meta veri yazmak için çalışır. Bir sonraki bölümlerde açıklanan akış ve fonksiyon çağırma özelliklerini desteklemek için SDK sürümünüzün güncel olduğundan emin olun.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.sunoapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node SDK

JavaScript/TypeScript geliştiricileri için @anthropic-ai/sdk veya resmi openai paketi, küçük yapılandırma ayarlarıyla çalışır. İstemcinizi temel URL'mize yönlendirin ve uncensored model kimliğini kullanın.

Bu, yaratıcı uygulamalarınız için sunucu taraflı metin üretimi yapmanızı sağlar. Kullanıcı girdilerini ön işleme yapmak veya oluşturulan senaryoları ses veya video üretim uç noktalarına göndermeden önce son işleme yapmak için kullanabilirsiniz. API, modern web çerçeveleriyle uyumlu standart JSON yanıtları döndürür.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.sunoapis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Akışlı Yanıtlar

Uzun senaryolar veya ayrıntılı meta veriler için gerçek zamanlı olarak tokenları almak üzere Sunucu Tarafından Gönderilen Olayları (SSE) kullanın. İstek gövdenize stream: true ayarını ekleyin. API, metin oluşturuldukça görüntülemenizi sağlayan bir dizi veri parçası gönderir.

Bu, kullanıcıların istem yazılırken gelişimini görmek istediği etkileşimli yaratıcı araçlar için özellikle yararlıdır. Her veri parçası yalnızca eklenen metni içerir; tam yanıtı yeniden oluşturmak için parçaları birleştirmeniz gerekir.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Limitler, Hatalar ve Bağlam

Her hesap için bir API anahtarı sınırı vardır; bu anahtar istediğiniz zaman yenilenebilir (eski anahtarı iptal ederek). Her anahtar için dakika başına 300 istek yapılmasına izin verilir ve maksimum istek gövdesi boyutu 8 MB'dir.

Yaygın hatalar arasında geçersiz anahtarlar için 401, yetersiz ön ödemeli kredi için 402 ve hız limiti aşımları için 429 yer alır. Model, hem giriş hem de çıktı için toplamda 100,000 token bağlam penceresini destekler.

İçerik Notu: Model tartışmalı veya yetişkin konularını reddetmez, ancak tüm isteklerde küçüklerle ilgili cinsel içeriği kesinlikle engeller.