SEQGEN / API
API documentation
Use the Seqgen JSON API to generate cryptographically secure values from your applications and scripts.
Server-side generation
Cryptographically secure
JSON requests and responses
Quick start
Send a POST request with a JSON body to the required generator endpoint.
curl -X POST /api/generate/password \
-H "Content-Type: application/json" \
-d '{"length":32,"symbols":true}'Successful response
{
"type": "password",
"values": ["generated-value"],
"generatedAt": "2026-06-10T12:00:00.000Z"
}Password
POST /api/generate/passwordParameters
- length: integer, 6..128
- uppercase: boolean
- lowercase: boolean
- numbers: boolean
- symbols: boolean
At least one character set must be enabled.
{"length":32,"symbols":true}Numbers
POST /api/generate/numberParameters
- min: integer
- max: integer
- exclusions: string[]
- quantity: integer, 1..50
The range is inclusive and sampling is uniform.
{"min":1,"max":10,"exclusions":["3","7"],"quantity":4}VPN secret
POST /api/generate/vpnParameters
- protocol: shadowsocks | wireguard | hex
- length: integer, 2..256
- quantity: integer, 1..50
Returns secret material, not a complete VPN configuration.
{"protocol":"shadowsocks","length":32}UUID
POST /api/generate/uuidParameters
- format: standard | numeric | alpha | alphanumeric
- length: integer, 2..256
- quantity: integer, 1..50
Length is ignored for the standard UUID v4 format.
{"format":"alphanumeric","length":24}Phrase
POST /api/generate/phraseParameters
- words: 12 | 15 | 18 | 21 | 24
- separator: string, 1..4 characters
- quantity: integer, 1..50
Returns valid English BIP-39 mnemonic phrases.
{"words":12,"separator":" "}Bytes
POST /api/generate/seqParameters
- byteLength: integer, 2..256
- encoding: hex | base64 | base64url
- quantity: integer, 1..50
The requested length is measured in random bytes.
{"byteLength":32,"encoding":"hex"}Xray short ID
POST /api/generate/short-idParameters
- length: integer, 2..256
- quantity: integer, 1..50
Returns lowercase hexadecimal values for Xray REALITY shortIds.
{"length":8}Service health
GET /api/healthSecurity recommendations
- Values are generated with Node.js crypto on the server.
- Generation responses use Cache-Control: no-store.
- Use HTTPS and external rate limiting in production.