Szybki start dla potoków Acestep

Wymagania wstępne: Pobierz klucz API

Przed wysłaniem żądań potrzebujesz ważnego klucza API. Odwiedź stronę Pobierz klucz API na acestep.cc. Możesz zarejestrować się, używając przycisku Kontynuuj z Google lub tworząc konto z adresem e-mail i hasłem. Nie jest wymagany numer telefonu. Po rejestracji Twój klucz API jest wyświetlany natychmiast. Skopiuj ten klucz; będziesz go używać do uwierzytelniania wszystkich kolejnych żądań. Jeśli nie masz kredytu, będziesz musiał go doładować. Akceptujemy płatności kryptowalutami (USDT w TRC20 lub USDC w Base) dla kwot między $10 a $500. Nowe konta otrzymują $0,50 kredytu próbnego ważnego przez 7 dni, bez potrzeby podawania karty. Chroń swój klucz, ponieważ uwierzytelnia Twoje zużycie względem limitów zapytań i konsumpcji tokenów.

Instalacja

API korzysta ze standardowego protokołu kompatybilnego z OpenAI. Możesz komunikować się z nim za pomocą oficjalnych SDK OpenAI dla wybranego języka lub dowolnego klienta HTTP. Dla Pythona zainstaluj pakiet openai. Dla Node.js zainstaluj openai. Upewnij się, że używasz najnowszej wersji SDK obsługującej niestandardowe adresy bazowe. Adres bazowy naszej usługi to https://api.acestep.cc/v1. Pozwala to na ponowne użycie istniejącego kodu potoku, który oczekuje endpointów OpenAI, po prostu zmieniając adres bazowy i klucz API. ID modelu, który musisz podać w żądaniach, to uncensored. Ten model jest modelem o otwartych wagach LLM dostrojonym do minimalnych odmów dla legalnych treści dla dorosłych, fikcyjnych lub kontrowersyjnych, co czyni go idealnym dla kreatywnych potoków, w których filtry treści mogłyby blokować ważne wyniki kreatywne.

Podstawowe żądanie: Generowanie tekstu

Wyślij żądanie POST do /v1/chat/completions ze swoim promptem systemowym i wiadomościami użytkownika. Model zwróci wygenerowany tekst. Upewnij się, że ustawisz parametr model na uncensored. Możesz kontrolować kreatywność za pomocą temperature i top_p. Okno kontekstu obsługuje do 100 000 tokenów łącznie (prompt + uzupełnienie). Maksymalna ilość wyjściowa na żądanie to 32 000 tokenów lub 2048, jeśli nie określisz max_tokens. Błędy i odmowy nie zużywają kredytu, ale udane generowanie tokenów tak. Użyj tego endpointa do generowania skryptów, opisów lub przetwarzania danych tekstowych przed przekazaniem ich do innych modalności, takich jak API generowania mowy lub obrazów.

Strumieniowanie odpowiedzi

Dla aktualizacji w czasie rzeczywistym ustaw stream: true w żądaniu. API zwraca zdarzenia wysyłane przez serwer (SSE). Każdy fragment zawiera częściowy tekst. Szczegóły użycia tokenów są dostarczane w ostatnim fragmencie strumienia. Jest to przydatne dla aplikacji wyświetlających tekst w miarę jego generowania, co poprawia postrzeganą latencję dla użytkowników. Upewnij się, że Twój klient poprawnie obsługuje SSE. Strumieniowanie pozwala przetwarzać tokeny w miarę ich przybywania, co jest korzystne dla generowania treści długich w Twoim potoku. Pamiętaj, że strumieniowanie nie zmienia cen ani limitów tokenów; nadal płacisz za całkowitą liczbę wygenerowanych tokenów.

Wywoływanie funkcji

API obsługuje wywoływanie funkcji, pozwalając modelowi na generowanie danych strukturalnych na podstawie zdefiniowanych przez Ciebie narzędzi. Zdefiniuj swoje funkcje w parametrze tools. Ustaw tool_choice na auto lub konkretną nazwę funkcji. Model zwróci obiekt wywołania funkcji, jeśli będzie to odpowiednie. Jest to cenne do ekstrakcji danych strukturalnych z tekstu lub przygotowywania danych wejściowych dla kolejnych wywołań API. Możesz również wymusić wyjście JSON, ustawiając response_format na {"type": "json_object"}. Zapewnia to, że model zwróci poprawny JSON, co jest krytyczne dla niezawodnej integracji z Twoim zautomatyzowanym potokiem. Użyj tych funkcji, aby zwiększyć niezawodność kroków przetwarzania tekstu.

Ceny i limity

Ceny to $0,25 za 1 mln tokenów wejściowych i $1,00 za 1 mln tokenów wyjściowych. Kredyt jest przedpłacony i nigdy nie wygasa. Błędy są darmowe. Limity zapytań to 300 żądań na minutę na klucz i 8 równoległych żądań w tym samym czasie na klucz. Maksymalny rozmiar ciała żądania to 8 MB. Jeśli przekroczysz limit zapytań, otrzymasz błąd 429. Błąd 401 oznacza nieprawidłowy lub wygasły klucz. Błąd 402 oznacza niewystarczający kredyt. Zwroty kredytu nie są wydawane; reklamacje są rozpatrywane na stronie Wsparcie. Dozwolony jest jeden aktywny klucz na konto; wygenerowanie nowego klucza zastępuje stary. Bierz te limity pod uwagę przy projektowaniu logiki ponawiania żądań w Twoim potoku.

cURL

Copycurl https://api.acestep.cc/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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.acestep.cc/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.js

Copyimport OpenAI from "openai";

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

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)