This release is a pre-release and may not be stable for production use.
Nadeshiko SDK
Python SDK for the Nadeshiko API.
Install
pip install nadeshiko-sdk
Use the public SDK
The client sends your API key as Authorization: Bearer <apiKey>.
import os
from nadeshiko import Nadeshiko
from nadeshiko.api.search import search
from nadeshiko.models import Error, SearchRequest
client = Nadeshiko(
base_url=os.getenv("NADESHIKO_BASE_URL", "https://api.nadeshiko.co"),
token=os.getenv("NADESHIKO_API_KEY", "your-api-key"),
)
result = search.sync(
client=client,
body=SearchRequest(query="彼女"),
)
if isinstance(result, Error):
print(result.code, result.detail)
else:
for sentence in result.sentences:
print(sentence.segment_info.content_jp)
Error handling
Every response returns either a typed response object or an Error. The Error object follows the RFC 7807 Problem Details format, so you always get a machine-readable code and a human-readable detail.
import os
from nadeshiko import Nadeshiko
from nadeshiko.api.search import search
from nadeshiko.models import Error, SearchRequest
client = Nadeshiko(
base_url=os.getenv("NADESHIKO_BASE_URL", "https://api.nadeshiko.co"),
token=os.getenv("NADESHIKO_API_KEY", "your-api-key"),
)
result = search.sync(
client=client,
body=SearchRequest(query="食べる"),
)
if isinstance(result, Error):
match result.code:
# 400 — Bad Request
case "VALIDATION_FAILED":
print("Validation failed:", result.detail)
case "INVALID_JSON":
print("Malformed JSON body:", result.detail)
case "INVALID_REQUEST":
print("Invalid request:", result.detail)
# 401 — Unauthorized
case "AUTH_CREDENTIALS_REQUIRED":
print("Missing API key or session token")
case "AUTH_CREDENTIALS_INVALID":
print("API key is invalid")
case "AUTH_CREDENTIALS_EXPIRED":
print("Token has expired, re-authenticate")
case "EMAIL_NOT_VERIFIED":
print("Email verification required")
# 403 — Forbidden
case "ACCESS_DENIED":
print("Access denied")
case "INSUFFICIENT_PERMISSIONS":
print("API key lacks the required scope")
# 429 — Too Many Requests
case "RATE_LIMIT_EXCEEDED":
print("Rate limit hit, slow down")
case "QUOTA_EXCEEDED":
print("Monthly quota exhausted")
# 500 — Internal Server Error
case "INTERNAL_SERVER_EXCEPTION":
print("Server error, trace ID:", result.instance)
else:
for sentence in result.sentences:
print(sentence.segment_info.content_jp, "—", sentence.basic_info.name_anime_en)
See examples/examples.py for more usage patterns.
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 nadeshiko_internal_sdk-2.0.0.dev1773482033.tar.gz.
File metadata
- Download URL: nadeshiko_internal_sdk-2.0.0.dev1773482033.tar.gz
- Upload date:
- Size: 103.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c2e653310f5ca0bd7609f4667b40ff3c41a728df3fadb43c40889b1e6759abfc
|
|
| MD5 |
e0c695f8c96cfadfa5de82b0c0762879
|
|
| BLAKE2b-256 |
d3099d4fcc5848da2593b1925ef15524cd4341809912f532148492594f85a833
|
Provenance
The following attestation bundles were made for nadeshiko_internal_sdk-2.0.0.dev1773482033.tar.gz:
Publisher:
release.yml on BrigadaSOS/nadeshiko-sdk-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
nadeshiko_internal_sdk-2.0.0.dev1773482033.tar.gz -
Subject digest:
c2e653310f5ca0bd7609f4667b40ff3c41a728df3fadb43c40889b1e6759abfc - Sigstore transparency entry: 1101559321
- Sigstore integration time:
-
Permalink:
BrigadaSOS/nadeshiko-sdk-python@e73fb44fa74a407a538a9fe41c5873b3d0cce24b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/BrigadaSOS
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@e73fb44fa74a407a538a9fe41c5873b3d0cce24b -
Trigger Event:
repository_dispatch
-
Statement type:
File details
Details for the file nadeshiko_internal_sdk-2.0.0.dev1773482033-py3-none-any.whl.
File metadata
- Download URL: nadeshiko_internal_sdk-2.0.0.dev1773482033-py3-none-any.whl
- Upload date:
- Size: 355.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
81c053070811b8446cf9ea00f2755c361a6e5a3b4c3498f726886c232064ae64
|
|
| MD5 |
548f683351b361e8d72690827de198d2
|
|
| BLAKE2b-256 |
1ee1a4c227c823c148e1e18eda3c2c048067b01cc65152461b16fbbf3a52cd65
|
Provenance
The following attestation bundles were made for nadeshiko_internal_sdk-2.0.0.dev1773482033-py3-none-any.whl:
Publisher:
release.yml on BrigadaSOS/nadeshiko-sdk-python
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
nadeshiko_internal_sdk-2.0.0.dev1773482033-py3-none-any.whl -
Subject digest:
81c053070811b8446cf9ea00f2755c361a6e5a3b4c3498f726886c232064ae64 - Sigstore transparency entry: 1101559331
- Sigstore integration time:
-
Permalink:
BrigadaSOS/nadeshiko-sdk-python@e73fb44fa74a407a538a9fe41c5873b3d0cce24b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/BrigadaSOS
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@e73fb44fa74a407a538a9fe41c5873b3d0cce24b -
Trigger Event:
repository_dispatch
-
Statement type:
