Unhinged Grokユーザー向けクイックスタート
Base URLとAPIキーを更新するだけで、既存のOpenAI SDKを当社の無検閲LLM APIに5分で接続できます。このガイドでは、標準的なクライアントコードを使用して最初のリクエストを送信する方法を示します。
認証とベースURL
当APIはOpenAI互換であるため、新しいライブラリは必要ありません。既存の設定ファイルの2つの値を更新するだけで済みます:base_urlとapi_keyです。APIキーはGoogleまたはメールアドレスによるサインイン時に生成されます。このキーは安全に保管してください。認証に必要な唯一の認証情報です。
標準のOpenAIベースURLを当社のエンドポイントに置き換えます。この変更により、後続のすべてのリクエストが当社の無検閲モデルサーバーに送信されます。基本的なテキスト生成には他のコード変更は必要ありません。
設定例
- Base URL:
https://api.unhingedgrok.com/v1 - APIキー: ダッシュボードからの固有のキー
利用可能なモデルを一覧表示して接続を確認します。これにより、生成リクエストを送信する前に認証が正しく機能していることを確認できます。
最初のリクエスト
単純なテキスト補完リクエストの送信から始めましょう。この例ではcurlを使用して、生HTTPの構造を示します。リクエストはモデルIDuncensoredで/v1/chat/completionsエンドポイントを対象としています。レスポンスはchoices配列に生成されたテキストを返します。
この直接的なアプローチは、標準的なOpenAI HTTP形式をサポートするあらゆる言語やツールで機能します。キーを生成した直後にこれをテストできます。
直接HTTPリクエスト
curl https://api.unhingedgrok.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統合
公式のOpenAI Pythonライブラリを使用して当社のAPIを統合します。pip経由でパッケージをインストールします。キーとカスタムベースURLを使用してクライアントを初期化します。chat.completions.createなどの他のSDKメソッドは、OpenAIのドキュメントに記載されているとおりに機能します。
この方法は、バックエンドサービス、データ処理スクリプト、または自動化されたワークフローに最適です。SDKはJSONシリアライゼーションとレスポンス解析を自動的に処理します。
Pythonコード例
from openai import OpenAI
client = OpenAI(base_url="https://api.unhingedgrok.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 SDK統合
JavaScriptまたはTypeScript環境では、公式のopenainpmパッケージを使用します。同じベースURLとキーでクライアントを設定します。Node SDKはコールバックとプロミスベースの両方のパターンをサポートしています。
このセットアップにより、無検閲テキスト生成をWebアプリケーション、サーバーレス関数、またはNodeベースの自動化ツールに直接組み込むことができます。エラー処理は標準的なOpenAI SDKの動作と一貫しています。
Node.jsコード例
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unhingedgrok.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);
ストリーミングレスポンス
stream: trueを設定してリアルタイムのトークン生成を有効にします。APIはServer-Sent Events(SSE)ストリームを返します。各チャンクには部分的なレスポンスが含まれます。最終チャンクにはトークン使用統計が含まれます。
ストリーミングはエンドユーザーの知覚レイテンシを削減します。チャットインターフェースやインタラクティブアプリケーションには不可欠です。UIを直ちに更新するために、各チャンクを逐次処理してください。
ストリーミングコード例
stream = 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)
制限、エラー、コンテキスト
サービスの中断を避けるために運用上の制約を理解してください。コンテキストウィンドウは合計100,000トークンをサポートし、max_tokensが未設定の場合、レスポンスはウィンドウの最後まで実行されることがあります。
レート制限はキーあたり1分あたり300リクエストを許可します。同時リクエストは8に制限されます。リクエストボディは8 MBを超えてはいけません。標準的なHTTPエラーコードを処理してください:401は無効なキーを示し、402はクレジット不足を示し、429はレート制限を示します。エラーはクレジットを消費しません。
技術仕様
購入前に確認できるよう、API の実際の制限と機能をすべてまとめました。
| 項目 | 内容 |
|---|---|
| 形式 | OpenAI 互換:どの OpenAI SDK でも base URL とキーを変えるだけで動作 |
| エンドポイント | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.unhingedgrok.com/v1 |
| 認証 | Authorization: Bearer YOUR_KEY |
| モデル ID | uncensored |
| JSON モード | response_format: {"type": "json_object"} |
| パラメータ | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| ストリーミング | 対応 — SSE、最後のチャンクにトークン使用量 |
| 最大出力 | 100,000 トークンのウィンドウの残りまで。max_tokens は任意(個別の上限なし) |
| コンテキスト長 | 100,000 トークン(入力+出力) |
| 関数呼び出し | 対応 — tools、tool_choice。応答に tool_calls(ストリーミングでも)、結果は role: tool で返送 |
| レート制限 | キーごとに毎分 300 リクエスト |
| リクエストサイズ | 最大 8 MB |
| 同時実行 | キーごとに同時 8 リクエストまで |
| レスポンスヘッダー | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| ボーナス | $50 以上で +5%、$100 以上で +10%、$200 以上で +15% |
| チャージ | USDT(TRC20)または USDC(Base)、$20〜$500 の任意の整数額 |
| 有効期限 | 購入クレジットは失効なし、サブスクなし |
| 料金 | 入力 100 万トークン $0.15 · 出力 100 万トークン $0.50 |
| 無料トライアル | $0.50、7 日間、カード不要 · トライアルキー: 同時2件、毎分60件。初回チャージ後に上限が8件・300件へ拡大 |
| 課金 | 前払いクレジットから実使用量で課金。エラーと拒否は無料 |
| キー | アカウントごとに有効なキーは 1 つ。新しいキーで旧キーは無効 |
| ログイン | Google またはメール+パスワード |
| コンテンツ | 成人向けコンテンツ可。未成年者を含む性的コンテンツは拒否 |
エラーコード
エラーは固定の type を持つ JSON で返ります。失敗・拒否されたリクエストは課金されません。
| コード | タイプ | 意味 |
|---|---|---|
400 | bad_request | JSON 不正、メッセージ空、パラメータ誤り、またはコンテキスト超過 |
401 | missing_key · invalid_key · key_revoked | キーなし・誤り・新しいキーに置換済み |
402 | no_credit | 残高ゼロ — チャージすれば即再開 |
403 | content_blocked | 未成年者を含む性的コンテンツ — 拒否、課金なし |
404 | not_found | 不明なエンドポイント |
413 | request_too_large | 本文が 8 MB 超 |
429 | rate_limited · concurrency | 毎分 300 回または同時 8 件を超過 — 待って再試行 |
503 | upstream_busy | モデル混雑 — 数秒後に再試行 |
質問と回答
これは公式のGrok APIですか?
いいえ。当社は独自の無検閲モデルをホスティングする独立したサービスです。X Corpや公式Grok APIとは提携していません。当社のAPIはOpenAIクライアント形式と互換性がありますが、異なるモデルを実行しています。
利用料の支払い方法は?
クレジットは暗号資産(TRC20上のUSDTまたはBase上のUSDC)でチャージされます。前払いクレジットは実際のトークン使用量に基づいて課金されます。エラーと拒否は無料です。クレジットは期限切れになりません。
コンテキストウィンドウのサイズはいくらですか?
モデルはプロンプトと補完を合わせて100,000トークンのコンテキストウィンドウをサポートします。出力に個別の上限はありません。max_tokensが指定されない場合、応答はウィンドウの末尾まで実行されます。
キーはフォーム 1 つで手に入ります
アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。