cURLとBearerトークンによるOpenAI互換API
コマンドラインからOpenAI互換のAPIを呼び出すには、Authorizationヘッダーにトークンを含めてHTTP POSTリクエストを送信します。このページでは、このAPIのすべての機能に対する動作確認済みのcURLコマンドと、失敗時に確認すべき項目を提供しています。
更新日:

主要ポイント
- トークンはAuthorization: Bearer YOUR_KEYヘッダーに設定し、モデルIDはuncensoredです。
- 2つのエンドポイントがあります:GET /v1/modelsとPOST /v1/chat/completions。
- -Nとstream trueを追加して、サーバー送信イベントでトークンが到着する様子を確認します。
- curl -iでX-Balance-USDとレート制限ヘッダーを確認します。429は待機と再試行を意味します。
最小限のリクエスト
このサービスに対してトークン付きのOpenAI互換API cURLを実行する最も短い方法は次の通りです。キーを環境変数に設定してシェル履歴に残さないようにし、チャットメッセージを送信します:
export UF_KEY="paste-your-key-here"
curl https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what a bearer token is in two sentences."}
]
}'
レスポンスはOpenAIのチャット完了形式のJSONです。回答はchoices[0].message.contentにあり、usageオブジェクトがプロンプトと完了トークンの使用状況を報告します。コマンドの各部分には役割があります:
Authorization: Bearer ...はトークンを運びます。「Bearer」はスキーム名です。トークンを持つ者はその所有者として扱われるため、公開リポジトリに含めないことが重要です。Content-Type: application/jsonはサーバーにボディの読み込み方法を伝えます。これを指定しないと、ボディ解析エラーでリクエストが失敗することがよくあります。modelはuncensoredである必要があります。これはこのAPIが提供する唯一のモデルです。messagesは、role(system、user、assistant、またはtool)とcontentを持つオブジェクトのリストです。
キーを取得するには、Googleまたはメールアドレスとパスワードで登録し、APIキーページを使用してください。新規ユーザーはワンクリックで試用クレジット$0.50を受け取ることができます:カード不要、7日間有効、1人につき1回限り。
GET /v1/modelsでキーを確認
長いリクエストのデバッグの前に、最も安価な呼び出しでトークンが動作するか確認してください。モデル一覧は無料で、URL、ヘッダー、キーがすべて正しいか確認できます。
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY"
正しいレスポンスは、uncensoredを含むJSONリストです。jqがインストールされている場合は、出力をパイプで渡してIDのみを抽出します。
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'
有用な結果が得られない場合は、以下のリストを順番に確認してください。原因は発生頻度の高い順にリストされています:
- 変数が空です。
echo "${UF_KEY:0:6}"を実行して、キー全体を出力せずに最初の文字列を確認してください。 - ヘッダーに誤記があるか、キーの前に"Bearer"が不足しています。
- ドキュメントやチャットクライアントからの曲がり引用符が、コマンド内の直角引用符に置き換えられました。
- ベースURLが間違っています。ベースURLは
https://api.unfilteredaimodels.com/v1で、前にapi.が付き、後に/v1が付きます。 - キーの末尾にスペースや改行が含まれてコピーされました。
レスポンスヘッダーを読む
出力にヘッダーを含めるには-iを、ボディをクリーンなままに保ちながらヘッダーを出力するには-D -を追加します:
curl -s -D - -o /dev/null \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'
知っておくべきレスポンスヘッダーが4つあります:
| ヘッダー | 意味 |
|---|---|
X-Request-Id | このリクエストの識別子です。サポートに連絡する場合は、このIDを参照してください。 |
X-Balance-USD | 残りの前払いクレジット。 |
X-RateLimit-Limit-Requests | キー1分あたりのリクエスト制限数。 |
X-RateLimit-Limit-Concurrency | キーの同時リクエスト制限数。 |
制限は、フルキーで1分あたり300リクエスト、8つの同時リクエスト、トライアルキーで1分あたり60リクエスト、2つの同時リクエストです。上記のリクエストはテストを小さく保つためにmax_tokensを5に設定しています。通常の使用ではmax_tokensはオプションであり、補完はプロンプト後の100,000トークンのウィンドウに残っている分を使用できます。
コマンドラインからのストリーミング
"stream": trueを設定し、curlが出力をバッファリングしないように-Nを追加します。data:で始まる行が表示され、それぞれが小さなJSON差分を運び、最後にdata: [DONE]が表示されます。その前のチャンクにはトークン使用量が含まれます。
curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
}'
テキストのみを出力するには、ストリームを短いパイプでフィルタリングします:
curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
| sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
| jq -rj '.choices[0].delta.content // empty'
echo
ストリーミングリクエストはストリーム終了まで同時接続枠を保持します。スクリプトから多くのストリームを並列で開始し、終了を待たずに放置すると、リクエストレートが低くても同時接続制限に達します。
JSONモードとツール呼び出し
JSONモードは、モデルが単一の有効なJSONオブジェクトを返すようにします。プロンプトで希望する形状も指定してください。さもないと、キーはモデルが選択した内容になります。
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
]
}' | jq -r '.choices[0].message.content'
ツール呼び出しは標準のtoolsおよびtool_choiceフィールドを使用します。モデルはテキストの代わりにtool_calls配列で応答します。関数を自分で実行し、role: "tool"と一致するtool_call_idを持つメッセージとして結果を戻します。
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"tool_choice": "auto",
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
}'
返信ではchoices[0].message.tool_calls[0].function.argumentsを探します。これはJSON文字列であり、解析して独自の天気関数を呼び出し、次のリクエストで返します。temperature、top_p、stop、seedなどのパラメータと、ペナルティはそのまま渡されます。ドキュメントにはすべてのサポート対象フィールドがリストされています。
トークンを安全に保管し、コマンドを整理してください
Bearerトークンは名前が違うだけのパスワードです。これを持つ誰でもクレジットを使用できるため、同じ注意を払ってください。実際のキーを公開イシュー、スクリーンショット、共有ターミナルログに貼り付けないでください。キーが漏洩したと思われる場合は、キーページから置き換え、スクリプトを更新してください。
シェル履歴は個人マシンにおける最も一般的な漏洩源です。キーをコマンドに直接入力すると、履歴ファイルに保存されます。exportで一度設定しても、その行は保存されます。よりクリーンな習慣が役立ちます。あなただけが開けるファイルからキーを読み取るか、シェルがスペースで始まる行を無視するように設定されている場合はコマンドにスペースをプレフィックスとして付けます。小さなファイルが適しています:
mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key
export UF_KEY="$(cat ~/.config/uf/key)"
長いJSONボディはシングルクォート内では読みづらく、プロンプト自体にアポストロフィが含まれるとクォートが壊れます。ボディをファイルに置き、curlに-d @fileで読み込ませます:
cat > request.json <<'JSON'
{
"model": "uncensored",
"temperature": 0.3,
"messages": [
{"role": "system", "content": "You answer in plain language."},
{"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
]
}
JSON
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d @request.json | jq -r '.choices[0].message.content'
同じアプローチにより、8 MBのボディ制限内の大きなプロンプトが管理可能になり、ファイルはgitでバージョン管理でき、キーはリポジトリの外に保たれます。Windows PowerShellではJSONのシングルクォートは異なる動作をし、バックスラッシュの行継続は存在しません。-d @request.json形式は両方の問題を回避し、行の末尾にバックティックを使用してコマンドを継続できます。
テスト終了後はSDKに移行してください。OpenAI PythonおよびNodeライブラリは同じBase URLとキーを受け付け、リトライとストリーミングを処理し、ここで手動で解析していたのと同じレスポンス形式を読み取ります。cURLコマンドは失敗がコード由来かリクエスト由来かを確認する最速の方法なので、ノートに既知の正常なコマンドを保持してください。サポートに問題を報告する際は、失敗した呼び出しのX-Request-Idと正確なステータスコードを含めてください。この組み合わせにより、テストを繰り返すことなくリクエストを特定でき、往復の手間を省けます。
エラー、リトライ、1回あたりのコスト
制限を超えると、APIはHTTP 429を返します。エラーコードはどの制限に達したかを示します:rate_limitedは1分あたりのリクエストが多すぎることを意味し、concurrencyは一度に多すぎることを意味します。一時的な過負荷も429を返し、Retry-After: 5を追加します。curlは一時的なエラーに対して自動的に再試行できます:
curl --retry 3 --retry-delay 5 --retry-all-errors \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
ボディを8 MB以下に保つことも重要です。これはプロンプトにエンコードされたファイルを投稿する場合に重要です。
失敗または拒否されたリクエストは課金されません。成功したリクエストは単純な式に従います:入力トークン100万あたり$0.15、出力トークン100万あたり$0.50。入力トークン40、出力トークン120のテスト呼び出しのコストは、40 / 1,000,000 x $0.15 = $0.000006 に 120 / 1,000,000 x $0.50 = $0.00006 を加えた合計$0.000066です。1000回で$0.066になります。
クレジットは前払いで、期限切れしません。チャージは$20から$500まで整数単位で、$50以上で5%、$100以上で10%、$200以上で15%のボーナスが付きます。暗号資産(TRC20上のUSDT、Base上のUSDC)で利用可能です。価格表に詳細が記載されています。応答が誤っているように見える場合は、よくある誤解ページでモデルが何を行い、何を行わないかが説明されています。
その他のガイド
質問と回答
キーはフォームを1つ埋めるだけで入手できます
アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。
cURLコマンドでトークンはどこに?
- ヘッダーに指定:-H "Authorization: Bearer YOUR_KEY"。リクエストボディにはContent-Type: application/jsonヘッダーも必要です。
どのモデル名を使用すればよいですか?
- 無検閲モデルを使用します。GET /v1/modelsで確認できます。
429エラーが出るのはなぜ?
- 制限に達しました。rate_limitedは1分あたりのリクエスト過多、concurrencyは同時接続過多を意味します。数秒待つか、同時リクエスト数を減らしてください。
残高の残額を確認する方法を教えてください。
- すべてのレスポンスには X-Balance-USD ヘッダーが含まれます。curl -i または curl -D - でヘッダーを出力してください。
これは公式のOpenAI APIですか?
- いいえ。これは独立した OpenAI 互換サービスであり、1つのオープンウェイトモデルを実行しています。Base URL と API キーを変更するだけで、OpenAI 形式用に構築された SDK や cURL コマンドがそのまま動作します。