API Seedance: prompty i skrypty przez jeden endpoint

Wymagania wstępne: zainstaluj SDK

Przed wysłaniem pierwszego zapytania upewnij się, że masz zainstalowane oficjalne SDK OpenAI dla preferowanego języka. To API korzysta ze standardowego protokołu chat/completions, więc dowolny klient kompatybilny z OpenAI zadziała. Dla Pythona zainstaluj pakiet przez pip. Dla Node.js użyj npm. Potrzebujesz tylko biblioteki klienta; nie są wymagane dodatkowe zależności do podstawowej generacji tekstu lub wywoływania funkcji.

Uwierzytelnianie: ustawienie klucza API

Uwierzytelnianie odbywa się za pomocą prostego tokenu Bearer. Utwórz konto na stronie Uzyskaj klucz API, aby uzyskać swój unikalny klucz. Nie jest wymagana karta kredytowa do wersji próbnej. Przechowuj ten klucz w zmiennej środowiskowej lub pliku konfiguracyjnej aplikacji. Klucz daje dostęp do modelu bez cenzury i jest powiązany z saldem przedpłaconego kredytu. Wygeneruj klucz ponownie w dowolnym momencie z panelu, jeśli zajdzie taka potrzeba.

Wysyłanie żądania uzupełnienia czatu

Wyślij żądanie POST do adresu bazowego. Pole model musi być ustawione na uncensored. Dołącz swój prompt systemowy, aby zdefiniować rolę, oraz wiadomości użytkownika dla generowania treści. Ten endpoint efektywnie obsługuje pisanie scenariuszy, tworzenie napisów i zadania postprodukcji tekstu.

Copycurl https://api.seedanceapis.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."}]
  }'

Strumieniowanie odpowiedzi w czasie rzeczywistym

Dla długich scenariuszy lub napisów w czasie rzeczywistym włącz strumieniowanie, ustawiając stream: true. Interfejs API zwraca strumień zdarzeń wysłanych przez serwer (SSE) z częściowymi uzupełnieniami. Pozwala to Twojej aplikacji wyświetlać tekst w miarę jego generowania, co poprawia postrzeganą opóźnienie. Obsłuż fragmenty strumienia w swoim SDK, aby aktualizować interfejs użytkownika stopniowo.

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)

Wywoływanie funkcji do danych strukturalnych

API obsługuje wywoływanie funkcji do ekstrakcji danych strukturalnych z tekstu lub generowania outputu JSON. Zdefiniuj schematy swoich narzędzi w żądaniu. Model odpowie strukturalnymi argumentami, które Twój kod może wykonać. Jest to idealne do kroków postprodukcji, gdzie potrzebujesz konkretnych pól z wygenerowanych scenariuszy lub metadanych.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.seedanceapis.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)

Zrozumienie limitów i limitów przydziału

Zwracaj uwagę na standardowe kody statusu HTTP. Błąd 401 oznacza, że Twój klucz API jest nieprawidłowy lub wygasł. Błąd 402 wskazuje na niewystarczający przedpłacony kredyt; doładuj konto, aby kontynuować. Błąd 429 sygnalizuje limit zapytań, ograniczony do 300 zapytań na minutę na klucz. Okno kontekstu wynosi łącznie 100 000 tokenów. Zapytania przekraczające 8 MB zostaną odrzucone.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.seedanceapis.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);