開発者向けVenice APIドキュメント

認証とベースURL

ベースURLを以下に設定して即時接続します https://api.veniceapi.com/v1 APIキーを Authorization ヘッダー。このキーは、Googleまたはメールでサインアップした直後に取得できます。この単一モデルはルーティングロジックなしですべてのテキスト生成を処理します。複数のエンドポイントやプロキシ構成を管理する必要はありません。

キーは安全に保管してください。アカウントごとにアクティブなキーは1つのみです。新しいキーを生成すると、以前のキーは無効になります。これにより、トークンの使用と課金の帰属が明確になります。

チャット完了エンドポイント

テキストリクエストを /v1/chat/completions 標準的なHTTP POSTメソッドを使用してエンドポイントにアクセスします。APIはモデル名、システム指示、ユーザーメッセージを含むJSONペイロードを受け取ります。

基本的なリクエストの構造:

Copycurl https://api.veniceapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check if the service blocks adult content in the test endpoint"}]
  }'

レスポンスは生成されたテキスト、トークン使用統計情報、完了フラグを返します。のようなパラメータを使用して動作を調整できます。 temperature または top_pこれらの設定は出力の創造性とランダム性を制御します。

エラーは標準的なHTTPコードを返します。401は無効なキーを示し、402はクレジット不足を意味します。これらのコードを使用して、自動化ワークフローで障害を適切に処理してください。

Python SDK の統合

公式のOpenAI Pythonライブラリを使用して無制限LLMと連携します。VeniceのベースURLとAPIキーを使用してクライアントを設定してください。この方法はリクエストの構築とレスポンスの解析を簡素化します。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.veniceapi.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)

この手法はOpenAI向けに設計された既存のコードベースとシームレスに動作します。アプリケーションロジックを大幅に変更することなく、ベースURLのみを変更すれば済みます。ライブラリがシリアライゼーションとネットワーク接続を自動的に処理します。

モデルIDが uncensored. これにより、Venice が提供する特定のチューニング済みモデルを使用していることを確認できます。他のモデルは同じ動作パターンを示さない場合があります。

Node SDKの統合

OpenAI Node SDKを使用してJavaScriptまたはTypeScriptプロジェクトにAPIを統合します。 baseURL Veniceのエンドポイントにアクセスし、APIキーを入力してください。この設定は同期および非同期の両方の操作をサポートします。

Copyimport OpenAI from "openai";

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

この統合により、チャットボット、コンテンツジェネレーター、またはデータ抽出ツールを迅速に構築できます。SDKはリトライやエラー処理を含むリクエストライフサイクルを管理します。高度なユースケースのために必要な場合はカスタムヘッダーを渡すことができます。

SDKの正しいバージョンをインポートしてください。古いバージョンでは、Venice APIで利用可能なすべての機能がサポートされていない場合があります。互換性に関する詳細はドキュメントをご確認ください。

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

設定することでリアルタイム出力を有効にします stream パラメータを trueAPIは完全なJSONオブジェクトの代わりにServer-Sent Events (SSE) ストリームを返します。これにより、生成されるトークンを表示できます。

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は順序を保証しません。高トラフィック時にはレート制限を注意深く監視してください。

エラー処理と制限

APIはキーあたり1分あたり300リクエストのレート制限を適用しています。同時リクエストはキーあたり最大8つまでです。リクエストボディは8 MBを超えてはいけません。これらの制限を超えると、429 Too Many Requestsエラーが返されます。

コンテキストウィンドウのサイズは、プロンプトと補合を合わせて100,000トークンです。リクエストごとの最大出力は16,000トークンです。もし max_tokens 未設定の場合、制限はデフォルトで2,048トークンになります。切り捨てを避けるために入力を適切に計画してください。

よくあるエラーには、無効なキーによる401とクレジット不足による402が含まれます。これらのコードを処理してユーザーにチャージを促してください。請求の問題はサポートページをご利用ください。クレジットは期限切れにならないため、後でチャージできます。