Klucz API kompatybilny z OpenAI: Uzyskaj go i wyślij zapytanie
Klucz API kompatybilny z OpenAI to zwykły token Bearer, który działa z dowolną biblioteką OpenAI SDK po wskazaniu klienta na inny bazowy URL. Ta strona pokazuje, jak uzyskać taki klucz dla hostowanego API tekstowego na tej stronie i wykonać działające zapytanie w kilka minut.
ZaktualizowanoSpeech To Text API

Czym tak naprawdę jest klucz
"Kompatybilny z OpenAI" opisuje strukturę API HTTP, a nie firmę stojącą za usługą. Usługa akceptuje ten sam format JSON na POST /v1/chat/completions, który wysyłają biblioteki OpenAI SDK, i odczytuje ten sam nagłówek Authorization: Bearer. Dzięki temu klucz z tej usługi pasuje do dowolnego narzędzia, które pozwala ustawić niestandardowy bazowy URL i klucz API: oficjalnych bibliotek Python i Node, LangChain, zwykłego curla oraz większości klientów desktopowych.
Klucz nie jest kluczem OpenAI i nie zadziała na api.openai.com. Odwrotnie też jest prawdą: klucz OpenAI nie zadziała tutaj. Każdy klucz należy do jednej usługi, a ta obsługuje pojedynczy model o otwartych wagach, dostrojony do odpowiadania bez odmów dotyczących treści, do zgodnego z prawem użytku przez dorosłych, hostowany przez niezależnego dostawcę. Nie jest to oficjalne API żadnego dostawcy modeli i nie przekieruje do innych dostawców.
Pamiętaj o tym. Bazowy URL tej strony to https://api.speechtotextapis.com/v1. ID modelu to uncensored. Kluczem jest dowolny ciąg znaków, który otrzymasz po rejestracji. Wszystko poniżej to wariacje na temat tych trzech wartości.
Usługa obsługuje tylko tekst. Obsługuje uzupełnianie czatu, strumieniowanie, wywoływanie funkcji i tryb JSON. Nie generuje obrazów ani audio, nie oferuje embeddingów i nie dostraja modeli. Jeśli trafiłeś tutaj z potoku mowy, typowym zadaniem jest etap tekstowy po transkrypcji: czyszczenie transkrypcji, dzielenie na sceny, przepisywanie dialogów lub wyodrębnianie danych strukturalnych. Przewodnik po przetwarzaniu scenariuszy głosowych omawia ten aspekt bardziej szczegółowo.
Pozyskaj swój klucz w czterech krokach
- Zarejestruj się. Użyj konta Google lub zarejestruj się pod adresem e-mail z hasłem.
- Otwórz stronę klucza API. Znajduje się ona na stronie klucza na tej stronie. Twój klucz jest tam tworzony i wyświetlany.
- Odbierz kredyt próbny. Przycisk na tej samej stronie daje Ci $0,50 kredytu próbnego jednym kliknięciem. Jest jeden na osobę, ważny przez 7 dni i nie wymaga karty.
- Skopiuj klucz do magazynu sekretów. Zmienna środowiskowa wystarczy do testów lokalnych. W przypadku wdrożeń użyj menedżera sekretów hosta.
Próbny kredyt ma udowodnić, że integracja działa przed płatnością. Przy obecnej cenie wystarczy na wiele krótkich zapytań, a sekcja kosztów poniżej pokazuje rachunek. Kiedy będziesz gotowy, strona z cenami podaje kwoty doładowań. Kredyt jest przedpłacony, bez subskrypcji i nie wygasa, więc nie ma presji na wydatkowanie go przed terminem.
Klucze próbne mają bardziej restrykcyjne limity niż pełne klucze: 2 równoległe zapytania i 60 zapytań na minutę. To wystarczy na pierwsze skrypty. Jeśli planujesz rozproszenie dziesiątek fragmentów transkrypcji równolegle, spodziewaj się trafienia w limit, aż przejdziesz na konto z finansowaniem.
Trzy ustawienia wymagane przez każdy klient
Niezależnie od używanego oprogramowania, ekran konfiguracji pyta o te same trzy rzeczy pod nieco różnymi nazwami.
| Ustawienie | Typowa nazwa pola | Wartość |
|---|---|---|
| Endpoint | Bazowy URL, baza API, host | https://api.speechtotextapis.com/v1 |
| Dane uwierzytelniające | Klucz API, token, sekret | Twój klucz ze strony klucza |
| Model | Model, nazwa modelu, silnik | uncensored |
Jeden szczegół często myli użytkowników: bazowy URL kończy się już na /v1. Biblioteki SDK same dołączają /chat/completions, więc nie powinieneś go dodawać. Jeśli Twój klient (aplikacja) pyta o pełny URL endpointu czatu zamiast bazowego URL, wartością jest https://api.speechtotextapis.com/v1/chat/completions.
Jeśli narzędzie oferuje tylko preset "OpenAI" z sztywno zdefiniowanym hostem i bez możliwości jego edycji, nie zadziała z tą usługą. Szukaj opcji "custom", "OpenAI-compatible" lub "advanced", która udostępnia pole bazowego URL.
Twoje pierwsze zapytanie
Zacznij od curla, ponieważ usuwa on każdą warstwę między Tobą a API. Zastąp YOUR_KEY skopiowanym kluczem.
curl https://api.speechtotextapis.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
]
}'
Poprawna odpowiedź to obiekt JSON z tablicą choices. Tekst znajduje się w choices[0].message.content, a blok usage raportuje tokeny, za które zostałeś rozliczony.
To samo wywołanie za pomocą oficjalnej biblioteki Python wygląda tak. Tylko base_url i api_key różnią się od standardowego ustawienia OpenAI.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.speechtotextapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
],
)
print(resp.choices[0].message.content)
A w Node, używając tego samego pakietu:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.speechtotextapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
],
});
console.log(resp.choices[0].message.content);
Nie musisz ustawiać max_tokens. Gdy jest pominięty, uzupełnienie może użyć tego, co zostało z 100 000-tokenowego okna kontekstu po Twoim prompcie. Ustaw go samodzielnie, jeśli chcesz mieć sztywny limit kosztu na zapytanie.
Sprawdź, czy klucz działa bez wydawania tokenów
Przed podłączeniem klucza do większego systemu wykonaj jedno tanie zapytanie do endpointu modeli. Potwierdzi to, że klucz jest akceptowany i bazowy URL jest poprawny.
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
Flaga -i wypisuje nagłówki odpowiedzi, gdzie to API raportuje przydatny stan:
X-Request-Ididentyfikuje zapytanie. Dołącz go, jeśli skontaktujesz się z wsparciem w sprawie konkretnego wywołania.X-Balance-USDpokazuje pozostały kredyt na koncie.X-RateLimit-Limit-RequestsiX-RateLimit-Limit-Concurrencypokazują limity dotyczące Twojego klucza, więc od razu widać, czy klucz ma limity próbne, czy pełne.
Odczytanie X-Balance-USD we własnym kodzie to tani sposób na ostrzeżenie przed wyczerpaniem kredytu. Zaloguj go raz na zadanie, a nie raz na zapytanie, jeśli nie chcesz generować hałaśliwych danych.
Ile kosztuje użycie klucza
Posiadanie klucza nic nie kosztuje. Płacisz za tokeny: $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych, pobierane z przedpłaconego kredytu. Zapytania nieudane lub odrzucone nie są rozliczane.
Przykład krok po kroku z powyższym wywołaniem czyszczenia transkrypcji. Załóżmy, że prompt ma 1 000 tokenów, a oczyszczona odpowiedź ma 500 tokenów.
- Wejście: 1 000 / 1 000 000 × $0,15 = $0,00015
- Wyjście: 500 / 1 000 000 x $0,50 = $0,00025
- Łącznie: $0,0004 na zapytanie
Kredyt próbny $0,50 pokrywa więc około 1 250 wywołań tego rozmiaru ($0,50 / $0,0004). Twoje własne liczby będą się różnić, ponieważ transkrypcje mają różną długość, ale metoda jest taka sama: policz tokeny wchodzące, policz tokeny wychodzące, pomnóż.
Podczas doładowania akceptowane są dowolne kwoty całkowite od $20 do $500. Większe doładowania dają bonus: +5% od $50, +10% od $100 i +15% od $200. Doładowanie za $100 daje Ci np. $110 kredytu. Możesz zapłacić kryptowalutami (USDT na TRC20, USDC na Base).
Bezpieczne przechowywanie klucza
Klucz API to hasło do Twojego salda. Każdy, kto go ma, może wydać Twój kredyt, więc traktuj go w ten sposób.
- Trzymaj go z dala od kontroli wersji. Odczytuj go ze zmiennej środowiskowej lub menedżera sekretów.
- Nie wysyłaj go w JavaScript w przeglądarce ani w pakiecie aplikacji mobilnej. Wszystko, co działa na urządzeniu użytkownika, może zostać zinspekcjonowane. Umieść mały serwer między frontendem a API i niech serwer doda nagłówek.
- Nie wklejaj go do zrzutów ekranu, zgłoszeń ani wiadomości czatu.
- Jeśli uważasz, że klucz został ujawniony, przestań go używać i skontaktuj się z pomocą techniczną jak najszybciej, zamiast czekać, aż coś się stanie.
Pod kątem prywatności: prompty wysłane do API nie są używane do trenowania. To stwierdzenie dotyczące usługi, a nie powód do wysyłania sekretów, których nie musisz wysyłać. Usuwaj dane osobowe z transkrypcji, gdy zadanie tego nie wymaga.
Gdy połączenie się nie powiedzie
Większość problemów z pierwszego dnia wynika z jednej z czterech przyczyn.
Podstawowy adres URL jest nieprawidłowy
Dwa typowe błędy to brakujący /v1 i podwójny /chat/completions. Porównaj swoją wartość znak po znaku z tą w tabeli powyżej.
Klucz zawiera dodatkowy znak
Kopiowanie ze strony często przynosi ze sobą spację lub znak nowej linii na końcu. Obetnij wartość w swoim kodzie i sprawdź, czy nagłówek ma postać Bearer, jedna spacja, a następnie klucz.
Nazwa modelu to nie uncensored
Klienci często domyślnie wybierają inną nazwę modelu. Ustaw model jawnie przy każdym wywołaniu.
HTTP 429
Istnieją dwa rodzaje, a kod błędu je rozróżnia. rate_limited oznacza, że wysłałeś za dużo zapytań na minutę. concurrency oznacza, że za dużo zapytań było jednocześnie w toku. Zapytanie strumieniowe trzyma slot współbieżności do momentu zakończenia strumienia, więc wolny odbiorca może spowodować ten błąd nawet przy niskiej liczbie zapytań. Błąd 429 z nagłówkiem Retry-After: 5 oznacza, że usługa jest chwilowo przeciążona; poczekaj pięć sekund i spróbuj ponownie. Krótki wykładniczy backoff w Twoim kliencie obsługuje wszystkie trzy przypadki.
Pełną listę parametrów, format strumieniowania i szczegóły wywoływania narzędzi znajdziesz w dokumentacji API.
Więcej przewodników
Pytania i odpowiedzi
Czy to to samo co klucz OpenAI?
Nie. Jest zgodny z tym samym formatem zapytania, więc SDK OpenAI działają z nim, ale jest on wydawany przez tę usługę i działa tylko z podstawowym adresem URL tej usługi.
Czy potrzebuję karty kredytowej, aby uzyskać klucz?
Nie. Zarejestruj się za pomocą Google lub e-maila, a następnie odebierz darmowy kredyt próbny w wysokości $0.50 jednym kliknięciem na stronie klucza. Kredyt próbny nie wymaga karty i jest ważny przez 7 dni.
Jakiej nazwy modelu użyć?
Użyj uncensored w polu modelu. Wywołanie GET /v1/models wylistuje, do czego klucz może uzyskać dostęp.
Czy mogę używać tego samego klucza z kilku serwerów?
Tak, ale limity dotyczą klucza jako całości: 8 jednoczesnych zapytań i 300 zapytań na minutę dla pełnego klucza, 2 i 60 dla klucza próbnego.
Czy klucz działa do obrazów lub mowy?
Nie. API jest tylko tekstowe. Nie generuje ani nie transkrybuje audio ani obrazów i nie posiada embeddingów ani fine-tuningu.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.