Generate Random User Profiles
curl --request POST \
--url https://api.aisa.one/apis/v1/api-ninjas/generate-random-user \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"seed": "my-test-seed-123",
"count": 1,
"fields": [
"first_name",
"last_name",
"email"
],
"gender": "male",
"locale": "en_US",
"exclude": [
"ssn",
"credit_card",
"iban"
],
"max_age": 50,
"min_age": 18
}
'import requests
url = "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user"
payload = {
"seed": "my-test-seed-123",
"count": 1,
"fields": ["first_name", "last_name", "email"],
"gender": "male",
"locale": "en_US",
"exclude": ["ssn", "credit_card", "iban"],
"max_age": 50,
"min_age": 18
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
seed: 'my-test-seed-123',
count: 1,
fields: ['first_name', 'last_name', 'email'],
gender: 'male',
locale: 'en_US',
exclude: ['ssn', 'credit_card', 'iban'],
max_age: 50,
min_age: 18
})
};
fetch('https://api.aisa.one/apis/v1/api-ninjas/generate-random-user', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'seed' => 'my-test-seed-123',
'count' => 1,
'fields' => [
'first_name',
'last_name',
'email'
],
'gender' => 'male',
'locale' => 'en_US',
'exclude' => [
'ssn',
'credit_card',
'iban'
],
'max_age' => 50,
'min_age' => 18
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user"
payload := strings.NewReader("{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/api-ninjas/generate-random-user")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/api-ninjas/generate-random-user")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"age": 123,
"dob": "<string>",
"job": "<string>",
"md5": "<string>",
"ssn": "<string>",
"url": "<string>",
"cell": "<string>",
"city": "<string>",
"iban": "<string>",
"ipv4": "<string>",
"ipv6": "<string>",
"name": "<string>",
"sha1": "<string>",
"uuid": "<string>",
"email": "<string>",
"phone": "<string>",
"state": "<string>",
"avatar": "<string>",
"domain": "<string>",
"gender": "<string>",
"locale": "<string>",
"prefix": "<string>",
"sha256": "<string>",
"suffix": "<string>",
"address": "<string>",
"company": "<string>",
"country": "<string>",
"picture": "<string>",
"latitude": 123,
"password": "<string>",
"timezone": "<string>",
"username": "<string>",
"full_name": "<string>",
"last_name": "<string>",
"longitude": 123,
"first_name": "<string>",
"user_agent": "<string>",
"credit_card": "<string>",
"mac_address": "<string>",
"postal_code": "<string>",
"company_email": "<string>",
"street_address": "<string>",
"credit_card_provider": "<string>"
}
]API Ninjas
Generate Random User Profiles
<!-- aisa-pricing:start -->
按用量计费；默认请求预估费用：$0.00089 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。
<!-- aisa-pricing:end -->
POST
https://api.aisa.one
/
apis
/
v1
/
api-ninjas
/
generate-random-user
Generate Random User Profiles
curl --request POST \
--url https://api.aisa.one/apis/v1/api-ninjas/generate-random-user \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"seed": "my-test-seed-123",
"count": 1,
"fields": [
"first_name",
"last_name",
"email"
],
"gender": "male",
"locale": "en_US",
"exclude": [
"ssn",
"credit_card",
"iban"
],
"max_age": 50,
"min_age": 18
}
'import requests
url = "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user"
payload = {
"seed": "my-test-seed-123",
"count": 1,
"fields": ["first_name", "last_name", "email"],
"gender": "male",
"locale": "en_US",
"exclude": ["ssn", "credit_card", "iban"],
"max_age": 50,
"min_age": 18
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
seed: 'my-test-seed-123',
count: 1,
fields: ['first_name', 'last_name', 'email'],
gender: 'male',
locale: 'en_US',
exclude: ['ssn', 'credit_card', 'iban'],
max_age: 50,
min_age: 18
})
};
fetch('https://api.aisa.one/apis/v1/api-ninjas/generate-random-user', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'seed' => 'my-test-seed-123',
'count' => 1,
'fields' => [
'first_name',
'last_name',
'email'
],
'gender' => 'male',
'locale' => 'en_US',
'exclude' => [
'ssn',
'credit_card',
'iban'
],
'max_age' => 50,
'min_age' => 18
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/api-ninjas/generate-random-user"
payload := strings.NewReader("{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/api-ninjas/generate-random-user")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/api-ninjas/generate-random-user")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"seed\": \"my-test-seed-123\",\n \"count\": 1,\n \"fields\": [\n \"first_name\",\n \"last_name\",\n \"email\"\n ],\n \"gender\": \"male\",\n \"locale\": \"en_US\",\n \"exclude\": [\n \"ssn\",\n \"credit_card\",\n \"iban\"\n ],\n \"max_age\": 50,\n \"min_age\": 18\n}"
response = http.request(request)
puts response.read_body[
{
"id": "<string>",
"age": 123,
"dob": "<string>",
"job": "<string>",
"md5": "<string>",
"ssn": "<string>",
"url": "<string>",
"cell": "<string>",
"city": "<string>",
"iban": "<string>",
"ipv4": "<string>",
"ipv6": "<string>",
"name": "<string>",
"sha1": "<string>",
"uuid": "<string>",
"email": "<string>",
"phone": "<string>",
"state": "<string>",
"avatar": "<string>",
"domain": "<string>",
"gender": "<string>",
"locale": "<string>",
"prefix": "<string>",
"sha256": "<string>",
"suffix": "<string>",
"address": "<string>",
"company": "<string>",
"country": "<string>",
"picture": "<string>",
"latitude": 123,
"password": "<string>",
"timezone": "<string>",
"username": "<string>",
"full_name": "<string>",
"last_name": "<string>",
"longitude": 123,
"first_name": "<string>",
"user_agent": "<string>",
"credit_card": "<string>",
"mac_address": "<string>",
"postal_code": "<string>",
"company_email": "<string>",
"street_address": "<string>",
"credit_card_provider": "<string>"
}
]请求规范
- 方法与路径: POST /apis/v1/api-ninjas/generate-random-user
- 可用状态: enabled
- 请求 URL 模板:
https://api.aisa.one/apis/v1/api-ninjas/generate-random-user - Runtime 事实版本: 80f6d0ab09ca1b2bfaa51bc30934eca7d1f0ea7e38c9d075b9100f098998c5d9
{
"operationId": "api-ninjas.generate-random-user",
"method": "POST",
"path": "/apis/v1/api-ninjas/generate-random-user",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"required": false,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"seed": {
"type": "string",
"examples": [
"my-test-seed-123",
"demo-data-v1"
],
"description": "Seed value for reproducible random data generation. Using the same seed value will always produce the same set of random users, which is useful for testing or creating consistent demo data."
},
"count": {
"type": "integer",
"default": 10,
"maximum": 30,
"minimum": 1,
"examples": [
1,
5,
10
],
"description": "Number of random user profiles to generate. Must be between 1 and 30. Default: 10"
},
"fields": {
"type": "array",
"items": {
"enum": [
"id",
"username",
"password",
"email",
"uuid",
"locale",
"name",
"first_name",
"last_name",
"full_name",
"prefix",
"suffix",
"phone",
"cell",
"company_email",
"street_address",
"city",
"state",
"postal_code",
"country",
"address",
"latitude",
"longitude",
"timezone",
"dob",
"age",
"gender",
"job",
"company",
"ssn",
"credit_card",
"credit_card_provider",
"iban",
"ipv4",
"ipv6",
"mac_address",
"user_agent",
"url",
"domain",
"md5",
"sha1",
"sha256",
"picture",
"avatar"
],
"type": "string"
},
"examples": [
[
"first_name",
"last_name",
"email"
],
[
"username",
"phone"
]
],
"description": "Profile fields to include in the response. Only these fields are returned."
},
"gender": {
"enum": [
"male",
"female",
"nonbinary",
"any"
],
"type": "string",
"examples": [
"male",
"female",
"nonbinary",
"any"
],
"description": "Gender filter for random user generation"
},
"locale": {
"type": "string",
"examples": [
"en_US",
"de_DE",
"fr_FR",
"es_ES"
],
"description": "Locale for generating localized data such as names, addresses, and phone numbers. Use standard locale codes like 'en_US' (English - United States), 'de_DE' (German - Germany), 'fr_FR' (French - France), 'es_ES' (Spanish - Spain), etc. Default: 'en_US'"
},
"exclude": {
"type": "array",
"items": {
"enum": [
"id",
"username",
"password",
"email",
"uuid",
"locale",
"name",
"first_name",
"last_name",
"full_name",
"prefix",
"suffix",
"phone",
"cell",
"company_email",
"street_address",
"city",
"state",
"postal_code",
"country",
"address",
"latitude",
"longitude",
"timezone",
"dob",
"age",
"gender",
"job",
"company",
"ssn",
"credit_card",
"credit_card_provider",
"iban",
"ipv4",
"ipv6",
"mac_address",
"user_agent",
"url",
"domain",
"md5",
"sha1",
"sha256",
"picture",
"avatar"
],
"type": "string"
},
"examples": [
[
"ssn",
"credit_card",
"iban"
],
[
"password",
"ipv4",
"ipv6"
]
],
"description": "Profile fields to exclude from the response. All other fields are returned."
},
"max_age": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"examples": [
50,
65,
100
],
"description": "Maximum age for generated users. Must be between 0 and 1000. Default: 100"
},
"min_age": {
"type": "integer",
"maximum": 1000,
"minimum": 0,
"examples": [
18,
25,
30
],
"description": "Minimum age for generated users. Must be between 0 and 1000. Default: 0"
}
}
}
}
}
},
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "response_units",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.00089,
"estimate_source": "profile_seed",
"evidence_source": "response_body",
"maximum_units": 10000000,
"unit": "provider_credit",
"unit_rate_usd": 1e-06
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
费用与请求规则
按用量计费；默认请求预估费用：$0.00089 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。- 默认请求参考估价（USD）: 0.00089
- 声明的单位费率（USD）: 1e-06
- 计费单位: provider_credit
- 计费依据: response_units
- 公开参考倍率: 1.0
- 声明的最大计数或单位数: 10000000
- 结算证据来源: response_body
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
Seed value for reproducible random data generation. Using the same seed value will always produce the same set of random users, which is useful for testing or creating consistent demo data.
示例:
"my-test-seed-123"
"demo-data-v1"
Number of random user profiles to generate. Must be between 1 and 30. Default: 10
必填范围:
1 <= x <= 30示例:
1
5
10
Profile fields to include in the response. Only these fields are returned.
可用选项:
id, username, password, email, uuid, locale, name, first_name, last_name, full_name, prefix, suffix, phone, cell, company_email, street_address, city, state, postal_code, country, address, latitude, longitude, timezone, dob, age, gender, job, company, ssn, credit_card, credit_card_provider, iban, ipv4, ipv6, mac_address, user_agent, url, domain, md5, sha1, sha256, picture, avatar 示例:
["first_name", "last_name", "email"]
["username", "phone"]
Gender filter for random user generation
可用选项:
male, female, nonbinary, any 示例:
"male"
"female"
"nonbinary"
"any"
Locale for generating localized data such as names, addresses, and phone numbers. Use standard locale codes like 'en_US' (English - United States), 'de_DE' (German - Germany), 'fr_FR' (French - France), 'es_ES' (Spanish - Spain), etc. Default: 'en_US'
示例:
"en_US"
"de_DE"
"fr_FR"
"es_ES"
Profile fields to exclude from the response. All other fields are returned.
可用选项:
id, username, password, email, uuid, locale, name, first_name, last_name, full_name, prefix, suffix, phone, cell, company_email, street_address, city, state, postal_code, country, address, latitude, longitude, timezone, dob, age, gender, job, company, ssn, credit_card, credit_card_provider, iban, ipv4, ipv6, mac_address, user_agent, url, domain, md5, sha1, sha256, picture, avatar 示例:
["ssn", "credit_card", "iban"]
["password", "ipv4", "ipv6"]
Maximum age for generated users. Must be between 0 and 1000. Default: 100
必填范围:
0 <= x <= 1000示例:
50
65
100
Minimum age for generated users. Must be between 0 and 1000. Default: 0
必填范围:
0 <= x <= 1000示例:
18
25
30
响应
Tool result data