ドキュメントが一新されました!旧ドキュメントは doc.newapi.pro
New APINew API
利用ガイドインストールAPIリファレンスAIアプリケーションSkillsヘルプ&サポートビジネス協力

newapi

newapi は New API 公式のユーザー向け Skill プラグインです。Claude Code、Codex、OpenClaw に対応し、自然言語コマンドでモデル、トークン、グループ、残高を管理し、New API の使い方も直接質問できます。

newapi-skills とは?

newapi-skills は、New API 公式の AI エディター Skill プラグインです。Skills は軽量な拡張プロトコルで、AI コーディングアシスタント(Claude Code、Codex、OpenClaw、Cursor、Windsurf、Cline など)がエディター内で New API の API を直接呼び出し、モデルの照会、トークン管理、残高確認に加えて、New API のデプロイ、設定、API 利用方法などの質問にもコーディング環境から離れることなく対応できます。

OpenClaw でも利用でき、エージェントのワークフロー内で /newapi コマンドを使ってモデル照会やトークン管理、残高確認を直接実行でき、New API の使い方もそのまま質問できます。

Skills を使う理由

日常の AI 開発では、エディターと New API 管理ダッシュボードの間を頻繁に行き来する必要があります — 利用可能なモデルの確認、API トークンの作成、残高のチェック、グループ割当の調整など。これらのコンテキストスイッチはコーディングの流れを中断します。

newapi-skills が解決する課題:

  • コンテキストスイッチゼロ:Claude Code、Codex、OpenClaw などの AI IDE で自然言語コマンドを直接入力 — ブラウザや管理パネル不要
  • 組み込みヘルプ:New API のデプロイ、設定、グループ、API 呼び出し形式などをその場で質問できます
  • セキュリティファースト:キーは平文で表示されません。トークンのコピーと注入はすべてセキュアチャネルで実行(sk- プレフィックスのキーはターミナル出力やログに表示されません)
  • インストール即使用npx コマンド一行でインストール完了。ランタイム自動検出(Bun / Node.js / Deno)
  • マルチエディター互換:Skills プロトコルを実装するすべての AI エディター・コーディングアシスタントで使用可能

対応 AI エディター

newapi-skills は以下の AI コーディングツールで利用できます:

AI エディター / コーディングアシスタント種類備考
Claude Codeターミナル AI プログラミングアシスタントAnthropic 公式 CLI
OpenClawセルフホスト型 AI アシスタントプラットフォームSkills に対応し、対話内で /newapi コマンドを直接実行可能
CursorAI ネイティブコードエディターVS Code ベース
WindsurfAI コードエディターCodeium 製
ClineVS Code AI 拡張機能オープンソース AI コーディングエージェント
Codex CLIターミナル AI プログラミングアシスタントOpenAI 公式 CLI

Skills プロトコルをサポートするすべてのツールで newapi-skills を使用できます。

コマンドリファレンス

以下は newapi-skills が提供する全コマンドです。これらのコマンドは New API REST API を通じて、New API インスタンス上のリソースを照会・管理します。

照会コマンド

コマンド説明用途
/newapi models利用可能な AI モデルを一覧表示New API インスタンスに設定された全モデル(OpenAI、Claude、Gemini など)を確認
/newapi groupsユーザーグループを一覧表示アカウントのグループとクォータ・倍率設定を確認
/newapi balanceアカウント残高を表示現在のユーザーの残高と使用量をリアルタイム照会

トークン管理コマンド

コマンド説明用途
/newapi tokensAPI トークンを一覧表示作成済みの全トークンを確認(キーはマスク表示、例:sk-reHR**********OspA
/newapi create-token <name> [--group=xxx]新しい API トークンを作成アプリやプロジェクトごとに独立した API キーを生成
/newapi switch-group <token_id> <group>トークンのグループを変更モデルアクセス権限と倍率を調整するためにグループを変更
/newapi copy-token <token_id>キーをクリップボードにコピー実キーをシステムクリップボードに安全にコピー(ターミナルには表示されません)
/newapi apply-token <token_id> <file>設定ファイルにキーを注入プレースホルダー置換によりプロジェクト設定ファイル(例:.env)にトークンキーを安全に書き込み

ヘルプコマンド

コマンド説明用途
/newapi help <question>New API について質問New API のデプロイ、設定、API 呼び出し形式などのヘルプ情報を取得

インストールと設定

newapi-skills をインストール

npx でワンラインインストール:

npx skills add https://github.com/QuantumNous/skills --skill newapi

GitHub リポジトリから最新の Skill 定義を取得し、エディター環境にインストールします。

環境変数を設定

newapi-skills は New API インスタンスに接続するために 3 つの環境変数が必要です。シェルプロファイルに追加してください:

# ~/.bashrc または ~/.zshrc
export NEWAPI_BASE_URL=https://your-newapi-instance.com
export NEWAPI_ACCESS_TOKEN=your-access-token
export NEWAPI_USER_ID=1
変数説明
NEWAPI_BASE_URLNew API サービス URLhttps://api.example.com
NEWAPI_ACCESS_TOKEN管理者またはユーザーのアクセストークン「個人設定 → アカウント管理 → セキュリティ設定 → システムアクセストークン」から取得
NEWAPI_USER_IDユーザー ID1(管理者のデフォルトは 1)

プロジェクトルートに .env ファイルを作成する方法もあります。キー漏洩防止のため .env.gitignore に追加してください。

使い始める

インストール後、Skills 対応の AI エディターで /newapi コマンドを入力するだけです。例:

  • /newapi models と入力して利用可能なモデルを確認
  • /newapi balance と入力して現在の残高をチェック
  • /newapi create-token my-app と入力して my-app という新しいトークンを作成
  • /newapi help グループやトークンはどう設定しますか? と入力して New API の使い方を質問
  • OpenClaw でも /newapi models/newapi balance などをそのまま利用できます

ランタイム要件

以下のいずれかの JavaScript ランタイムが必要です(起動時に自動検出):

ランタイムバージョン推奨度
Bun最新版推奨(最速)
Node.js>= 18広くサポート
Deno最新版オプション

セキュリティ

newapi-skills は API キーを保護するための多層セキュリティを内蔵しています:

  • トークン一覧ではマスクされたキーのみ表示(例:sk-reHR**********OspA)— 実キーはターミナル出力に表示されません
  • copy-token はキーをシステムクリップボードにのみコピーし、出力には表示しません
  • apply-token はプレースホルダー置換でキーを注入し、生のキー内容を公開しません
  • すべての sk- プレフィックスキー値は実行フロー全体を通じて厳格に保護されます

詳細情報

newapi-skills は現在も活発に開発中で、コマンドや機能はアップデートにより変更される可能性があります。最新の情報と変更ログはリポジトリの README を参照してください:

このガイドはいかがですか?

最終更新