API Suno: Prompt dan skrip melalui satu endpoint

Autentikasi & URL Dasar

API kami menggunakan autentikasi OpenAI standar. Anda hanya memerlukan kunci API, yang Anda hasilkan di halaman Dapatkan kunci API. Tidak diperlukan nomor telepon atau kartu kredit untuk memulai; setiap akun baru menerima $0,50 dalam kredit uji coba yang berlaku selama 7 hari.

Atur base URL menjadi https://api.sunoapis.com/v1 dalam konfigurasi klien Anda. Pengenal model yang harus Anda kirimkan dalam setiap permintaan adalah uncensored. Ini adalah model bobot terbuka yang dihosting di server GPU kami sendiri, disesuaikan untuk penggunaan dewasa yang sah dan kreatif tanpa penolakan yang khas dari penyedia utama.

• URL Dasar: https://api.sunoapis.com/v1
• ID Model: uncensored
• Header Autentikasi: Authorization: Bearer YOUR_API_KEY

Permintaan Pertama

Mulai segera dengan permintaan penyelesaian chat standar. Endpoint ini menerima payload JSON yang berisi prompt sistem Anda, instruksi pengguna, dan metadata apa pun yang diperlukan untuk pipeline teks-ke-video atau musik AI Anda.

Ini adalah API teks saja. API ini tidak menghasilkan audio, video, atau gambar; API ini menghasilkan instruksi teks yang mengendalikan alat-alat tersebut. Gunakan endpoint ini untuk membuat skena, menulis lirik, atau mengekstrak data terstruktur dari aset kreatif Anda.

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."}]
  }'

SDK Python

Integrasikan API ke dalam aplikasi Python Anda menggunakan SDK OpenAI resmi. Karena kami kompatibel dengan OpenAI, Anda dapat menggunakan kembali kode Anda yang ada hanya dengan mengubah URL dasar dan kunci API.

Pendekatan ini berfungsi untuk menghasilkan skrip untuk alat pembuat video atau menulis metadata untuk API musik. Pastikan versi SDK Anda diperbarui untuk mendukung fitur streaming dan pemanggilan fungsi yang dijelaskan di bagian berikutnya.

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)

SDK Node.js

Untuk pengembang JavaScript/TypeScript, paket @anthropic-ai/sdk atau paket resmi openai berfungsi dengan penyesuaian konfigurasi kecil. Arahkan klien Anda ke base URL kami dan gunakan ID model uncensored.

Hal ini memungkinkan Anda membangun generasi teks di sisi server untuk aplikasi kreatif Anda. Anda dapat menggunakannya untuk pra-memproses input pengguna atau pasca-memproses skrip yang dihasilkan sebelum mengirimkannya ke endpoint pembuat audio atau video Anda. API mengembalikan respons JSON standar yang kompatibel dengan kerangka kerja web modern.

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);

Respons Streaming

Untuk skrip panjang atau metadata terperinci, gunakan Server-Sent Events (SSE) untuk menerima token secara real-time. Atur stream: true dalam body permintaan Anda. API akan mengirim serangkaian potongan, memungkinkan Anda menampilkan teks saat teks tersebut dihasilkan.

Hal ini sangat berguna untuk alat kreatif interaktif di mana pengguna ingin melihat prompt yang berkembang saat ditulis. Setiap potongan hanya berisi teks delta, sehingga Anda harus menggabungkan fragmen tersebut untuk memulihkan respons lengkap.

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)

Batas, Kesalahan & Konteks

Setiap akun dibatasi satu kunci API, yang dapat dibuat ulang kapan saja (mencabut yang lama). Anda diizinkan 300 permintaan per menit per kunci, dengan ukuran body permintaan maksimum 8 MB.

Kesalahan umum termasuk 401 untuk kunci tidak valid, 402 jika saldo prabayar Anda tidak mencukupi, dan 429 untuk batas laju. Model mendukung jendela konteks 100.000 token untuk input dan output secara gabungan.

Catatan Konten: Model tidak menolak topik kontroversial atau dewasa, tetapi secara ketat memblokir konten seksual yang melibatkan anak di bawah umur dalam semua permintaan.