NinjaChat Python SDK
Typed client for the clean NinjaChat API v1.
pip install ninjachat
import os
from ninjachat import NinjaChat
client = NinjaChat(api_key=os.environ["NINJACHAT_API_KEY"])
response = client.responses.create(
model="ninja/auto",
input="Write one sentence about clean APIs.",
max_output_tokens=64,
routing={"strategy": "balanced", "data_policy": "no_training"},
)
print(response["output_text"], response["cost_usd"], response["request_id"])
Ordered fallbacks and provider constraints are explicit:
completion = client.chat.completions.create(
models=["gpt-5", "claude-sonnet-4"],
messages=[{"role": "user", "content": "Hello"}],
max_completion_tokens=100,
routing={"strategy": "latency", "allow_fallbacks": True, "caching": "auto", "max_cost_usd": 0.10},
)
Streams return iterators of typed-shape dictionaries:
for event in client.responses.create(model="ninja/auto", input="Hello", stream=True):
if event.get("type") == "response.output_text.delta":
print(event.get("delta", ""), end="")
Models and prices come from client.models.list(). Images use client.images.generate(), videos use client.videos.generate() and client.videos.wait_for(), and account observability is available through client.usage(), client.balance(), and client.requests.get().
Signed webhooks replace video polling and fire spend alerts: client.webhooks.create(...) or the console. Verify deliveries with verify_webhook_signature.
The base URL is https://www.ninjachat.ai/api/v1. Chat and Responses are billed by actual token usage. See docs.ninjachat.ai.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ninjachat-0.1.0.tar.gz.
File metadata
- Download URL: ninjachat-0.1.0.tar.gz
- Upload date:
- Size: 10.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e8f7896e9758361903dcbf333b8254ac7f291831917396316365b6258ea280cd
|
|
| MD5 |
b111ebf662199098804633b3097a8d97
|
|
| BLAKE2b-256 |
5e6cd293869f5d2712c0fd289ca7ba420e62be052b8dba228b973df7fc7d3af2
|
Provenance
The following attestation bundles were made for ninjachat-0.1.0.tar.gz:
Publisher:
release.yml on bloon-ai/ninjachat-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ninjachat-0.1.0.tar.gz -
Subject digest:
e8f7896e9758361903dcbf333b8254ac7f291831917396316365b6258ea280cd - Sigstore transparency entry: 2579982446
- Sigstore integration time:
-
Permalink:
bloon-ai/ninjachat-sdk@1c5f33e891a2f486027ed683fdc613acaa4d4dc2 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/bloon-ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1c5f33e891a2f486027ed683fdc613acaa4d4dc2 -
Trigger Event:
push
-
Statement type:
File details
Details for the file ninjachat-0.1.0-py3-none-any.whl.
File metadata
- Download URL: ninjachat-0.1.0-py3-none-any.whl
- Upload date:
- Size: 10.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
733128b7d227505a96c01cd3fc79644019a5974ec33c0c8b6ada34ee5d5654b4
|
|
| MD5 |
38f760050510fd094d8a48cad951d2d2
|
|
| BLAKE2b-256 |
ac8178bb24275d63f64fd949590a6e2a2b092da353e1d8cb9946465dd26cc20c
|
Provenance
The following attestation bundles were made for ninjachat-0.1.0-py3-none-any.whl:
Publisher:
release.yml on bloon-ai/ninjachat-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ninjachat-0.1.0-py3-none-any.whl -
Subject digest:
733128b7d227505a96c01cd3fc79644019a5974ec33c0c8b6ada34ee5d5654b4 - Sigstore transparency entry: 2579982451
- Sigstore integration time:
-
Permalink:
bloon-ai/ninjachat-sdk@1c5f33e891a2f486027ed683fdc613acaa4d4dc2 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/bloon-ai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1c5f33e891a2f486027ed683fdc613acaa4d4dc2 -
Trigger Event:
push
-
Statement type:
