OpenAI 호환 API 키: 발급하고 호출하기
OpenAI 호환 API 키는 클라이언트를 다른 베이스 URL로 가리키게 하면 모든 OpenAI SDK에서 작동하는 일반 Bearer 토큰입니다. 이 페이지에서는 사이트의 호스팅 텍스트 API용 키를 얻는 방법과 몇 분 안에 작동하는 호출을 만드는 방법을 보여줍니다.
업데이트됨Speech To Text API

키의 실제 정체
"OpenAI 호환"은 HTTP API의 형태를 설명하며, 그 뒤에 있는 회사를 의미하지 않습니다. 이 서비스는 OpenAI SDK들이 보내는 것과 동일한 JSON 본문 POST /v1/chat/completions을 받으며, 동일한 Authorization: Bearer 헤더를 읽습니다. 그 덕분에 이 서비스의 키는 사용자 지정 베이스 URL과 API 키를 설정할 수 있는 모든 도구에 연결됩니다: 공식 Python 및 Node 라이브러리, LangChain, 일반 curl 및 대부분의 데스크톱 채팅 클라이언트.
이 키는 OpenAI 키가 아니며, api.openai.com에서 작동하지 않습니다. 그 반대도 참입니다: OpenAI 키는 여기서 작동하지 않습니다. 각 키는 하나의 서비스에 속하며, 이 서비스는 합법적인 성인 사용을 위해 콘텐츠 거부 없이 답변하도록 튜닝된 단일 오픈 웨이트 모델을 실행합니다. 독립적인 제공자가 호스팅하며, 어떤 모델 벤더의 공식 API가 아니며 다른 벤더로 라우팅하지 않습니다.
기억해야 할 내용은 다음과 같습니다. 이 사이트의 베이스 URL은 https://api.speechtotextapis.com/v1입니다. 모델 ID는 uncensored입니다. 키는 회원가입 후 얻는 문자열입니다. 아래 내용은 이 세 가지 값을 기반으로 한 변형입니다.
이 서비스는 텍스트 전용입니다. 채팅 완료, 스트리밍, 도구 호출 및 JSON 모드를 처리합니다. 이미지나 오디오를 생성하지 않으며, 임베딩이나 모델 파인튜닝을 제공하지 않습니다. 음성 파이프라인에서 온 경우 일반적인 작업은 전사 후 텍스트 단계입니다: 전사본 정리, 장면으로 분할, 대화 재작성 또는 구조화된 데이터 추출. 음성 스크립트 처리 가이드에서 이를 더 자세히 다룹니다.
네 단계로 키 얻기
- 회원가입하기. Google을 사용하거나 이메일 주소와 비밀번호로 등록하세요.
- API 키 페이지를 엽니다. 이 사이트의 키 페이지에 있습니다. 키가 생성되어 표시됩니다.
- 체험 크레딧을 받습니다. 동일한 페이지의 버튼으로 한 번의 클릭으로 $0.50의 체험 크레딧을 받을 수 있습니다. 1인 1회, 7일 동안 유효하며 카드가 필요하지 않습니다.
- 키를 비밀 키 관리 도구에 복사하세요. 로컬 테스트에는 환경 변수면 충분합니다. 배포된 환경에서는 호스트의 비밀 키 관리 도구를 사용하세요.
체험은 결제 전 통합이 작동하는지 증명하기 위한 것입니다. 현재 가격으로는 많은 짧은 요청을 처리하기에 충분하며, 하단의 비용 섹션에서 계산을 확인할 수 있습니다. 계속 진행할 준비가 되면 가격 책정 페이지에 충전 금액이 나열되어 있습니다. 크레딧은 선불이며 구독이 없고 크레딧은 만료되지 않으므로 기한 전에 충전금을 사용해야 할 압박이 없습니다.
체험 키는 일반 키보다 더 엄격하게 제한됩니다: 동시 요청 2개, 분당 60개 요청. 첫 번째 스크립트에는 충분합니다. 여러 개의 트랜스크립트 청크를 병렬로 처리할 계획이라면, 유료 계정으로 전환하기 전까지 속도 제한에 도달할 것으로 예상하세요.
모든 클라이언트가 요구하는 세 가지 설정
사용하는 소프트웨어에 따라 설정 화면은 약간 다른 이름으로 동일한 세 가지를 묻습니다.
| 설정 | 일반 필드 이름 | 내용 |
|---|---|---|
| 엔드포인트 | 베이스 URL, API 베이스, 호스트 | https://api.speechtotextapis.com/v1 |
| 인증 정보 | API 키, 토큰, 비밀 | 키 페이지의 키 |
| 모델 | 모델, 모델 이름, 엔진 | uncensored |
사람들을 혼란스럽게 하는 한 가지 세부 사항: 베이스 URL은 이미 /v1로 끝납니다. SDK는 /chat/completions을 자체적으로 추가하므로 추가하지 마세요. 클라이언트가 베이스 URL 대신 채팅 엔드포인트의 전체 URL을 묻는 경우 값은 https://api.speechtotextapis.com/v1/chat/completions입니다.
도구가 "OpenAI" 프리셋만 제공하고 하드코딩된 호스트를 사용하고 편집할 방법이 없는 경우, 이 서비스와 통신할 수 없습니다. 베이스 URL 필드를 노출하는 "사용자 정의", "OpenAI 호환" 또는 "고급" 옵션을 찾으세요.
첫 번째 요청
curl로 시작하세요. curl은 사용자와 API 사이의 모든 단계를 제거합니다. YOUR_KEY를 복사한 키로 바꿉니다.
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"}
]
}'
성공적인 응답은 choices 배열을 가진 JSON 객체입니다. 텍스트는 choices[0].message.content에 있으며, usage 블록은 과금된 토큰을 알려줍니다.
공식 Python 라이브러리를 사용한 동일한 호출은 다음과 같습니다. base_url과 api_key만 기본 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)
Node에서도 동일한 패키지를 사용하면 다음과 같습니다:
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);
max_tokens을 설정할 필요가 없습니다. 이를 생략하면 응답 생성은 프롬프트 이후 남은 100,000개 토큰 창을 모두 사용할 수 있습니다. 호출당 비용에 엄격한 상한을 설정하려면 직접 설정하세요.
토큰을 사용하지 않고 키가 작동하는지 확인
키를 더 큰 시스템에 연결하기 전에 모델 엔드포인트로 가벼운 호출을 한 번 수행하세요. 키가 수락되고 베이스 URL이 올바른지 확인합니다.
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
-i 플래그는 응답 헤더를 인쇄하며, 이 API는 유용한 상태를 여기에 보고합니다:
X-Request-Id은 요청을 식별합니다. 특정 호출에 대해 고객 지원에 연락할 때 포함하세요.X-Balance-USD은 계정의 남은 크레딧을 보여줍니다.X-RateLimit-Limit-Requests및X-RateLimit-Limit-Concurrency은 키에 적용되는 제한을 보여주므로 키가 체험 또는 전체 제한을 갖는지 한눈에 알 수 있습니다.
자신의 코드에서 X-Balance-USD를 읽는 것은 크레딧이 떨어지기 전에 경고하는 가벼운 방법입니다. 요청당 한 번이 아닌 작업당 한 번만 로깅하면 불필요한 출력을 피할 수 있습니다.
키 사용 비용
키 보유 비용은 없습니다. 토큰에 대해 지불합니다: 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50은 선불 크레딧에서 차감됩니다. 실패하거나 거부된 요청은 청구되지 않습니다.
위 전사본 정리 호출의 작업 예시. 프롬프트가 1,000개 토큰이고 정리된 응답이 500개 토큰이라고 가정합니다.
- 입력: 1,000 / 1,000,000 x $0.15 = $0.00015
- 출력: 500 / 1,000,000 x $0.50 = $0.00025
- 총: 호출당 $0.0004
따라서 $0.50 체험 크레딧은 해당 크기의 약 1,250회 호출을 사용할 수 있습니다($0.50 / $0.0004). 트랜스크립트 길이가 다르므로 실제 사용량 수치는 다를 수 있지만, 방법은 동일합니다: 입력 토큰을 세고, 출력 토큰을 세고, 곱합니다.
충전 시 $20에서 $500 사이의 정수 금액이 모두 허용됩니다. 더 큰 충전에는 보너스가 따릅니다: $50부터 +5%, $100부터 +10%, $200부터 +15%. 예를 들어 $100 충전 시 $110의 크레딧이 제공됩니다. 암호화폐(TRC20의 USDT, Base의 USDC)로 결제할 수 있습니다.
키 안전하게 보관하기
API 키는 잔액의 비밀번호입니다. 키를 가진 사람은 크레딧을 사용할 수 있으므로 그렇게 취급하세요.
- 소스 제어에 보관하지 마세요. 환경 변수나 비밀 관리자에서 읽으세요.
- 브라우저 JavaScript나 모바일 앱 번들에 이 키를 포함하지 마세요. 사용자 기기에서 실행되는 코드는 모두 검사될 수 있습니다. 프론트엔드와 API 사이에 작은 서버를 두고, 서버에서 헤더를 추가하도록 하세요.
- 스크린샷, 티켓이나 채팅 메시지에 이 키를 붙여넣지 마세요.
- 키가 유출된 것으로 생각되면, 무슨 일이 생길지 기다리지 말고 즉시 사용을 중단한 후 지원팀에 연락하세요.
프라이버시: API로 전송된 프롬프트는 학습에 사용되지 않습니다. 이는 서비스에 대한 사실일 뿐, 비밀을 보낼 이유가 아님을 의미합니다. 작업에 필요하지 않다면 녹취록에서 개인 데이터를 삭제하세요.
호출이 실패할 때
첫날 발생하는 문제의 대부분은 네 가지 원인 중 하나에서 비롯됩니다.
베이스 URL이 잘못되었습니다
두 가지 일반적인 실수는 /v1 누락과 /chat/completions 중복입니다. 표에 있는 값과 문자 단위로 비교하세요.
키에 불필요한 문자가 있습니다
페이지에서 복사하면 종종 끝에 공백이나 개행 문자가 함께 복사됩니다. 코드에서 값을 정리하고, 헤더가 Bearer, 공백 하나, 그 다음 키로 읽히는지 확인하세요.
모델 이름이 uncensored가 아닙니다
클라이언트는 종종 다른 모델 이름을 기본값으로 사용합니다. 모든 호출에서 모델을 명시적으로 설정하세요.
HTTP 429
두 가지 유형이 있으며, 오류 코드로 구분됩니다. rate_limited은 분당 너무 많은 요청을 보냈음을 의미합니다. concurrency은 동시에 너무 많은 요청이 처리 중이었음을 의미합니다. 스트리밍된 요청은 스트림이 끝날 때까지 동시성 슬롯을 유지하므로, 느리게 읽는 클라이언트는 낮은 요청 속도에서도 이 오류를 유발할 수 있습니다. Retry-After: 5 헤더가 있는 429 응답은 서비스가 잠시 과부하 상태임을 의미합니다. 5초를 기다렸다가 다시 시도하세요. 클라이언트에서 짧은 지수 백오프를 구현하면 세 가지 경우 모두 처리할 수 있습니다.
전체 파라미터 목록, 스트리밍 형식 및 도구 호출 세부 정보는 API 문서를 참조하세요.
더 많은 가이드
질문과 답변
이것은 OpenAI 키와 동일한가요?
아닙니다. 동일한 요청 형식을 따르므로 OpenAI SDK와 호환되지만, 이 키는 이 서비스에서 발급되며 이 서비스의 베이스 URL에서만 작동합니다.
키를 얻으려면 신용카드가 필요한가요?
아닙니다. Google 또는 이메일로 가입한 후 키 페이지에서 한 번의 클릭으로 $0.50 체험 크레딧을 청구하세요. 체험은 카드가 필요 없으며 7일 동안 유효합니다.
어떤 모델 이름을 사용해야 하나요?
모델 필드에 uncensored를 사용하세요. GET /v1/models 호출은 해당 키가 접근할 수 있는 것을 나열합니다.
여러 서버에서 동일한 키를 사용할 수 있나요?
네, 하지만 제한 사항은 키 전체에 적용됩니다: 전체 키의 경우 동시 요청 8개와 분당 300개 요청, 체험 키의 경우 각각 2개와 60개입니다.
이 키는 이미지나 음성에도 사용 가능한가요?
아닙니다. API는 텍스트 전용입니다. 오디오나 이미지를 생성하거나 전사하지 않으며, 임베딩이나 파인튜닝 기능도 없습니다.