Dolphin 制限なし API ドキュメンテーション

前提条件と環境設定

リクエストを行う前に、必要な依存関係が環境にインストールされていることを確認することから始めましょう。ダッシュボードからの有効なAPIキーと、PythonやNode.jsなどのサポートされているランタイムが必要です。当社のAPIでは、デフォルトのOpenAIエンドポイントではなく、特定のベースURLにリクエストを送信する必要があります。

APIキーを安全に保管し、環境変数に保存してください。これにより、コードリポジトリでの意図的な公開を防ぐことができます。Googleまたはメールでサインアップ後、すぐに新しいキーを生成できます。

複雑なルーティングの設定や特定のモデルの選択は不要です。このエンドポイントは、直接のテキスト出力用に設計された単一のアンセンサード大規模言語モデルを提供します。

公式 OpenAI SDK のインストール

認証とリクエストフォーマットを自動で処理する公式SDKパッケージをインストールしてください。このライブラリはPythonとNode.jsの両方の環境をサポートし、一貫したインターフェースを提供します。

Pythonユーザーは、標準のpip installコマンドを実行してライブラリを仮想環境に追加してください。Node.js開発者は、同等のパッケージをインストールするためにnpmを使用してください。

SDKはJSONペイロード構造を管理するため、プロンプトの内容や温度やtop_pなどのパラメータに集中するだけで済みます。

スクリプトやモジュールでライブラリをインポートすることで、インストールを確認できます。これにより、クライアントが当社のサーバーに接続する準備ができていることを確認できます。

ベースURLとAPIキーの構成

SDKクライアントを特定のベースURLにポイントして、リクエストを当社の無制限インフラストラクチャにルーティングしてください。使用 https://api.dolphinuncensored.com/v1 エンドポイントとして使用します。

APIキーを認証ヘッダーまたはクライアント設定オブジェクトに設定してください。クライアントは自動的にこのキーをすべてのリクエストに付加します。

設定でモデルIDを「uncensored」として指定してください。これにより、生成に使用するモデルのバージョンをサーバーに伝えます。

最初のチャット完了リクエスト

接続を確認し、応答を受け取るために簡単なメッセージを送信します。これにより、キーが有効でエンドポイントに到達可能であることが確認されます。

システムプロンプトとユーザーメッセージを使用してchat-completionsエンドポイントを使用します。レスポンスには、contentフィールドに生成されたテキストが含まれます。

ストリーミングとトークン使用量の理解

完全な応答を待つのではなく、生成されるトークンを受信するためにストリーミングを有効にします。これにより長い出力の知覚されるレイテンシが向上します。

APIはストリームの最後のチャンクに使用統計を返します。これにより、課金の透明性のために入力および出力トークン数を追跡できます。

リクエストボディでstreamパラメータをtrueに設定します。チャンクをイテレートして、最終テキストを構築するか、リアルタイムで処理します。

エラーと拒否の処理

APIキーが正しく期限切れでないことを確認してHTTP 401エラーを処理します。402エラーは前払いクレジットが不足していることを示します。継続するために暗号通貨でクレジットを追加してください。

429ステータスは、1分あたり300リクエストのレート制限に到達したことを意味します。再試行する前に少し待つか、同時実行数を減らしてください。

モデルは未成年者との性的コンテンツを含むリクエストを拒否します（これがハードリミットです）。その他の論争的または成人向けトピックは一般的に許可されます。エラーと拒否はトークンクレジットを消費しません。

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

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