Szybki start API TTS

Base URL i uwierzytelnianie

Skonfiguruj klienta, aby wskazywał nasz base URL: https://api.ttsapihub.com/v1. Nasze API jest w pełni kompatybilne z OpenAI, więc możesz używać standardowych SDK, zmieniając tylko base_url i podając swój klucz API. Uwierzytelnianie odbywa się przez nagłówek Authorization z tokenem Bearer. Unikalny klucz generujesz podczas rejestracji na stronie Uzyskanie klucza API. Na koncie może być aktywny tylko jeden klucz, który możesz wygenerować ponownie w dowolnym momencie. Twoje prompty nie są używane do trenowania modelu, a do rozpoczęcia nie potrzebujesz karty ani numeru telefonu.

Generowanie tekstu przez Chat Completions

Wyślij standardowe zapytanie POST /v1/chat/completions, aby wygenerować tekst. ID modelu to uncensored. Jest to LLM o otwartych wagach dostosowany do odpowiadania bez odmów treści przy prawnym użyciu dorosłym, co czyni go idealnym do kreatywnych skryptów lub dialogów, gdzie korporacyjne filtry mogłyby zablokować Twoją treść. Nie generuje audio, obrazów ani wideo; zwraca czysty tekst do przetworzenia przez Twój potok TTS. Możesz dostosować parametry takie jak temperature i max_tokens. API obsługuje wywoływanie funkcji do ekstrakcji danych strukturalnych, pozwalając na formatowanie odpowiedzi dla Twojej aplikacji.

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

Integracja z Python SDK

Dla programistów Python oficjalny SDK openai działa od razu przy minimalnej konfiguracji. Zainicjuj klienta, podając base URL i klucz API, a następnie wywołaj chat.completions.create(). To podejście pozwala wykorzystać istniejące klienty kompatybilne z OpenAI, czerpiąc jednocześnie korzyści z naszego modelu bez cenzury. Odpowiedź zawiera wygenerowany tekst, który możesz bezpośrednio przekazać do silnika syntezy mowy. Pamiętaj, że jest to API tylko tekstowe, więc generowanie audio obsługujesz osobno w swoim potoku.

Copyfrom openai import OpenAI

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

Integracja z Node SDK

Programiści Node.js mogą użyć pakietu npm openai z tą samą konfiguracją co w Python. Ustaw baseURL na nasz endpoint i podaj klucz API. Wywołaj endpoint completions z ID modelu uncensored. Integracja jest prosta i pozwala na bezpośrednie włączenie generowania tekstu do istniejących usług TTS Node.js. API zwraca standardowy JSON, co ułatwia parsowanie i przetwarzanie wygenerowanego tekstu.

Copyimport OpenAI from "openai";

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

Strumieniowanie odpowiedzi przez SSE

Aby zmniejszyć opóźnienia, włącz strumieniowanie, ustawiając stream: true w zapytaniu. API zwraca zdarzenia wysyłane przez serwer (SSE) zawierające przyrostowe fragmenty tekstu. Jest to szczególnie przydatne przy generowaniu długich treści, ponieważ użytkownicy widzą tekst w czasie rzeczywistym. Odpowiedź strumieniowa jest zgodna ze standardowym formatem SSE OpenAI, więc możesz użyć istniejących parserów strumieni. To podejście skraca czas oczekiwania i pozwala wyświetlać tekst w miarę jego generowania, poprawiając UX w Twoim potoku TTS.

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 okno kontekstu

Twój klucz API jest ograniczony do 300 zapytań na minutę i 8 MB treści zapytania. Model obsługuje okno kontekstu 100 000 tokenów, umożliwiając długie skrypty lub dokumenty. Typowe błędy to 401 (nieprawidłowy klucz), 402 (niewystarczający kredyt) i 429 (limit zapytań). Jeśli osiągniesz limit zapytań, wdróż wykładnicze opóźnienie ponownych prób. Ceny są przejrzyste: $0,25 za 1M tokenów wejściowych i $1,00 za 1M tokenów wyjściowych. Kredyty są przedpłacone, nie wygasają, a doładowania zaczynają się od $10. Nowe konto otrzymuje $0,50 w darmowym kredycie próbnym ważnym przez 7 dni, bez karty. Ograniczenia treści blokują tylko treści seksualne z udziałem małoletnich; wszystkie inne prawne, fikcyjne lub kontrowersyjne tematy dla dorosłych są dozwolone.