開発者向けAPIドキュメント

ベースURLと認証

ベースURLは HTTPS://api.ollamaapiurl.com/v1 です。認証は、一意の API キーを Authorization ヘッダーに渡すことにより行います。このキーはすべてのリクエストの資格証明として機能します。サインアップ直後にダッシュボードから取得してください。

• キーは安全に保管してください。キーはプリペイドクレジットへの完全なアクセス権限を与えます。
• 設定ページからいつでも新しいキーを生成できます。

APIキーのシステムはシンプルです。アカウントごとに1つのアクティブキーが明確な追跡を保証します。アクセスを失った場合は、すぐに再生成できます。電話番号の確認がエントリーをブロックすることはありません。

最初のリクエスト

標準的なHTTPを使用して最初のプロンプトを送信してください。エンドポイントはテキスト入力を受け入れ、テキスト出力を返します。この方法は、お好みのHTTPクライアントライブラリと互換性があります。

Copycurl https://api.ollamaapiurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the local library"}]
  }'

レスポンスにはトークン使用量が含まれます。処理されたトークンのみに対して課金されます。エラーが発生しても前払い残高は消費されません。この透明性により、支出を正確に制御できます。

Python SDK の統合

公式の OpenAI Python ライブラリを使用します。ベース URL をポイントし、モデル ID を uncensored に設定します。これにより、ローカル環境のセットアップの手間なく、Uncensored の動作を実現できます。

Copyfrom openai import OpenAI

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

ライブラリはリトライとフォーマットを自動的に処理します。構造化JSONまたは生テキストが得られます。ストリーミングもサポートされています。このアプローチにより、コードはクリーンで保守可能に保たれます。

Node SDKのセットアップ

openaiパッケージをインストールしてください。ベースURLを当サービスに設定してください。環境からAPIキーを設定します。このセットアップはPythonの設定に非常に似ています。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamaapiurl.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);

Node開発者は一貫した動作を得られます。モデルはプロンプトに即座に反応し、任意のWebサーバーやバックグラウンドワーカーに統合できます。複雑なルーティングロジックは不要です。

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

ストリーミングを有効にするには stream を true に設定します。APIは生成されるチャンクを返します。これによりユーザーの知覚されるレイテンシーが改善します。トークンは表示されるにつれて表示できます。

Copystream = 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トークンです。これにはプロンプトと補完の両方が含まれます。1リクエストあたり最大16,000トークンを出力できます。レート制限は1分あたり300リクエストを許可します。同時リクエストはキーあたり8つまでです。

よくあるエラーには、無効なキーによる401が含まれます。402エラーはプリペイドクレジットが枯渇したことを意味します。429レスポンスはレート制限に達したことを示します。ダッシュボードを確認して暗号通貨でチャージしてください。クレジットは期限切れになりません。二重請求などのミスはサポート経由で修正されます。