Vibevoiceパイプライン向けクイックスタート

前提条件

統合する前に、アクティブなアカウントを準備してください。APIキー取得ページでGoogleまたはメールからサインアップすると、一意のキーが即座に発行されます。初期の$0.50トライアルにはクレジットカードは不要です。当社の無検閲llmは標準エンドポイント経由でモデルID「uncensored」を提供します。ベースURLはhttps://api.vibevoice.top/v1.です。この設定は任意のOpenAI SDKと互換性があり、既存のパイプラインへのそのまま置き換えが可能です。

認証

AuthorizationヘッダーにAPIキーを渡してください。形式は「Bearer YOUR_API_KEY」である必要があります。キーが不足または無効な場合、APIは401エラーを返します。テキスト処理に特化しているため、パイプラインがテキストデータのみを送信することを確認してください。キーは1つのアカウントに紐付きます。新しいキーを生成すると古いキーは即座に無効になります。この簡素さにより、開発環境での迅速な反復が可能になります。

リクエストの送信

/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()などのおなじみのメソッドを使用できます。これはOpenAI互換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版と同じパラメータをサポートしています。これはオンデマンドでテキストを生成する必要があるWebサーバーやエッジ関数に最適です。

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);

クライアントオブジェクトのライフサイクルを適切に管理して、リソースリークを防いでください。この統合は、現代のWebアプリケーションにおける非同期テキスト生成タスクの処理に堅牢です。

ストリーミングレスポンス

リクエストで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)

ストリームを正しく処理して、すべてのデータを処理してください。接続が切断されると、最終的な使用データを見逃す可能性があります。この機能は、テキストが書き込まれると同時に表示するアプリケーションに価値があります。