APIクイックスタート & 統合

ベースURLと認証

Heretic Projectはテキスト生成のための単一のホストエンドポイントを提供します。 https://api.hereticproject.com/v1 ベースURLとして使用します。認証には、 Authorization ヘッダー。ダッシュボードでGoogleまたはメールアドレスにサインインしてキーを作成してください。システムはアカウントごとに1つのアクティブなキーを発行し、新しいキーを生成すると以前のキーは即座に無効になります。

あなたは消費されたトークンのみ課金されます。エラーや拒否は前払いクレジットから引き落とされません。新規アカウントには7日間有効な$0.50の試用クレジットが付与されます。USDT (TRC20) または USDC (Base) を使用して、$20から$500の範囲でチャージします。

/v1/chat/completions エンドポイント

標準的なチャット補完エンドポイントにメッセージを送信してください。モデルIDは uncensoredrolesのような役割を持つメッセージオブジェクトのリストを受け付けます。 system, user、または assistant. モデルは法的な成人向け、フィクション、または論争的なトピックを拒否しません。これは、直接の回答向けに調整されたオープンウェイトモデルです。

リクエストは生成されたテキストを含むJSONオブジェクトを返します。コンテキストウィンドウはプロンプトとコンプリーションの合計で100,000トークンをサポートします。出力は、より低い値を指定しない限り、リクエストあたり16,000トークンに制限されます。 max_tokens 値。

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Python SDK統合

カスタムベースURLを持つ公式のOpenAI Pythonライブラリを使用します。設定を api_key API文字列に追加します。 base_url Heretic Projectサーバーを指すようにします。これにより、 chat.completions.create() 既存のコード構造を大幅に変更せずに。

pip経由でライブラリをインストールします。資格情報をクライアントの初期化に直接渡します。ライブラリはシリアライズを自動的に処理します。このアプローチは同期および非同期のワークフローの両方で機能します。ネットワークエラーを適切に処理してください。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.hereticproject.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 SDKの統合

Node.js SDKはPython版と同じように動作します。APIキーと正しいベースURLでクライアントを初期化します。同じメソッドシグネチャを使用してcompletionリクエストを送信できます。これにより、スタックの異なる部分間で一貫性が確保されます。

レスポンスを非同期的に処理します。ストリーミングメソッドを使用すると、SDKはデータをストリーミングします。それ以外の場合は、完全なJSONレスポンスを返します。この柔軟性はバッチ処理とリアルタイムインターフェースの両方をサポートします。APIキーは環境変数で安全に管理してください。

Copyimport OpenAI from "openai";

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

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

streamをtrueに設定してストリーミングを有効にする stream: true リクエスト内。サーバーはServer-Sent Events (SSE) を送信します。各チャンクには部分的なテキスト更新が含まれます。これにより、エンドユーザーの知覚されるレイテンシが削減されます。トークン使用データはストリームの最終チャンクに表示されます。

各デルタオブジェクトを処理して完全なレスポンスを累積します。ストリームが終了するかエラーが発生するまでリスニングを停止します。この方法はチャットインターフェースに最適です。ユーザーが思考がリアルタイムで形成されるのを見ることができます。オーバーヘッドは完全なレスポンスと比較して最小限です。

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)

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

サービス中断を避けるためにレート制限を尊重してください。キーあたり1分あたり300リクエストが許可されています。同時実行数は最大8つの同時リクエストに制限されます。リクエストボディは8 MBを超えることはできません。これらの制限を超えると、429ステータスコードが返されます。再試行する前に少し待機してください。

認証の失敗は401エラーを返します。これは、キーが無効または期限切れの場合に発生します。402エラーは、前払いクレジットが不足していることを示します。誤ったクレジットはサポートページ経由で処理されます。クレジットは期限切れになりません。モデルは未成年者に関連するコンテンツを拒否します。他の合法的なコンテンツはすべて受け入れられます。