数分でVenice AI APIを統合

ベースURLと認証設定

APIは https://api.veniceaiapi.com/v1。単一のAPIキーを Authorization ヘッダー。

Googleまたはメールアドレスでサインアップし、キーを取得してください。電話番号は不要です。ベースURLを設定して、任意のOpenAI互換SDKとキーを使用してください。

各アカウントにはアクティブなキーが1つ保持されます。新しいキーを生成すると、古いキーは即時取り消されます。これにより、複雑な権限スコープなしでシンプルなアクセス制御が実現します。

送信する必須のモデルIDは"uncensored"です。これは法的な成人用途においてコンテンツ拒否なしで回答するように調整されたオープンウェイトモデルです。

• ベースURL： https://api.veniceaiapi.com/v1
• Authヘッダー: Authorization: Bearer YOUR_API_KEY
• モデル： uncensored

シンプルなGETリクエストで接続性をテストできます。 /v1/modelsこれにより、重いペイロードを送信する前にキーが機能することが確認されます。

/v1/chat/completions エンドポイント

テキストプロンプトを POST /v1/chat/completions テキスト応答を受け取ります。このエンドポイントはすべての標準的なチャット対話を処理します。

roleとcontentフィールドを持つmessages配列を含めてください。モデルは入力を処理し、補完を返します。出力長は、を使用して制御できます。 max_tokens パラメータ。

デフォルトの最大出力は2,048トークンです。リクエストごとに最大16,000トークンまで増やすことができます。総コンテキストウィンドウは、プロンプトと補完を合わせて100,000トークンを許可します。

エラーや拒否はプリペイドクレジットを消費しません。つまり、成功したトークンの生成に対してのみ課金されます。

モデルパラメータ：温度、Top-P、およびシード

標準の LLM パラメータを使用して出力のランダム性を制御します。設定 temperature 創造性を調整します。低い値は、より決定論的で焦点を絞ったレスポンスを生成します。

使用 top_p ヌクレウスサンプリング用。これはモデルが確率質量の上位パーセンテージのみを考慮するように制限します。反復的または意味不明な出力の防止に役立ちます。

設定 seed 再現性のために。これは、デバッグや特定のプロンプトバリエーションのテストに有用です。また、 stop シーケンスで生成を早期に停止します。

その他のサポートされているパラメータ presence_penalty および frequency_penaltyこれらは長文の会話におけるトークンの多様性を管理するのに役立ちます。

ユースケースに合わせてこれらの設定を調整してください。ロールプレイは高いtemperatureを好みます。コード生成には低い値が必要になる場合があります。

サーバーサイドイベント（SSE）によるストリーミングレスポンス

streamをtrueに設定してストリーミングを有効にする stream: true リクエスト内。APIは単一のJSONオブジェクトの代わりにServer-Sent Events (SSE)を返します。

各チャンクには部分的なテキストコンテンツが含まれます。これにより、ユーザーにリアルタイムで結果を表示できます。長い応答に対する知覚されるレイテンシーが大幅に改善されます。

最終チャンクには合計トークン使用量の統計情報が含まれています。これにより、クレジットの消費状況をリアルタイムで正確に追跡できます。

ストリーミングエラーを適切に処理します。ネットワークの中断によりレスポンスが切り捨てられる場合があります。必要に応じてリクエストの再開または再試行が可能です。

関数呼び出しとJSONモード

バックエンドロジックとAPIを統合するために関数呼び出しを使用します。リクエスト内でツールを定義すると、モデルは構造化されたJSON引数を返します。

設定 response_format: {"type": "json_object"} 厳格なJSON出力を強制します。これはアプリケーションへのデータ解析に最適です。

関数呼び出しはストリーミングと並行して動作します。構造化データをリアルタイムで受信できます。これにより、複雑な複数ステップの対話を可能にします。

このモデルはツールの定義を理解し、それに従って実行します。ツール実行ロジックはコード側で処理します。

この機能により、APIはエージェントの構築や自動化ワークフローに適したものになります。

レート制限とトークン制約

各APIキーは1分あたり300リクエストに制限されています。同時に8つのリクエストを実行できます。これにより、突然のバーストがシステムを圧倒するのを防ぎます。

最大リクエストボディサイズは8 MBです。ペイロードがこの制限内に収まることを確認してください。大きなコンテキストウィンドウはこのクォータをすぐに消費します。

よくあるエラーには、無効なキーによる401とクレジット不足による402が含まれます。429エラーはレート制限に達したことを示します。

クレジットに対する返金は利用できません。ただし、二重請求などのミスはサポート経由で修正されます。あなたのクレジットは有効期限がありません。

料金は入力トークン1Mあたり$0.15、出力トークン1Mあたり$0.50です。チャージは暗号通貨のみで、金額は$20〜$500です。

cURL

Copycurl https://api.veniceaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return status as json"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

ストリーミング

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)