シェルを設定し、エンドポイントを確認する
API keyページからキーを取得し、ベースURLとともにエクスポートして、すべてのコマンドにシークレットを貼り付けないようにします。
export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"
すべてのリクエストで、キーはAuthorizationヘッダーにベアラートークンとして送信されます。リクエストボディはJSON形式なので、POST送信時にはContent-Type: application/jsonを追加してください。ボディの最大サイズは8 MBです。プロンプトに非常に大きなドキュメントを貼り付ける場合のみ、これが問題になります。
例ではUnixシェルのシングルクォートを使用しています。Windows PowerShellでは、引用符の問題を避けるためにJSONをファイルに保存し、--data @body.jsonで渡してください。
最も簡単な健全性チェックは、モデルを一覧表示するGETです。キーとURLを確認でき、コストはかかりません。
curl -s "$BASE/models" \
-H "Authorization: Bearer $API_KEY"
返信のdata配列には、ID uncensoredが含まれているはずです。401はキーが不足しているか誤入力されたことを意味します。curlが全く接続できない場合は、$BASEのホストを確認し、余分なパスなしで/v1で終わっていることを確認してください。
1. チャット補完を送信する
これは、すべてのOpenAI互換クライアントが内部で送信するリクエストです。
curl -s "https://api.uncensoredllmapi.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": "Give me three names for a fantasy tavern."}
],
"temperature": 0.8,
"max_tokens": 200
}'
返答はJSON形式です。テキストはchoices[0].message.contentにあり、トークン数はusageに含まれています。jqがインストールされている場合は、テキストのみを取得するために出力をjq -r '.choices[0].message.content'でパイプしてください。max_tokensフィールドはオプションです。指定しない場合、100,000トークンのウィンドウの残分を使って補完が行われる可能性があります。
クライアントがその形式を使用する場合は、新しいPOST /v1/responsesエンドポイントも利用可能です。パラメータの完全なリストについては、ドキュメントを参照してください。
2. 回答をストリーミングする
"stream": trueを追加し、-Nでcurlのバッファリングを無効にします。トークンは生成されるたびに出力されます。
curl -N "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Count from one to ten in words."}]
}'
各行はdata:で始まり、deltaを含む小さなJSONチャンクを含みます。最後のイベントには使用状況が含まれ、ストリームはdata: [DONE]で終了します。-Nなしでは、curlは完全なバッファを待機し、出力は一度に到着したように見えます。ストリーミングリクエストは、終了するまで1つの同時実行スロットを占有することに注意してください。
3. JSONをリクエストする
スクリプトが解析する出力には、response_formatでJSONモードを有効にします。プロンプトにJSONという単語を含め、期待する形状をモデルに伝えます。
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [{"role": "user",
"content": "Return JSON with keys name and level for a fantasy character."}]
}' | jq -r '.choices[0].message.content | fromjson'
最終的なfromjsonフィルタはcontent内の文字列を解析するため、モデルが有効なJSON以外のものを返した場合、jqは明確なエラーを出力します。これは便利なクイックテストになります。さらに多くのパターンはJSONモードのページにあります。
4. ツール呼び出しを試す
ツール呼び出しにより、モデルはコードに関数を実行するよう依頼できます。関数をtools配列で記述し、モデルがそれを使用する決定を下した場合、返信にはテキストの代わりにtool_callsエントリが含まれます。
curl -s "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"tool_choice": "auto"
}' | jq '.choices[0].message.tool_calls'
関数名と引数のJSON文字列が返されます。あなたのコードは関数を実行し、その後、以前のメッセージを繰り返す2番目のリクエストを送信し、ツール呼び出しを含むアシスタントメッセージを追加し、結果を保持するrole: "tool"のメッセージを追加します。その後、モデルが最終的な回答を生成します。
5. ヘッダーと残高を確認する
-iを追加して、ボディとともにレスポンスヘッダーを表示します。X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrencyが見つかります。
curl -s -i "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
| grep -i "^x-"
curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"
2番目の呼び出しでは、クレジットが直接返されます。OpenAI互換のツールでは、代わりにGET /v1/dashboard/billing/credit_grantsを使用できます。上記のような小さなリクエストのコストは1セントのわずかな金額です。入力トークンが10個、出力トークンが5個の場合、料金は 10 x 0.15 / 1,000,000 + 5 x 0.50 / 1,000,000 = $0.000004 となります。料率については価格ページをご覧ください。
再利用可能なスモークテストスクリプト
個々の呼び出しを信頼できるようになったら、デプロイ後、キーのローテーション後、またはネットワーク変更後に実行できる短いスクリプトにラップします。最初の問題で失敗するため、どのステップが壊れたかを正確に確認できます。
set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"
echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'
echo "chat:"
curl -sf "$BASE/chat/completions" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
| jq -r '.choices[0].message.content'
echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"
-fフラグは、HTTP障害時にcurlがエラーで終了するようにします。また、set -eはスクリプトをそこで停止させます。このAPI上にサービスを実行しており、何かが変更されたときに早期警告を得たい場合は、cronジョブやCIステップに配置してください。キーはスクリプトファイル自体ではなく、シークレットストアまたは環境変数に保管してください。
リクエストを変化させる際は、一度に1つの設定を試してください。temperatureはランダム性、top_pは核サンプリング、stopはカスタム終了シーケンス、seedは再現可能な出力のために使用します。これらはすべてモデルに渡されるため、同じターミナル履歴からその影響を比較できます。
curlのエラーを読む
| コード | 考えられる原因 | 修正方法 |
|---|---|---|
| 401 | キーの不足または誤り | Authorizationヘッダーを確認し、$API_KEYがエクスポートされていることを確認する |
| 400 | 不正なJSONまたは不正なフィールド | 送信前にjq .でボディを検証する |
429、コード rate_limited | 1分あたり300リクエスト以上(試用キーでは60) | ループを遅くする |
429、コード concurrency | 一度に8リクエスト以上(トライアルキーでは2) | 並列ジョブの実行数を減らす |
429 と Retry-After: 5 | 一時的な過負荷 | 5秒待機して再試行 |
ボディの後にステータスコードを出力するには-w "\n%{http_code}\n"を追加し、推測する必要をなくします。エラーボディはメッセージとコードを含むJSON形式なので、jq .errorで明確に表示できます。ループ中に429エラーが表示された場合は、すぐに再試行しないでください。数秒の待機により、1分ごとのウィンドウと同時実行スロットがクリアされ、タイトな再試行ループは制限を超過し続けます。試用キーはフルキーよりも制限が厳しいため、最初のチャージ後に動作するスクリプトでも、並行してジョブを実行する場合は試用クレジットで失敗する可能性があります。リクエストが安定したらSDKに移行してください。同じURLとモデル名は変更されません。新規アカウントはワンクリックで$0.50の試用クレジットを取得でき、数百回の小さなテスト呼び出しに十分です。その後のチャージは$20から始まり、暗号資産(TRC20上のUSDTまたはBase上のUSDC)で支払われます。
