JA ▾
API キーを取得

Ollama NSFWユーザー向けクイックスタート

OpenAI互換SDKを当社のホスト型エンドポイントに接続するだけで、数分で最初のレスポンスが得られます。このクイックスタートでは、認証、基本的なチャット、ストリーミング、および当社の無検閲モデルを用いた関数呼び出しを扱います。

前提条件と認証

APIキーとBase URLを取得して開始します。GoogleまたはメールアドレスでAPIキーを取得ページにサインインしてください。キーはすぐに発行されます。トライアルにはカードは不要です。Base URLはhttps://api.ollamansfw.com/v1です。環境変数またはSDKの設定に設定してください。モデル識別子はuncensoredです。これはGPTや他のベンダーのモデルとは異なる、当社のサーバーで動作するオープンウェイトモデルです。

最初のリクエスト

標準的なチャット補完リクエストを送信します。APIはroleとcontentを持つmessages配列を期待します。curlを使用して接続性をテストします。YOUR_API_KEYを実際のキーに置き換えてください。レスポンスはchoices[0].message.contentに生成されたテキストを返します。401エラーの場合はキーを確認してください。402エラーの場合はクレジットが必要です。

Python SDK統合

公式のopenaiPythonパッケージを使用します。pip経由でインストールします。カスタムBase URLとAPIキーでクライアントを設定します。これにより当社のエンドポイントとの互換性が確保されます。以下のコードは単純なテキスト生成を示しています。リクエストを処理し、結果を出力します。エラーハンドリングではHTTP例外をキャッチする必要があります。このアプローチは任意のOpenAI互換クライアントで機能します。

Node.js SDK統合

openaiNode.jsパッケージをインストールします。クライアント初期化時にBase URLとAPIキーを設定します。構造はPythonの例と似ています。モデルIDuncensoredを渡します。レスポンスには補完データが含まれます。クリーンなコードのためにasync/awaitを使用します。この方法は、直接APIアクセスを必要とするサーバーサイドアプリケーションやCLIツールに最適です。

ストリーミングレスポンス

stream: trueを設定してストリーミングを有効にします。APIはサーバー送信イベント(SSE)ストリームを返します。各チャンクには部分的なテキストが含まれます。最終チャンクにはトークン使用統計が含まれます。これにより、長いレスポンスの知覚されるレイテンシが削減されます。ストリームエラーは適切に処理してください。SDKには組み込みのストリームイテレーターがあります。各チャンクを処理してUIをリアルタイムで更新します。

制限、エラー、コンテキスト

コンテキストウィンドウは合計100,000トークンです。出力はウィンドウの末尾まで実行できます。レート制限は1分あたり300リクエストです。同時リクエストはキーあたり8件までです。リクエストボディは8 MB未満である必要があります。一般的なエラー:401(無効なキー)、402(クレジット不足)、429(レート制限)。エラーはクレジットを消費しません。違法なコンテンツに対する拒否は無料です。クレジットは期限切れになりません。

cURL

curl https://api.ollamansfw.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

from openai import OpenAI

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

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamansfw.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 = 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 仕様

購入前に確認できるよう、API の実際の制限と機能をすべてまとめました。

項目内容
形式OpenAI 互換:どの OpenAI SDK でも base URL とキーを変えるだけで動作
エンドポイントPOST /v1/chat/completions · GET /v1/models
認証Authorization: Bearer YOUR_KEY
モデル IDuncensored
Base URLhttps://api.ollamansfw.com/v1
最大出力100,000 トークンのウィンドウの残りまで。max_tokens は任意(個別の上限なし)
コンテキスト長100,000 トークン(入力+出力)
パラメータtemperature、top_p、stop、seed、presence_penalty、frequency_penalty
JSON モードresponse_format: {"type": "json_object"}
関数呼び出し対応 — tools、tool_choice。応答に tool_calls(ストリーミングでも)、結果は role: tool で返送
ストリーミング対応 — SSE、最後のチャンクにトークン使用量
レスポンスヘッダーX-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency
レート制限キーごとに毎分 300 リクエスト
リクエストサイズ最大 8 MB
同時実行キーごとに同時 8 リクエストまで
チャージUSDT(TRC20)または USDC(Base)、$20〜$500 の任意の整数額
課金前払いクレジットから実使用量で課金。エラーと拒否は無料
ボーナス$50 以上で +5%、$100 以上で +10%、$200 以上で +15%
有効期限購入クレジットは失効なし、サブスクなし
無料トライアル$0.50、7 日間、カード不要 · トライアルキー: 同時2件、毎分60件。初回チャージ後に上限が8件・300件へ拡大
料金入力 100 万トークン $0.15 · 出力 100 万トークン $0.50
ログインGoogle またはメール+パスワード
コンテンツ成人向けコンテンツ可。未成年者を含む性的コンテンツは拒否
キーアカウントごとに有効なキーは 1 つ。新しいキーで旧キーは無効

エラーコード

エラーは固定の type を持つ JSON で返ります。失敗・拒否されたリクエストは課金されません。

コードタイプ意味
400bad_requestJSON 不正、メッセージ空、パラメータ誤り、またはコンテキスト超過
401missing_key · invalid_key · key_revokedキーなし・誤り・新しいキーに置換済み
402no_credit残高ゼロ — チャージすれば即再開
403content_blocked未成年者を含む性的コンテンツ — 拒否、課金なし
404not_found不明なエンドポイント
413request_too_large本文が 8 MB 超
429rate_limited · concurrency毎分 300 回または同時 8 件を超過 — 待って再試行
503upstream_busyモデル混雑 — 数秒後に再試行

質問と回答

これは公式のOllama APIですか?

いいえ、これは独立したホスト型APIです。当社はOpenAI互換のエンドポイントを通じて独自の無検閲モデルを提供しています。Ollamaとは提携していませんが、類似の規約を使用しています。

クレジットをチャージするには?

USDT(TRC20)またはUSDC(Base)でチャージ。最小金額は$20。大口入金にはボーナス適用。クレジットは実際のトークン使用量で課金されます。エラーと拒否は無料です。

コンテキストウィンドウのサイズはいくらですか?

プロンプトと補完を合わせた合計コンテキストウィンドウは100,000トークンです。max_tokensが未設定の場合、応答はウィンドウの最後まで実行されることがあります。