Tools (5)

generate_password
generate_passphrase
generate_pin
check_password_strength
report_feedback

generate_password

Generate a cryptographically secure random password.

Returns the password, its length, character sets used, and entropy in bits.

Parameter	Type	Required	Description
`length`	`integer`	optional	Password length (4-128). (default: 16)
`uppercase`	`boolean`	optional	Include uppercase letters. (default: true)
`lowercase`	`boolean`	optional	Include lowercase letters. (default: true)
`digits`	`boolean`	optional	Include digits. (default: true)
`symbols`	`boolean`	optional	Include symbols. (default: true)
`exclude_ambiguous`	`boolean`	optional	Exclude ambiguous characters (0/O, 1/l/I, etc.). (default: false)

Request Body

{
  "query": "example"
}

generate_passphrase

Generate a passphrase from random dictionary words.

Returns the passphrase, word count, separator, and entropy in bits.

Parameter	Type	Required	Description
`words`	`integer`	optional	Number of words (2-12). (default: 4)
`separator`	`string`	optional	Word separator character. (default: "-")
`capitalize`	`boolean`	optional	Capitalize each word. (default: false)

Request Body

{
  "query": "example"
}

generate_pin

Generate a cryptographically secure numeric PIN.

Returns the PIN, its length, and entropy in bits.

Parameter	Type	Required	Description
`length`	`integer`	optional	PIN length (4-12). (default: 6)

Request Body

{
  "query": "example"
}

check_password_strength

Estimate the strength of a given password.

Returns a score (0-4), label (very_weak/weak/fair/strong/very_strong), entropy in bits, and feedback.

Parameter	Type	Required	Description
`password`	`string`	required	Password to evaluate.

Request Body

{
  "password": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/password-generator/check_password_strength" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"password": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/password-generator/check_password_strength",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "password": "example"
},
)
print(resp.json())