TTS API 기본 URL: 무엇이며 무엇을 입력해야 하는가

Base URL 및 첫 번째로 알아야 할 사항

tts api base url을 검색해 이 페이지에 도달하셨다면 복사하기 전에 한 가지 세부 사항을 확인하세요: 이 사이트의 서비스는 음성 합성기가 아닌 텍스트 언어 모델 API입니다. Base URL은 https://api.ttsapihub.com/v1이며, POST /v1/chat/completions 및 GET /v1/models을 제공합니다. /audio/speech 경로, 음성 목록 또는 오디오 출력이 없습니다.

그것이 중요한 이유는 많은 도구가 설정을 포괄적으로 표시하기 때문입니다. 클라이언트의 기본 URL 필드는 서버가 텍스트 또는 소리로 응답하든 동일하게 작동합니다. 텍스트를 오디오로 변환하는 것이 목표라면 이 엔드포인트는 적합하지 않습니다. 스크립트, 대화 또는 내레이션 초안을 위해 음성 도구가 읽을 텍스트를 생성하는 것이 목표라면 적합합니다. TTS 파이프라인 체크리스트은 해당 워크플로우를 계획할 때 참고할 곳이며, 빠른 시작 문서에는 모든 요청 매개변수가 나열되어 있습니다.

이 페이지의 나머지 내용은 모든 OpenAI 호환 클라이언트에 적용되므로 Base URL 작동 방식을 배우기 위해 방문하더라도 유용합니다.

Base URL의 실제 정의

API 주소는 두 부분으로 구성됩니다. 첫 번째 부분은 서비스와 인터페이스 버전을 식별합니다. 두 번째 부분은 작업을 지정합니다. 클라이언트 라이브러리가 이들을 연결합니다. OpenAI SDK의 경우 구성 요소는 다음과 같습니다:

파트	내용
기본 URL	https://api.ttsapihub.com/v1
SDK가 추가하는 채팅 경로	/chat/completions
호출되는 전체 주소	https://api.ttsapihub.com/v1/chat/completions
모델 목록 경로	/models

SDK가 경로를 추가하므로 첫 번째 부분만 제공합니다. 이는 단일 줄 변경으로 공급자를 전환하는 아이디어의 핵심입니다. 요청 형식은 공유되므로 요청이 전송되는 위치만 변경하면 됩니다. 키도 변경됩니다. 각 서비스는 자체 키를 발급합니다. 모델 이름도 변경됩니다. 각 서비스는 자체 모델을 명명합니다. 이 API의 모델 ID는 uncensored입니다.

시간을 절약하는 두 가지 작은 세부 사항이 있습니다. 버전 세그먼트 /v1은 인터페이스 세대를 표시하므로 Base URL에 속합니다. 향후 호환되지 않는 인터페이스는 다른 버전 아래에 위치하며, 이동하기로 선택할 때까지 코드가 변경되지 않습니다. Base URL의 후행 슬래시는 대부분의 SDK에서 허용되지만, 결합된 경로에 중복 슬래시가 포함되지 않도록 제거하는 것이 안전합니다.

인증은 표준 Bearer 헤더입니다: Authorization: Bearer YOUR_KEY. SDK는 전달된 키에서 이 헤더를 생성하므로 curl을 제외하고는 직접 작성할 일이 거의 없습니다.

코드에서 Base URL 설정

Python

공식 openai 패키지는 base_url 인수를 사용합니다. 이는 완전한 호출 예시입니다:

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": "Write a two-line scene opening."}],
)
print(resp.choices[0].message.content)

Node

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: "Write a two-line scene opening." }],
});
console.log(resp.choices[0].message.content);

curl

curl을 사용하면 전체 주소를 직접 작성하므로 경로가 포함됩니다:

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": "Say hello."}]}'

환경 변수

최신 버전의 공식 OpenAI SDK는 코드에 전달하지 않을 때 환경에서 OPENAI_BASE_URL 및 OPENAI_API_KEY을 읽습니다. 기존 소프트웨어를 새 엔드포인트에 연결할 때 편집하지 않고도 사용할 수 있어 편리합니다. 셸 또는 프로세스 관리자에서 설정한 후 평소처럼 프로그램을 실행하세요. SDK 버전 문서에서 이를 인식하지 않는 경우 확인하세요.

편집기 및 앱에서 설정

사용자 지정 OpenAI 엔드포인트를 허용하는 도구는 동일한 세 가지 값을 요청합니다. 이름이 다르므로 다음 설명을 찾으세요:

