Vibevoice 파이프라인을 위한 빠른 시작

전제 조건

연동하기 전에 활성 계정이 있는지 확인하세요. API 키 받기 페이지에서 Google 또는 이메일로 회원가입하여 고유한 키를 즉시 받으세요. 초기 $0.50 무료 체험에는 신용카드가 필요하지 않습니다. 당사의 무검열 LLM은 표준 엔드포인트를 통해 "uncensored" 모델 ID를 제공합니다. 기본 URL은 https://api.vibevoice.top/v1.입니다. 이 설정은 모든 OpenAI SDK와 호환되어 기존 파이프라인의 대체재로 사용할 수 있습니다.

인증

Authorization 헤더에 API 키를 전달하세요. 형식은 "Bearer YOUR_API_KEY"여야 합니다. 키가 없거나 유효하지 않으면 API가 401 오류를 반환합니다. 텍스트 처리에 중점을 두므로 파이프라인이 텍스트 데이터만 전송하도록 하세요. 키는 하나의 계정에 연결되며 새 키를 생성하면 이전 키가 즉시 대체됩니다. 이 단순성은 개발 환경에서의 빠른 반복을 가능하게 합니다.

요청 보내기

/v1/chat/completions으로 POST 요청을 만드세요. 모델 ID, 메시지 및 매개변수를 포함하세요. 다음은 cURL을 사용한 기본 예제입니다:

Copycurl https://api.vibevoice.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."}]
  }'

이 요청은 모델에 간단한 지시를 전송합니다. 응답에는 생성된 텍스트가 포함됩니다. 창의성을 위해 temperature와 같은 매개변수를 조정하거나 출력 길이에 엄격한 제한을 설정할 수 있습니다. 이 직접적인 접근 방식은 스크립트, 캡션 또는 다른 도구를 위한 프롬프트 변형을 생성하는 데 이상적입니다.

Python SDK 통합

공식 OpenAI Python 라이브러리를 사용하세요. 기본 URL을 우리 서비스에 연결하도록 구성하세요. api_key로 API 키를 전달하세요. 이를 통해 client.chat.completions.create()와 같은 익숙한 메서드를 사용할 수 있습니다. 호환되는 API이므로 기존 코드 구조에 최소한의 변경만 필요할 것입니다. 이 방법은 백엔드 처리 또는 데이터 추출 작업에 적합합니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.vibevoice.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 통합

JavaScript 환경에서는 openai npm 패키지를 사용하세요. 구성 객체에서 apiKey와 baseURL 속성을 설정하세요. 이렇게 하면 요청이 올바른 엔드포인트로 전송됩니다. Node SDK는 Python 버전과 동일한 매개변수를 지원합니다. 이는 필요할 때 텍스트를 생성해야 하는 웹 서버 또는 엣지 함수에 이상적입니다.

Copyimport OpenAI from "openai";

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

client 객체의 수명을 관리하여 리소스 누수를 방지하세요. 이 통합은 현대 웹 애플리케이션에서 비동기 텍스트 생성 작업을 처리하는 데 강건합니다.

스트리밍 응답

요청에 stream을 true로 설정하여 스트리밍을 활성화하세요. API는 생성되는 대로 청크로 데이터를 반환합니다. 이는 실시간 디스플레이 또는 점진적 텍스트 렌더링에 유용합니다. 마지막 청크에는 전체 토큰 사용량 통계가 포함됩니다. 스트리밍은 최종 사용자의 지각된 지연 시간을 줄입니다.

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)

스트림을 올바르게 처리하여 모든 데이터가 처리되도록 하세요. 연결이 끊기면 최종 사용량 데이터를 놓칠 수 있습니다. 이 기능은 텍스트가 작성되는 대로 표시해야 하는 애플리케이션에 가치가 있습니다.