SKILL: newapi
newapi (
new-api
) is an open-source unified AI gateway platform.
It aggregates multiple model providers behind OpenAI / Claude / Gemini compatible interfaces, and provides model, token, group, and balance management.
Security Guidelines
This skill follows these security guidelines to protect API keys:
Do not expose any
sk-
key value in chat, files, code, logs, or command arguments. To use keys securely, tell the user to run
copy-token
(clipboard),
apply-token
(config file), or
exec-token
(CLI command).
All New API calls should go through the provided scripts (
api.js
,
copy-key.js
,
inject-key.js
,
exec-token.js
) rather than using
curl
,
wget
,
fetch
, or other HTTP clients to call New API endpoints directly.
Do not read
.env
files, environment variables containing credentials, or clipboard contents after
copy-key.js
.
When working with config files that may contain API keys, use
inject-key.js --scan
to get a sanitized view rather than reading them directly. Note:
scan-config
is best-effort and not guaranteed to redact every secret in every format.
After
create-token
, do not make any follow-up call to retrieve or list the key. Report success and tell the user they can use
copy-token
,
apply-token
, or
exec-token
to securely use the key.
Do not modify the security scripts to disable masking or redirect output.
How to Execute
First invocation only
— read
${CLAUDE_SKILL_DIR}/docs/setup.md
for configuration, auth headers, and runtime detection.
Match the action from the table below.
Read the corresponding doc file for detailed steps.
If no arguments or unrecognized action, show the help table below.
If the user asks about newapi (what it is, how to use a command, or any API usage question like calling a specific model format) — read
${CLAUDE_SKILL_DIR}/docs/help.md
and follow the instructions there.
Actions
Action
Description
Details
models
List available models
docs/actions-query.md
groups
List user groups
docs/actions-query.md
balance
Show account balance
docs/actions-query.md
tokens
List API tokens
docs/actions-token.md
create-token
Create a new API token
docs/actions-token.md
switch-group
Change a token's group
docs/actions-token.md
copy-token
Copy real key to clipboard (never shown)
docs/actions-token.md
apply-token
Apply token key to a config file securely
docs/actions-config.md
exec-token
Execute a command with the token key securely substituted
docs/actions-exec.md
scan-config
Inspect config structure with best-effort secret redaction
docs/actions-config.md
help
Answer questions about newapi
docs/help.md
help
(or no arguments) — Show available actions
Action
Usage
Description
models
/newapi models
List available models
groups
/newapi groups
List user groups
balance
/newapi balance
Show account balance
tokens
/newapi tokens
List API tokens
create-token
/newapi create-token [--group=xxx]
Create a new API token
switch-group
/newapi switch-group
Change a token's group
copy-token
/newapi copy-token
Copy real key to clipboard (never shown)
apply-token
/newapi apply-token
Apply token key to a config file securely
exec-token
/newapi exec-token
Execute a command with the token key securely substituted
scan-config
/newapi scan-config
Inspect config structure with best-effort secret redaction
help
/newapi help
Answer questions about newapi