クイックスタート: チャット完了 API

前提条件とベースURL

当社のAPIは標準のOpenAIチャット完了インターフェースと完全に互換性があります。ベースURLとAPIキーのみでリクエストの送信を開始できます。ベースURLは HTTPS://api.howmuchisanapikey.com/v1 です。この単一エンドポイントが、複数のサービスURLやプロキシ構成を管理する必要なく、すべてのテキスト生成を処理します。

認証はシンプルです。AuthorizationヘッダーにBearerスキームと一意のキーを含める必要があります。チャット完了エンドポイントへのすべてのリクエストには、アカウントの検証とプリペイド残高に対するトークン使用量の追跡のためにこのヘッダーが必要です。

認証とヘッダー

すべてのリクエストに Authorization ヘッダーを含めて身元を確認します。ヘッダーの形式は Authorization: Bearer YOUR_API_KEY です。キーが無効または期限切れの場合、API はすぐに 401 エラーを返します。これにより、承認されたアカウントのみがプリペイドクレジットを使用できるようになります。

基本的なテキスト生成には追加のヘッダーを渡す必要はありません。ただし、JSONモードや関数呼び出しなどの特定の機能を使用する場合は、Content-Typeヘッダーをapplication/jsonに設定する必要があります。これにより、サーバーがリクエストボディを正しく解析できるようになります。

最初のチャットCompletionを送信

メッセージ履歴とモデル識別子を使用して /v1/chat/completions へ POST リクエストを送信します。モデル id は "uncensored" です。このモデルは、法的な成人向けコンテンツ、フィクション、または論争的なトピックに対して拒否なしで回答するようにチューニングされています。標準的な政治的または社会的規範に基づいてフィルタリングしません。

始めるための基本的な curl の例:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

レスポンスにはchoices配列内に生成されたテキストが含まれます。これをアプリケーションロジックに直接解析できます。各リクエストはプロンプトの入力トークンとモデルの応答の出力トークンを消費します。

ストリーミングレスポンスとトークン使用量

トークンが生成されるたびに SSE を使用してトークンを受信します。これにより、長い出力に対する知覚されるレイテンシが削減されます。リクエストボディで stream パラメータを true に設定してください。サーバーは複数のチャンクを送信し、各チャンクには応答の部分的なデルタが含まれます。

最終チャンクには使用データが含まれています。このオブジェクトには、リクエストによって消費された合計入力トークンと出力トークンが含まれています。このデータを使用して、ローカルのクレジット残高を更新するか、リアルタイムで支出を監視できます。ストリーミングは、ユーザーが即時フィードバックを期待するチャットインターフェースに最適です。

関数呼び出しとJSONモード

APIはJSONモードと関数呼び出しによる構造化出力をサポートしています。response_formatを{"type": "json_object"}に設定して、モデルが有効なJSONを返すことを強制できます。これはデータの抽出や構造化された設定の生成に有用で、パースエラーを防ぐことができます。

関数呼び出しの場合、リクエストにtools配列を提供します。モデルは関数が必要と判断した場合、tool_callsで応答します。その後、関数を実行してその結果をモデルに送信できます。これにより、外部の解析ロジックなしで複雑なマルチステップワークフローが可能になります。

制限とエラーの処理

1分間に300リクエスト（キーあたり）、キーあたり8件の並列リクエストが可能です。これらの制限を超えると、429 Too Many Requestsエラーが発生します。レスポンスボディにはretry-afterの詳細が含まれます。不要なリトライを避けるために、クライアント側のスロットリングを調整してください。

前払い残高が枯渇すると、APIは402 Payment Requiredエラーを返します。暗号通貨でいつでもチャージできます。エラーと拒否は無料なので、トークンの生成に成功した分のみ課金されます。コンテキストウィンドウはプロンプトと補完を合わせて100,000トークンです。

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

ストリーミング

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)