TTS APIクイックスタートガイド

Base URLと認証

まず、クライアントをBase URLのhttps://api.ttsapihub.com/v1に設定することから始めます。当APIはOpenAIと完全に互換性があるため、base_urlを更新し、APIキーを提供するだけで標準SDKを使用できます。認証はBearerトークンによるAuthorizationヘッダーで処理されます。APIキー取得ページでサインアップ時に一意のキーを生成します。各アカウントはアクティブなキーが1つまでで、いつでも再生成できます。プロンプトは学習に使用されず、トライアルクレジットの開始に電話番号やクレジットカードは不要です。

チャット補完によるテキスト生成

テキストを生成するには標準のPOST /v1/chat/completionsリクエストを送信します。使用するモデルIDはuncensoredです。このモデルは、法的な大人向け用途でコンテンツ拒否なしで回答するように調整されたオープンウェイトLLMであり、企業フィルターがコンテンツをブロックする可能性があるクリエイティブなスクリプトやダイアログに最適です。音声、画像、動画は生成せず、TTSパイプラインで処理するための純粋なテキストを出力します。必要に応じてtemperatureやmax_tokensなどのパラメータを調整できます。APIは構造化データ抽出のための関数呼び出しをサポートしており、アプリケーション向けのレスポンスをフォーマットできます。

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": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK統合

Python開発者向けに、公式のopenaiSDKは最小限の設定でそのまま動作します。Base URLとAPIキーでクライアントを初期化し、chat.completions.create()を呼び出します。この方法により、既存のOpenAI互換クライアントを活用しつつ、無検閲モデルの恩恵を受けることができます。レスポンスには生成されたテキストが含まれており、これを直接音声合成エンジンにフィードできます。これはテキストのみのAPIなので、音声生成はパイプライン内で別途処理してください。

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": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node SDK統合

Node.js開発者は、Pythonと同じ設定でopenainpmパッケージを使用できます。baseURLをエンドポイントに設定し、APIキーを提供します。モデルIDuncensoredで補完エンドポイントを呼び出します。この統合は簡単で、テキスト生成を既存のNode.js TTSサービスに直接統合できます。APIは標準JSONで応答するため、生成されたテキストをアプリケーションのニーズに合わせて解析・処理するのは容易です。

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: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

SSEによるストリーミングレスポンス

低レイテンシを実現するには、リクエストにstream: trueを設定してストリーミングを有効にします。APIは増分テキストチャンクを含むServer-Sent Events (SSE)を返します。これは、ユーザーがリアルタイムでテキストの表示を確認できるため、長文コンテンツの生成に特に役立ちます。ストリーミングレスポンスは標準的なOpenAI SSE形式に従うため、既存のストリーミングパーサーを使用できます。このアプローチは知覚される待機時間を短縮し、生成されたテキストをアプリケーションに表示することで、TTSパイプラインのユーザーエクスペリエンスを向上させます。

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)

制限、エラー、コンテキストウィンドウ

API キーは1分あたり300リクエスト、リクエストボディ8 MBに制限されます。モデルは100,000トークンのコンテキストウィンドウをサポートし、長いスクリプトやドキュメントに対応できます。一般的なエラーには、401（無効なキー）、402（クレジット不足）、429（レート制限）があります。レート制限に達した場合は、指数バックオフを実装してください。料金は明確で、入力トークン1Mあたり$0.25、出力トークン1Mあたり$1.00です。クレジットは前払いクレジットであり、期限切れせず、チャージは$10から開始します。新規アカウントにはカード不要で7日間有効な無料トライアルクレジット$0.50が付与されます。コンテンツ制限は未成年者の性的コンテンツのみをブロックし、それ以外の法的な大人向け、フィクション、または論争の的となるトピックは許可されます。