API Suno: prompty i scenariusze przez jeden endpoint

Autoryzacja i Base URL

Nasze API używa standardowej autoryzacji OpenAI. Potrzebujesz tylko klucza API, który generujesz na stronie Pobierz klucz API. Nie jest wymagany numer telefonu ani karta kredytowa do rozpoczęcia; każde nowe konto otrzymuje $0,50 w darmowym kredycie próbnym ważnym przez 7 dni.

Ustaw base URL na https://api.sunoapis.com/v1 w konfiguracji klienta. Identyfikator modelu, który musisz wysyłać w każdym zapytaniu, to uncensored. To model o otwartych wagach hostowany na naszych własnych serwerach GPU, dostrojony do prawnego użytku dorosłego i kreatywnego bez odmów typowych dla dużych dostawców.

• Base URL: https://api.sunoapis.com/v1
• ID modelu: uncensored
• Nagłówek Auth: Authorization: Bearer TWOJ_KLUCZ_API

Pierwsze zapytanie

Zacznij natychmiast ze standardowym zapytaniem o uzupełnienie czatu. Endpoint akceptuje ładunki JSON zawierające Twój prompt systemowy, instrukcje użytkownika i wszelkie metadane potrzebne do Twojego potoku tekst-wideo lub AI-muzyka.

To jest API tylko tekstowe. Nie generuje audio, wideo ani obrazów; generuje instrukcje tekstowe, które napędzają te narzędzia. Użyj tego endpointu do skryptowania scen, pisania tekstów piosenek lub ekstrakcji danych strukturalnych z Twoich aktywów kreatywnych.

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

Zintegruj API ze swoimi aplikacjami Python, używając oficjalnego SDK OpenAI. Ponieważ jesteśmy kompatybilni z OpenAI, możesz ponownie użyć istniejącego kodu, po prostu zmieniając Base URL i klucz API.

To podejście działa do generowania scenariuszy dla narzędzi do generowania wideo lub pisania metadanych dla API muzyki. Upewnij się, że Twoja wersja SDK jest zaktualizowana, aby obsługiwać funkcje strumieniowania i wywoływania funkcji opisane w następnych sekcjach.

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

Dla programistów JavaScript/TypeScript pakiet @anthropic-ai/sdk lub oficjalny openai działa po drobnych zmianach konfiguracji. Wskaż swojego klienta na nasz base URL i użyj identyfikatora modelu uncensored.

Pozwala to na budowanie generowania tekstu po stronie serwera dla Twoich aplikacji kreatywnych. Możesz tego użyć do wstępnego przetwarzania wejść użytkownika lub przetwarzania końcowego wygenerowanych scenariuszy przed wysłaniem ich do endpointów generowania audio lub wideo. API zwraca standardowe odpowiedzi JSON kompatybilne z nowoczesnymi frameworkami webowymi.

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

Odpowiedzi strumieniowe

Dla długich scenariuszy lub szczegółowych metadanych użyj Server-Sent Events (SSE), aby otrzymywać tokeny w czasie rzeczywistym. Ustaw stream: true w ciele zapytania. API wyśle serię fragmentów, pozwalając wyświetlać tekst w miarę jego generowania.

Jest to szczególnie przydatne dla interaktywnych narzędzi kreatywnych, gdzie użytkownicy chcą widzieć ewoluujący prompt podczas jego pisania. Każdy fragment zawiera tylko tekst delta, więc musisz połączyć fragmenty, aby odtworzyć pełną odpowiedź.

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)

Limity, błędy i kontekst

Konto jest ograniczone do jednego klucza API, który można wygenerować ponownie w dowolnym momencie (unieważniając stary). Masz do dyspozycji 300 zapytań na minutę na klucz, przy maksymalnym rozmiarze ciała zapytania 8 MB.

Typowe błędy to 401 dla nieprawidłowych kluczy, 402 jeśli masz niewystarczający przedpłacony kredyt, oraz 429 za limity zapytań. Model obsługuje okno kontekstu 100 000 tokenów dla wejścia i wyjścia łącznie.

Uwaga dotycząca treści: Model nie odrzuca kontrowersyjnych tematów lub treści dla dorosłych, ale ściśle blokuje treści seksualne z udziałem małoletnich we wszystkich zapytaniach.