APIドキュメント: クイックスタートガイド

ベースURLと認証

Heretic AI APIは完全にOpenAI互換です。クライアントを当社のベースURLにポイントすることで対話します。 https://api.hereticai.cc/v1認証は、Googleまたはメールでサインアップした直後に生成されるアカウントごとに1つのAPIキーに依存します。このキーを Authorization Bearer トークンとしてヘッダーを設定します。モデル識別子は単に uncensoredこの単一モデルはルーティングの複雑さなしですべてのリクエストを処理します。401エラーは無効なキーを、402エラーはプリペイド暗号通貨クレジットの追加が必要であることを示します。

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

チャット完了エンドポイント

標準の POST /v1/chat/completions エンドポイント。APIは、会話履歴またはプロンプトを含む標準的なメッセージ配列を期待します。生成されたテキストを choices 配列。これは純粋なユーティリティAPIです：テキスト入力、テキスト出力。消費されたトークンに対してのみ課金されます。前払いクレジットは期限切れにならず、拒否やエラーでもトークンは消費されません。このアプローチにより、サブスクリプションのロックや予測不可能な無料プランが解消されます。

Copyfrom openai import OpenAI

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

ストリーミングレスポンス（SSE）

リアルタイムのトークンストリーミングを有効にするには、 stream: true リクエストに含まれます。APIは生成されたトークンごとにサーバー送信イベント（SSE）を返します。これにより、出力を段階的に表示でき、レイテンシが敏感なアプリケーションに不可欠です。トークン使用統計はストリームの最後のチャンクに表示されます。この機能は、SSEを自動的に処理する標準的なOpenAI SDKとシームレスに動作します。完全な完了を待たずに即時フィードバックを提供します。

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)

関数呼び出しとツール

APIは tools および tool_choice パラメータ。リクエスト内でツールスキーマを定義すると、モデルは適切な場合に構造化された関数呼び出しを返します。これにより、LLMが次のアクションを決定する複雑なワークフローが可能になります。特定のツールの使用を強制するか、モデルに自由に選択させるかを選択できます。この機能は、外部システムやデータベースと連携するエージェントアプリケーションの構築に不可欠です。

JSONモード

設定することで決定論的な出力を保証する response_format に {"type": "json_object"}モデルの応答は有効なJSONに制約され、プログラム解析にとって重要です。これにより、後処理での正規表現修正の必要性が減少します。出力はコードで直接消費できることが保証されます。これは構造化データの抽出や設定生成タスクに特に役立ちます。

パラメータと制限

temperatureやtop_pなどの標準的なパラメータを使用して生成を制御します temperature, top_p、および seedコンテキストウィンドウは、プロンプトと補完を合わせて100,000トークンです。1リクエストあたりの最大出力は16,000トークン、または2,048（ max_tokens 未設定。レート制限は1分あたり300リクエスト、キーあたり8つの同時リクエストです。リクエストボディは8 MB未満にする必要があります。これらの制限は、開発者向けの安定した高容量の使用を保証します。

Node.js

Copyimport OpenAI from "openai";

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