> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Generate Random User Profiles > 按用量计费；默认请求预估费用：$0.00089 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 ## 请求规范 * **方法与路径:** POST /apis/v1/api-ninjas/generate-random-user * **可用状态:** enabled * **请求 URL 模板:** `https://api.aisa.one/apis/v1/api-ninjas/generate-random-user` * **Runtime 事实版本:** 80f6d0ab09ca1b2bfaa51bc30934eca7d1f0ea7e38c9d075b9100f098998c5d9 [完整 OpenAPI 定义](https://aisa.one/docs/reference-contracts/zh/api-ninjas.json) 有效请求与价格声明（包括认证和引用的 schema）： ```json theme={null} { "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 ## OpenAPI ````yaml reference-contracts/zh/api-ninjas.json POST /apis/v1/api-ninjas/generate-random-user openapi: 3.1.0 info: description: '' title: API Ninjas version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/api-ninjas/analyze-sentiment - /apis/v1/api-ninjas/barcode-generate - /apis/v1/api-ninjas/bitcoin - /apis/v1/api-ninjas/calculate-calories-burned - /apis/v1/api-ninjas/calculate-mortgage - /apis/v1/api-ninjas/calculate-sales-tax - /apis/v1/api-ninjas/check-domain - /apis/v1/api-ninjas/check-is-public-holiday - /apis/v1/api-ninjas/check-is-working-day - /apis/v1/api-ninjas/check-spelling - /apis/v1/api-ninjas/commodity-price - /apis/v1/api-ninjas/compute-text-similarity - /apis/v1/api-ninjas/convert-currency - /apis/v1/api-ninjas/convert-unit - /apis/v1/api-ninjas/crypto-price - /apis/v1/api-ninjas/detect-text-language - /apis/v1/api-ninjas/disposable-email-checker - /apis/v1/api-ninjas/dns-lookup - /apis/v1/api-ninjas/earnings-calendar - /apis/v1/api-ninjas/earnings-call-transcript - /apis/v1/api-ninjas/etf-info - /apis/v1/api-ninjas/extract-webpage-content - /apis/v1/api-ninjas/filter-profanity - /apis/v1/api-ninjas/find-ev-charging-stations - /apis/v1/api-ninjas/generate-lorem-ipsum - /apis/v1/api-ninjas/generate-password - /apis/v1/api-ninjas/generate-qr-code - /apis/v1/api-ninjas/generate-random-user - /apis/v1/api-ninjas/generate-sudoku - /apis/v1/api-ninjas/generate-text-embeddings - /apis/v1/api-ninjas/generate-user-agent - /apis/v1/api-ninjas/get-advice - /apis/v1/api-ninjas/get-air-quality - /apis/v1/api-ninjas/get-aircraft - /apis/v1/api-ninjas/get-airports - /apis/v1/api-ninjas/get-animals - /apis/v1/api-ninjas/get-baby-names - /apis/v1/api-ninjas/get-bucketlist - /apis/v1/api-ninjas/get-cats - /apis/v1/api-ninjas/get-celebrity - /apis/v1/api-ninjas/get-chuck-norris-joke - /apis/v1/api-ninjas/get-city - /apis/v1/api-ninjas/get-cocktail - /apis/v1/api-ninjas/get-company-logo - /apis/v1/api-ninjas/get-country-flag - /apis/v1/api-ninjas/get-country-info - /apis/v1/api-ninjas/get-county - /apis/v1/api-ninjas/get-dad-joke - /apis/v1/api-ninjas/get-day-in-history - /apis/v1/api-ninjas/get-dictionary-definition - /apis/v1/api-ninjas/get-dogs - /apis/v1/api-ninjas/get-earnings - /apis/v1/api-ninjas/get-electric-vehicle-info - /apis/v1/api-ninjas/get-emoji - /apis/v1/api-ninjas/get-exchange-rate - /apis/v1/api-ninjas/get-exercises - /apis/v1/api-ninjas/get-fact-of-the-day - /apis/v1/api-ninjas/get-facts - /apis/v1/api-ninjas/get-gdp - /apis/v1/api-ninjas/get-geocoding - /apis/v1/api-ninjas/get-helicopter - /apis/v1/api-ninjas/get-historical-events - /apis/v1/api-ninjas/get-historical-figures - /apis/v1/api-ninjas/get-hobbies - /apis/v1/api-ninjas/get-horoscope - /apis/v1/api-ninjas/get-hospitals - /apis/v1/api-ninjas/get-income-tax - /apis/v1/api-ninjas/get-insider-transactions - /apis/v1/api-ninjas/get-ip-lookup - /apis/v1/api-ninjas/get-joke-of-the-day - /apis/v1/api-ninjas/get-jokes - /apis/v1/api-ninjas/get-motorcycles - /apis/v1/api-ninjas/get-mutual-fund - /apis/v1/api-ninjas/get-mx-records - /apis/v1/api-ninjas/get-planets - /apis/v1/api-ninjas/get-population - /apis/v1/api-ninjas/get-postal-code - /apis/v1/api-ninjas/get-property-tax - /apis/v1/api-ninjas/get-public-holidays - /apis/v1/api-ninjas/get-quote-of-the-day - /apis/v1/api-ninjas/get-random-image - /apis/v1/api-ninjas/get-random-quotes - /apis/v1/api-ninjas/get-random-word - /apis/v1/api-ninjas/get-reverse-geocoding - /apis/v1/api-ninjas/get-rhymes - /apis/v1/api-ninjas/get-riddles - /apis/v1/api-ninjas/get-sales-tax - /apis/v1/api-ninjas/get-sec-filing - /apis/v1/api-ninjas/get-stars - /apis/v1/api-ninjas/get-stock-exchange - /apis/v1/api-ninjas/get-stock-price - /apis/v1/api-ninjas/get-swift-code - /apis/v1/api-ninjas/get-thesaurus - /apis/v1/api-ninjas/get-ticker - /apis/v1/api-ninjas/get-timezone - /apis/v1/api-ninjas/get-trivia - /apis/v1/api-ninjas/get-trivia-of-the-day - /apis/v1/api-ninjas/get-unemployment - /apis/v1/api-ninjas/get-university - /apis/v1/api-ninjas/get-url-lookup - /apis/v1/api-ninjas/get-weather - /apis/v1/api-ninjas/get-weather-forecast - /apis/v1/api-ninjas/get-whois - /apis/v1/api-ninjas/get-working-days - /apis/v1/api-ninjas/get-worldtime - /apis/v1/api-ninjas/get-zipcode - /apis/v1/api-ninjas/iban-lookup - /apis/v1/api-ninjas/income-tax-calculator - /apis/v1/api-ninjas/inflation - /apis/v1/api-ninjas/list-stock-tickers - /apis/v1/api-ninjas/lookup-vin - /apis/v1/api-ninjas/market-cap - /apis/v1/api-ninjas/nutrition - /apis/v1/api-ninjas/scrape-website - /apis/v1/api-ninjas/solve-sudoku - /apis/v1/api-ninjas/validate-email - /apis/v1/api-ninjas/validate-eu-vat - /apis/v1/api-ninjas/validate-phone - /apis/v1/api-ninjas/validate-routing-number x-aisa-document: facts_hash: 80f6d0ab09ca1b2bfaa51bc30934eca7d1f0ea7e38c9d075b9100f098998c5d9 generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '28' response_pending: - operation_id: api-ninjas.barcode-generate path: /apis/v1/api-ninjas/barcode-generate method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.bitcoin path: /apis/v1/api-ninjas/bitcoin method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.commodity-price path: /apis/v1/api-ninjas/commodity-price method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.crypto-price path: /apis/v1/api-ninjas/crypto-price method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.disposable-email-checker path: /apis/v1/api-ninjas/disposable-email-checker method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.dns-lookup path: /apis/v1/api-ninjas/dns-lookup method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.earnings-calendar path: /apis/v1/api-ninjas/earnings-calendar method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.earnings-call-transcript path: /apis/v1/api-ninjas/earnings-call-transcript method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.etf-info path: /apis/v1/api-ninjas/etf-info method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.get-ip-lookup path: /apis/v1/api-ninjas/get-ip-lookup method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.get-ticker path: /apis/v1/api-ninjas/get-ticker method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.get-url-lookup path: /apis/v1/api-ninjas/get-url-lookup method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.iban-lookup path: /apis/v1/api-ninjas/iban-lookup method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.income-tax-calculator path: /apis/v1/api-ninjas/income-tax-calculator method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.inflation path: /apis/v1/api-ninjas/inflation method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.market-cap path: /apis/v1/api-ninjas/market-cap method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.nutrition path: /apis/v1/api-ninjas/nutrition method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: api-ninjas.validate-eu-vat path: /apis/v1/api-ninjas/validate-eu-vat method: POST statuses: - '200' reason: public success response has no authoritative payload declaration document_hash: sha256:893ed06a4a54f48629d1c4303925c2c611d07a9ccb107a2d07b0dff0ae10794f x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: api-ninjas x-aisa-catalogs: api-ninjas: title: API Ninjas description: '' x-aisa-document: facts_hash: 80f6d0ab09ca1b2bfaa51bc30934eca7d1f0ea7e38c9d075b9100f098998c5d9 generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/api-ninjas/generate-random-user: post: tags: - API Ninjas summary: Generate Random User Profiles description: >- 按用量计费；默认请求预估费用：$0.00089 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 operationId: api-ninjas.generate-random-user 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 responses: '200': description: Tool result data content: application/json: schema: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_API_NINJAS_GENERATE_RANDOM_USER__output__public_data default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response576A0Ea506F3_connect_API_NINJAS_GENERATE_RANDOM_USER__output__public_data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_API_NINJAS_GENERATE_RANDOM_USER__output__5bb83cc89c91a35e Response576A0Ea506F3_connect_API_NINJAS_GENERATE_RANDOM_USER__output__5bb83cc89c91a35e: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_API_NINJAS_GENERATE_RANDOM_USER__output__2ff931b40818a8f5 Response576A0Ea506F3_connect_API_NINJAS_GENERATE_RANDOM_USER__output__2ff931b40818a8f5: type: object properties: id: type: string age: type: integer dob: type: string job: type: string md5: type: string ssn: type: string url: type: string cell: type: string city: type: string iban: type: string ipv4: type: string ipv6: type: string name: type: string sha1: type: string uuid: type: string email: type: string phone: type: string state: type: string avatar: type: string domain: type: string gender: type: string locale: type: string prefix: type: string sha256: type: string suffix: type: string address: type: string company: type: string country: type: string picture: type: string latitude: type: number password: type: string timezone: type: string username: type: string full_name: type: string last_name: type: string longitude: type: number first_name: type: string user_agent: type: string credit_card: type: string mac_address: type: string postal_code: type: string company_email: type: string street_address: type: string credit_card_provider: type: string securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.