5分で初リクエスト

Base URLと認証

OpenAI SDKまたは互換クライアントをBase URLにポイントしてください。特定のライブラリは必要なく、標準APIキーを受け付けるツールはすべてここで動作します。Googleまたはメールでログイン後、ダッシュボードからキーを取得してください。キーは直ちに表示され、すべてのリクエストに必要な唯一の認証情報です。

Base URLをhttps://api.ollamaapi.top/v1に設定します。すべてのチャット完了にはモデルIDuncensoredを使用します。このモデルはオープンウェイトモデルで、拒否が少なくなるようにチューニングされており、主要ベンダーのモデルとは異なります。GPT、Claude、または他の独自モデルではありません。認証はBearerトークンヘッダーのみに依存します。

初リクエスト

接続テストのために標準的なチャット完了リクエストを送信します。エンドポイントはmessages、model、およびtemperatureやmax_tokensなどのオプションパラメータを含むJSONペイロードを受け付けます。モデルIDは常にuncensoredです。レスポンスには、アシスタントのコンテンツとトークン使用量メトリクスを含む構造化JSONが返されます。

リクエストが成功すると、200 OKレスポンスが返されます。認証に失敗すると401エラー、資金が不足していると402エラーが返されます。これらのエラーは無料なので、成功したトークン使用に対してのみ課金されます。アプリケーションへの統合前に、このサンプルを使用して設定を確認してください。

Copycurl https://api.ollamaapi.top/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 SDK

公式のOpenAI Pythonライブラリ、または互換性のあるクライアントを使用します。ベースURLとAPIキーを使用してクライアントを初期化します。モデルをuncensoredに設定します。roleとcontentを含む辞書のリストとしてメッセージを渡します。ライブラリはシリアライズとレスポンス解析を自動的に処理します。

streamパラメータによりストリーミングレスポンスがサポートされます。これにより、生成されたトークンを処理でき、長い出力やリアルタイムのUI更新に役立ちます。最後のチャンクには、課金のための総トークン使用量が含まれます。ネットワークエラーは課金されないため、例外を適切に処理してください。

Copyfrom openai import OpenAI

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

openainpmパッケージをインストールするか、fetchベースのラッパーを使用します。ベースURLhttps://api.ollamaapi.top/v1とAPIキーでクライアントを設定します。モデルIDはuncensoredのままです。messagesとtop_pやseedなどのオプション設定を含むリクエストボディを渡します。

Node.js ユーザーはクリーンなコードのために async/await パターンを活用できます。レスポンスオブジェクトには choices、usage、id が含まれます。アシスタントのメッセージは最初の選択肢から抽出できます。エラーハンドリングではレート制限（429）とクレジット不足（402）を考慮する必要があります。これらのエラーはトークンを消費しないため、正常なレスポンスが生成されるまで前払い残高はそのまま維持されます。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamaapi.top/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: trueを設定してストリーミングを有効にします。APIはServer-Sent Events（SSE）ストリームを返します。各チャンクには部分的なコンテンツが含まれており、生成されたトークンを表示できます。これにより、ユーザーの知覚されるレイテンシが削減され、長文のテキスト生成の体験が向上します。

ストリーミングの最後のチャンクには、完全なトークン使用量データが含まれます。これを使用して、リアルタイムでの消費を追跡できます。ストリーミングは価格モデルを変更するものではなく、入力トークンおよび出力トークン100万トークンあたりで課金されます。ストリーミング中のエラーも無料です。接続が切れた場合、ペナルティなしでリクエストを再開または再起動できます。

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回あたりの最大出力は32,000トークンです（max_tokensが未設定の場合は2,048トークン）。コンテキストウィンドウを超えると、リクエストは失敗します。エラーには、無効なキーに対する401、クレジット不足による402、レート制限による429が含まれます。レート制限は1分あたり300リクエスト、キーあたり8つの同時リクエストです。リクエストボディは8 MBに制限されます。エラーは無料であり、失敗したリクエストや拒否に対して課金されません。クレジットは期限切れにならず、サブスクリプションも必要ありません。