あなたが得るもの、そして得られないもの
まず正確に説明します。サイトの名前は誤解を招く可能性があります。これはxAIやGrokの公式APIではありません。これは独立したプロバイダが運用するオープンウェイトモデルをフロントエンドに置いたホスト型APIで、成人による合法的な利用においてコンテンツ拒否なしで応答するようにチューニングされています。また、複数のベンダーをルーティングするものでもありません。xAI独自のモデルが必要な場合は、xAIにアクセスして現在の利用規約と価格表をご確認ください。
有用なのは、標準的な開発者ワークフローです。API は OpenAI の chat completions 形式に対応しているため、すでに使用しているクライアントライブラリはそのまま使えます。ベース URL とキーの2つの値を変更し、モデル ID にuncensoredを渡すだけです。エンドポイントは2つ存在します:POST /v1/chat/completions と GET /v1/models です。認証は標準的な Authorization: Bearer ヘッダーを使用します。
サービスはテキストのみです。画像、音声、動画の生成、埋め込み、ファインチューニングはありません。コンテキストウィンドウは100,000トークンで、プロンプトと生成結果を合わせてカウントされ、max_tokensはオプションです。コンテンツ制限は1つだけあります。未成年者との性的コンテンツが関わるものが、常に禁止です。
それがあなたが構築しているものと一致する場合、このページの残りの部分では、開発者が尋ねる詳細(最初のリクエスト、ストリーミング、構造化出力、ツール、制限、コスト)をカバーします。
最初のリクエスト
APIキーページからアカウントを作成し、キーをコピーしてリクエストを送信してください。サインアップはGoogleまたはメールとパスワードで可能です。新規ユーザーはこのページでワンクリックで$0.50の無料トライアルクレジットを請求でき、1人1回限り、7日間有効です。トライアルキーはフルキーよりも低い制限で動作します:並行2リクエスト、1分あたり60リクエスト。
他の変数をすべて排除するために、curlから始めてください:
curl https://api.uncensoredgrok.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain idempotency keys in two sentences."}
]
}'
公式Python SDKでの同じ呼び出し:
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredgrok.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Explain idempotency keys in two sentences."}],
temperature=0.7,
)
print(resp.choices[0].message.content)
GET /v1/modelsへの呼び出しは、他のデバッグを行う前にAPIキーとBase URLが正しいことを確認するお手軽な方法です。すべてのレスポンスには、X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrencyというヘッダーが含まれます。リクエストIDは独自のログに記録し、自動化されたジョブを実行する場合は残高ヘッダーを確認してください。
temperature、top_p、stop、seed などのサンプリングパラメータ、および頻度ペナルティと存在ペナルティはモデルに渡されます。完全なパラメータの注記は ドキュメントページ にあります。
ストリーミング
stream: trueを設定すると、レスポンスはサーバー送信イベント (SSE) として到着し、トークングループごとにチャンクが送信され、ストリームの最後に使用量が報告されます。チャットインターフェースでは、これが「待機する画面」と「入力する画面」の違いになります。
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a haiku about retries."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
if getattr(chunk, "usage", None):
print("\ntokens:", chunk.usage)
Nodeでのパターンは同じです:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredgrok.com/v1",
apiKey: process.env.API_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a haiku about retries." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
キャパシティプランニングには1つの詳細が重要です。ストリーミングされたリクエストは、ストリームが終了するまで並行スロットを保持します。クライアントがストリームを開いてその後停止する場合、そのスロットは占有されたままになるため、もう読まないストリームは閉じてください。
JSONモードとツール呼び出し
構造化出力のために、response_formatに型json_objectを渡してください。また、プロンプトでJSONを望んでいることと、期待するキーの名前を明記してください。JSONモードはモデルが解析可能なテキストを生成するのを助けますが、コード内で結果を検証し、解析失敗に対応する必要があります。
resp = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
messages=[
{"role": "system", "content": "Reply with JSON only: {\"title\": string, \"tags\": [string]}"},
{"role": "user", "content": "Summarize: a guide to rate limiting for API clients."},
],
)
import json
data = json.loads(resp.choices[0].message.content)
関数呼び出し
ツール呼び出しはOpenAIの形式に従います。toolsとオプションでtool_choiceを送信します。モデルはtool_callsで応答し、関数を実行後、role: "tool"を持つメッセージとして結果を戻します。ツール呼び出しもストリーミング可能です。
import json
tools = [{
"type": "function",
"function": {
"name": "get_order_status",
"description": "Look up an order by id",
"parameters": {
"type": "object",
"properties": {"order_id": {"type": "string"}},
"required": ["order_id"],
},
},
}]
messages = [{"role": "user", "content": "Where is order A-1042?"}]
first = client.chat.completions.create(
model="uncensored", messages=messages, tools=tools, tool_choice="auto"
)
msg = first.choices[0].message
if msg.tool_calls:
messages.append(msg)
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
result = {"order_id": args["order_id"], "status": "shipped"}
messages.append({
"role": "tool",
"tool_call_id": call.id,
"content": json.dumps(result),
})
final = client.chat.completions.create(
model="uncensored", messages=messages, tools=tools
)
print(final.choices[0].message.content)
引数文字列は常に防御的に解析してください。モデルは有効なJSONではない引数を返すことがあり、json.loadsの周りにtry/exceptを1回のリトライ付きで配置することは安価な保険です。
レート制限、429エラーとリトライ
完全なキーでは同時8リクエスト、1分あたり300リクエストが可能です。トライアルキーでは同時2リクエスト、1分あたり60リクエストです。最大のリクエストボディサイズは8 MBです。制限を超えるとHTTP 429エラーが発生し、エラーコードでどの制限を超えたかがわかります。rate_limitedは1分あたりのリクエストが多すぎたことを意味し、concurrencyは同時リクエストが多すぎたことを意味します。一時的な過負荷時には、APIはRetry-After: 5ヘッダー付きの429も返します。
これにより、単純なリトライルールが得られます:429の場合、存在する場合はRetry-Afterを待ち、存在しない場合はジッター付きの指数関数的バックオフを行い、試行回数を制限してください。
import time, random
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredgrok.com/v1", api_key="YOUR_KEY", max_retries=0)
def ask(messages, attempts=5):
for i in range(attempts):
try:
return client.chat.completions.create(model="uncensored", messages=messages)
except RateLimitError as e:
wait = float(e.response.headers.get("Retry-After", 2 ** i))
time.sleep(wait + random.random())
raise RuntimeError("still rate limited")
バッチジョブを実行する場合、フルキーではワーカープールを8に制限してください。8人のワーカーがそれぞれ1つのリクエストを保持するのが上限であり、9番目のワーカーはコードconcurrencyの429しか得られません。失敗または拒否されたリクエストは請求されないため、リトライしてもお金はかかりません。
本番環境で時間を節約する習慣
最初のリクエストが動作し始めると、いくつかのプラクティスがすぐに効果を示します。キーを環境変数またはシークレットマネージャーに保存し、各環境に独自のキーを与えて、他の環境に触れることなく1つをローテーションできるようにしてください。独自のトレースIDの隣にX-Request-Id値をログに記録してください。レスポンスに何か不審な点がある場合、そのIDが引用すべきものです。
クライアントにタイムアウトを設定してください。長い出力を許可する場合、生成に長時間かかるのは正常です。最も長い予想される応答に合わせたタイムアウトを選択し、ユーザーが待機しているものにはストリーミングを使用してください。パラメータはオプションですが、ユーザー向けエンドポイントではmax_tokensに上限を設定してください。これによりレイテンシとコストの両方に天井を設けることができます。
送信する会話履歴を制御された状態に保ってください。ウィンドウは100,000トークンですが、入力はすべての呼び出しで請求されるため、古いターンをトリミングするか要約することが最も安価な最適化です。最後に、サンプリング設定を固定してください。固定された温度とともにseedを設定すると、プロンプトバリアントを比較する際により再現性の高い実行が得られますが、これを同一出力の保証として扱わないでください。
コスト
価格は前払いクレジットから、入力トークン100万あたり$0.15、出力トークン100万あたり$0.50です。サブスクリプションはなく、クレジットは期限切れになりません。具体的な例を示します。2,000入力トークンと500出力トークンのリクエストを考えます:
- 入力:2,000 / 1,000,000 x $0.15 = $0.0003
- 出力:500 / 1,000,000 x $0.50 = $0.00025
- 合計:リクエストあたり$0.00055。したがって、1,000回のそのようなリクエストで$0.55かかります。
したがって、$0.50のトライアルクレジットは、そのサイズの約900リクエストをカバーします。チャージは$20から$500までの任意の整数金額で可能で、$50からは5%、$100からは10%、$200からは15%のボーナスが付きます。例えば$100のチャージでは$110がクレジットされます。このサイトでは暗号資産のみでの支払いが可能で、TRC20上のUSDTまたはBase上のUSDCです。現在の価格表は料金ページをご覧ください。
プロンプトはトレーニングに使用されません。これを別のエンドポイントと比較している場合、既存のトークンごとの支払いと100kコンテキストウィンドウに関する記事が、長い会話での課金計測の動作をカバーしています。
他のオプションがより適している場合
適合について正直になりましょう。画像生成、埋め込み、音声、またはファインチューニングされたモデルが必要な場合、このAPIはそれらを提供しません。契約またはコンプライアンスチームがファーストパーティベンダーを必要とする場合は、そのベンダーを使用してください。特定のラボからの保証されたモデルIDが必要な場合、これは独立したプロバイダーからの単一のオープンウェイトモデルを実行するため、適切な製品ではありません。
適しているのは、OpenAIプロトコルをすでに扱っており、成人による合法的なリクエストを拒否せずに応答するテキストモデルを必要とするアプリケーションです:成人向けのライティングツール、ロールプレイおよびコンパニオンアプリ、難しいテーマに触れるデータラベリング、およびテストハーネス。既存のクライアントを新しいベースURLに向け、クレジットを投入する前に独自のプロンプトで出力を比較してください。