• Cursor: 모델 설정에는 OpenAI Base URL을 재정의하는 옵션이 있습니다. https://api.ttsapihub.com/v1을 붙여넣고 키를 추가한 후 uncensored를 사용자 지정 모델 이름으로 추가하세요. 인터페이스 레이블은 Cursor 버전마다 다르므로 이 이름을 가이드로 사용하세요.
• SillyTavern: Chat Completion을 선택한 후 사용자 지정(OpenAI 호환) 소스를 선택하고 엔드포인트, 키 및 모델을 입력하세요.
• Open WebUI 및 유사한 채팅 프런트엔드: 기본 URL과 키로 OpenAI 유형 연결을 추가하세요.
• 사용자 스크립트: 인터페이스가 HTTPS를 통한 일반 JSON이므로 모든 HTTP 클라이언트가 작동합니다.

일부 도구는 GET /v1/models 호출을 통해 연결을 확인합니다. 이 API는 해당 경로를 지원하므로 확인이 통과됩니다. 일부 도구는 고정 목록에서만 선택할 수 있습니다. 드롭다운 대신 사용자 지정 또는 수동 모델 필드를 찾으세요.

도구의 용도를 기억하세요. Cursor와 같은 편집기는 일반 채팅 모델에 코드 질문을 보내며 이는 작동합니다. 그러나 코드 검색을 위한 임베딩과 같은 특수 엔드포인트에 의존하는 기능은 임베딩이 제공되지 않으므로 여기서 사용할 수 없습니다.

대부분의 기본 URL 오류를 유발하는 실수

거의 모든 첫 번째 연결 실패는 다음 중 하나에서 비롯됩니다.

1. 버전 중복. 기본 URL은 이미 /v1로 끝납니다. 추가하면 주소가 /v1/v1/chat/completions이 되고 서버는 '찾을 수 없음' 오류를 반환합니다.
2. 전체 경로 붙여넣기. Base URL 필드에는 https://api.ttsapihub.com/v1이 필요하며, https://api.ttsapihub.com/v1/chat/completions이 아닙니다. SDK가 경로를 두 번째로 추가합니다.
3. 웹사이트 주소 사용. 읽는 사이트가 API 호스트가 아닙니다. 요청은 위의 api. 호스트로 전송됩니다.
4. 음성 경로 호출. /audio/speech과 같은 경로는 여기에 존재하지 않으며 오류를 반환합니다.
5. 잘못된 또는 누락된 모델 이름. 항상 소문자로 uncensored를 보내세요.
6. 키 문제. 수동 작성된 헤더의 공백 또는 누락된 Bearer 접두사는 인증 오류를 발생시킵니다.

URL 문제를 키 문제와 구분하려면 모델 목록을 요청하세요. 올바른 URL과 잘못된 키는 인증 오류를 발생시킵니다. 잘못된 URL은 '찾을 수 없음', DNS 오류 또는 JSON 대신 HTML 페이지를 반환합니다.

Copycurl https://api.ttsapihub.com/v1/models -H "Authorization: Bearer $API_KEY"
# then a minimal chat call with the model ID "uncensored":
curl https://api.ttsapihub.com/v1/chat/completions -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}'

키 획득 및 비용

이 모든 기능을 사용하려면 키가 필요합니다. API 키 페이지에서 Google 또는 이메일과 비밀번호로 회원가입한 후, 한 번 클릭하여 $0.50 무료 체험 크레딧을 받으세요. 유효 기간은 7일이며, 인원당 한 번만 청구 가능하며 카드가 필요하지 않습니다. 체험 키는 동시 요청 2개, 분당 60개의 요청을 허용하며, 일반 키는 동시 8개, 분당 300개의 요청을 허용합니다.

가격은 입력 토큰 100만 토큰당 $0.15, 출력 토큰 100만 토큰당 $0.50이며 선불 크레딧으로 결제하고 구독은 없습니다. 입력 2,000 토큰, 출력 500 토큰 요청 비용은 $0.0003 + $0.00025로 총 $0.00055입니다. 충전 금액은 $20~$500이며 $50 이상 시 보너스가 제공되고, 카드(Visa, Mastercard, Apple Pay, Google Pay) 또는 암호화폐(USDT TRC20, USDC Base)로 결제할 수 있습니다. 가격 페이지에서 전체 표를 확인하세요. 프롬프트는 학습에 사용되지 않으며, 이 모델은 합법적인 성인 전용입니다. 미성년자가 포함된 성적인 콘텐츠가 없습니다.

더 많은 가이드

• SillyTavern용 무료 API: 체험 크레딧 및 설정
• Python용 TTS API 키: 설정, 스트리밍, JSON 모드
• Elevenlabs API 체크리스트: 무검열 TTS 파이프라인