하나의 엔드포인트를 통한 프롬프트 및 스크립트
무검열 텍스트 API 키를 얻고 몇 분 안에 stableaudio 텍스트 파이프라인에 요청을 보내세요. 예측 가능한 선불 청구로 프롬프트 엔지니어링, 자막 생성 또는 사후 처리를 위해 OpenAI 호환 엔드포인트를 사용하세요.
기본 URL 및 인증
표준 OpenAI 호환 클라이언트와 함께 기본 URL https://api.stableaudio.top/v1을 사용하세요. Authorization 헤더에 Bearer YOUR_API_KEY 형식으로 API 키를 전달하세요. Google 또는 이메일 + 비밀번호로 API 키 발급 페이지에서 키를 즉시 생성할 수 있습니다. 각 계정당 활성 키는 하나만 지원되며, 새 키를 발급하면 이전 키가 대체됩니다. 엔드포인트는 POST /v1/chat/completions 및 GET /v1/models만 지원합니다. 여기서는 임베딩, 이미지, 오디오 또는 비디오 생성이 제공되지 않습니다. 이는 오디오 파이프라인을 위한 텍스트 전용 레이어입니다.
첫 번째 요청 보내기
텍스트 생성을 위해 표준 채팅 완료 요청을 보내세요. 모델 ID는 uncensored입니다. 이는 합법적인 성인 주제에 대한 콘텐츠 거부를 줄이도록 조정된 오픈 웨이트 모델입니다. temperature 및 top_p와 같은 매개변수를 조정할 수 있습니다. 모델은 100,000개의 토큰 컨텍스트 창을 지원합니다. 응답당 최대 32,000개의 토큰을 요청할 수 있습니다. 가격은 투명합니다: 입력 토큰 100만 토큰당 $0.15, 출력 토큰 100만 토큰당 $0.50입니다. 오류 및 거부에는 크레딧이 소모되지 않습니다.
curl https://api.stableaudio.top/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 SDK 통합
공식 OpenAI Python SDK를 사용하여 Python 스크립트에 API를 통합하세요. 클라이언트 구성에서 base_url과 api_key을 설정하세요. 이렇게 하면 이미 OpenAI 인터페이스를 사용하는 기존 코드베이스를 활용할 수 있습니다. 클라이언트는 JSON 직렬화와 응답 파싱을 자동으로 처리합니다. 응답을 스트리밍하거나 배치 모드로 처리할 수 있습니다. 이 접근 방식은 오디오 워크플로우를 위한 프롬프트 생성, 스크립트 작성 또는 텍스트 입력에서 구조화된 데이터 추출에 적합합니다.
from openai import OpenAI
client = OpenAI(base_url="https://api.stableaudio.top/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 SDK 통합
OpenAI Node SDK를 사용하여 Node.js 애플리케이션에 API를 통합하세요. 올바른 기본 URL과 API 키로 클라이언트를 구성하세요. 이는 표준 OpenAI 패턴과의 호환성을 보장합니다. 동기식 또는 비동기식 요청을 수행할 수 있습니다. 웹 훅 또는 백그라운드 작업에서 실시간 텍스트 처리에 사용하세요. SDK는 재시도 로직과 응답 파싱을 처리합니다. 구독 요금 없이 신뢰할 수 있는 무검열 텍스트 출력이 필요한 보이스오버 스크립트 또는 자막 파이프라인 구축에 이상적입니다.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.stableaudio.top/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);
스트리밍 응답 (SSE)
요청에 stream: true을 설정하여 스트리밍을 활성화하세요. API는 Server-Sent Events (SSE)를 반환합니다. 토큰 사용량 정보는 마지막 청크에 포함됩니다. 이는 긴 텍스트 생성에 대한 지각된 지연 시간을 줄입니다. 실시간 자막 생성 또는 대화형 프롬프트 개선에 사용하세요. 모델 ID는 uncensored로 유지됩니다. 스트리밍은 가격 모델을 변경하지 않습니다. 생성된 실제 토큰에 대해서만 요금이 청구됩니다. 스트리밍 중 오류는 추가 크레딧 소모 없이 우아하게 처리됩니다.
stream = 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)
토큰 제한 및 할당량
이 모델은 100,000개의 토큰 컨텍스트 창을 지원합니다. 최대 출력은 요청당 32,000개의 토큰이며, max_tokens이 설정되지 않은 경우 2,048개입니다. 키당 분당 요청 수는 300개로 제한됩니다. 키당 동시 요청 수는 최대 8개로 제한됩니다. 요청 본문 크기는 8 MB를 초과할 수 없습니다. 속도 제한을 초과하면 429 오류가 발생합니다. 키가 유효하지 않으면 401 오류가 발생합니다. 선불 크레딧이 부족하면 402 오류가 발생합니다. 오류 및 거부는 무료입니다. 크레딧은 만료되지 않습니다. 카드(Visa, Mastercard, Apple Pay, Google Pay) 또는 암호화폐(USDT(TRC20), USDC(Base))로 $20에서 $500까지 충전할 수 있습니다.
API 사양
크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.
| 항목 | 내용 |
|---|---|
| 형식 | OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작 |
| 모델 ID | uncensored |
| 엔드포인트 | POST /v1/chat/completions · GET /v1/models |
| 인증 | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.stableaudio.top/v1 |
| 파라미터 | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON 모드 | response_format: {"type": "json_object"} |
| 최대 출력 | 100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음) |
| 스트리밍 | 지원 — SSE, 마지막 청크에 토큰 사용량 포함 |
| 함수 호출 | 지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송 |
| 컨텍스트 창 | 100,000 토큰 (입력 + 출력) |
| 속도 제한 | 키당 분당 300회 |
| 응답 헤더 | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 요청 크기 | 최대 8 MB |
| 동시 요청 | 키당 동시 8개 |
| 과금 | 선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료 |
| 가격 | 입력 100만 토큰당 $0.15 · 출력 100만 토큰당 $0.50 |
| 보너스 | $50 이상 +5%, $100 이상 +10%, $200 이상 +15% |
| 무료 체험 | $0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용 |
| 충전 | USDT (TRC20) 또는 USDC (Base), $20~$500 사이 원하는 정수 금액 |
| 유효기간 | 유료 크레딧은 만료되지 않으며 구독 없음 |
| 콘텐츠 | 성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부 |
| 키 | 계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효 |
| 로그인 | Google 또는 이메일과 비밀번호 |
오류 코드
오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.
| 코드 | 유형 | 의미 |
|---|---|---|
400 | bad_request | 잘못된 JSON, 빈 메시지, 잘못된 파라미터 또는 컨텍스트 초과 |
401 | missing_key · invalid_key · key_revoked | 키 없음·잘못됨·새 키로 교체됨 |
402 | no_credit | 잔액 없음 — 충전하면 즉시 재개 |
403 | content_blocked | 미성년자 관련 성적 콘텐츠 — 거부, 과금 없음 |
404 | not_found | 알 수 없는 엔드포인트 |
413 | request_too_large | 본문 8 MB 초과 |
429 | rate_limited · concurrency | 분당 300회 또는 동시 8개 초과 — 잠시 후 재시도 |
503 | upstream_busy | 모델 혼잡 — 몇 초 후 재시도 |
질문과 답변
이 API에서 '무검열'이란 무엇을 의미하나요?
모델은 합법적인 성인, 픽션, 보안 연구, 논쟁적인 주제를 거부하지 않습니다. 콘텐츠 거부 없이 답변하도록 조정되었습니다. 유일한 제한은 미성년자가 관련된 성적 콘텐츠는 항상 차단된다는 것입니다.
청구 방식은 어떻게 되며 언제 오류가 무료인가요?
실제 토큰 사용량에 대해서만 요금이 부과됩니다. 오류와 거부는 선불 크레딧을 소모하지 않습니다. 크레딧은 카드(Visa, Mastercard, Apple Pay, Google Pay) 또는 암호화폐(USDT(TRC20), USDC(Base))로 충전되며 만료되지 않습니다. $20에서 $500까지 충전할 수 있습니다.
이미지 또는 오디오 생성에 사용할 수 있나요?
아니요. 이는 텍스트 전용 채팅 API입니다. 프롬프트 작성이나 자막 생성과 같은 오디오 파이프라인의 텍스트 레이어를 지원합니다. 이미지, 오디오, 비디오 자체는 생성하지 않습니다.