Dolphin AI Integration Guide

前提条件：SDKとAPIキーの設定

お使いの言語の公式SDKをインストールしてください。ダッシュボードでメールまたはGoogleログインでアカウントを作成してください。APIキーをすぐに発行できます。電話番号は不要です。キーは画面に1回だけ表示されます。安全に保管してください。支払い方法は保存されません。暗号通貨でのチャージにはUSDTまたはUSDCを使用します。残有效期は切れません。エラーは無料です。使用したトークンの分だけ課金されます。

ベースURLとヘッダーの設定

クライアントをベースURLに接続します。認証ヘッダーにキーを設定します。モデルIDは「uncensored」を使用します。これにより非制限モデルに確実にアクセスできます。GPTやClaudeではありません。エンドポイントは標準のチャット完了を受け付けます。ヘッダーにはAPIキーを含める必要があります。他のフィールドはオプションです。Temperatureやtop_pは期待どおり機能します。標準のOpenAIパラメータをサポートしています。制限についてはドキュメントを確認してください。

Copycurl https://api.dolphinllmmodel.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the max token limit for this endpoint?"}]
  }'

最初のチャットCompletionリクエストを送信

メッセージをPOSTリクエストで送信します。コンテキストのためにシステムプロンプトを含めてください。ユーザーメッセージのコンテンツを定義します。モデルはテキスト応答を返します。トークンの最大数を指定できます。デフォルトの出力は2,048トークンです。必要に応じて高い制限を設定してください。コンテキストウィンドウは100,000トークンです。入力と出力はこの制限を共有します。プロンプトが収まることを確認してください。エラーは標準のJSONコードを返します。レスポンスボディでエラーを確認してください。

Copyfrom openai import OpenAI

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

リアルタイム応答のためのストリーミング有効化

リクエストでストリーミングをtrueに設定します。APIはSSE経由でチャンクを返します。各チャンクには部分的なテキストが含まれます。到着するたびにトークンを処理します。これにより知覚されるレイテンシが軽減されます。即時フィードバックが得られます。最終チャンクにはトークン使用量が含まれます。コスト追跡のために使用状況を監視します。ストリーミングはすべてのパラメータで動作します。ツールとJSONモードもストリーミングされます。接続の切断を適切に処理します。ストリームが失敗した場合は再接続します。

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にツールとして渡します。モデルはツール呼び出しを返します。実行のために引数を解析します。結果をモデルに再送信します。これにより複雑なワークフローが可能になります。サポートは標準的なOpenAI形式です。ツール選択は自動にできます。特定のツールを強制することも可能です。JSONモードはツールとも連携します。スキーマが有効であることを確認してください。無効なスキーマはエラーを引き起こします。まずは単純な関数でテストしてください。

Copyimport OpenAI from "openai";

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

レートリミットとエラーの処理

分あたり300リクエストを制限し、8つの同時リクエストを許可します。リクエストボディは8 MB未満である必要があります。401エラーは無効なキーを意味します。認証ヘッダーを確認してください。402エラーはクレジットがないことを示します。継続するために暗号通貨でチャージしてください。429はレート制限に達したことを意味します。バックオフで待機して再試行してください。エラーは無料です。完了したトークンのみがクレジットを消費します。コンテキストは合計100,000トークンです。