API Documentation

Integrate the HyperVision neural engine directly into your applications. Fast, scalable, and fully RESTful.

Getting Started

The HyperVision API provides programmatic access to our most powerful neural tools. The base URL for all API requests is:

https://api.hypervision.art

Alternative URL: If you are experiencing DNS issues with the api subdomain, you can also use https://hypervision.art/api/v1/... as a fallback.

Authentication

All API requests require authentication using your secret API key. You can find your API key in the Developer Console.

Pass your API key using the X-API-Key or Authorization header.

HTTP Header
X-API-Key: hv_live_your_secret_key_here
POST

/v1/generate

Generate high-fidelity AI images using our distributed neural models. This endpoint processes text prompts and returns a direct image URL.

Parameters

Name Type Description
prompt * string The text description of the image you want to generate.
model string The neural model to use. Defaults to flux.
width integer Image width in pixels. Defaults to 1024.
height integer Image height in pixels. Defaults to 1024.

Request Example

curl -X POST "https://api.hypervision.art/v1/generate" \ -H "X-API-Key: hv_live_123456789" \ -H "Content-Type: application/json" \ -d '{ "prompt": "Cyberpunk city at night", "model": "flux", "width": 1920, "height": 1080 }'

Response Example

{ "status": "success", "id": "gen_8a7f9b2c", "prompt": "Cyberpunk city at night", "model": "flux", "resolution": "1920x1080", "data": { "url": "https://gen.pollinations.ai/..." }, "meta": { "credit_cost": 1, "remaining_credits": 9999 } }
POST

/v1/roast

Initiate a neural AI roast on a target username. The engine simulates analyzing their digital footprint and returns a brutal response.

Parameters

Name Type Description
username * string The target username you wish to roast.

Request Example

curl -X POST "https://api.hypervision.art/v1/roast" \ -H "X-API-Key: hv_live_123456789" \ -H "Content-Type: application/json" \ -d '{ "username": "elonmusk" }'

Response Example

{ "status": "success", "id": "rst_4b3e1a9f", "data": { "target": "elonmusk", "roast": "Analyzing @elonmusk... 100% chance they still have 'test' as a password.", "severity": "brutal" } }
POST

/v1/downloader

Extract high-quality media (video, images, audio) directly from supported social network URLs using our scraping engine.

Parameters

Name Type Description
url * string The URL of the social media post you want to extract media from.

Request Example

curl -X POST "https://api.hypervision.art/v1/downloader" \ -H "X-API-Key: hv_live_123456789" \ -H "Content-Type: application/json" \ -d '{ "url": "https://tiktok.com/@example/video/123" }'

Response Example

{ "status": "success", "id": "dwn_2f9c3b8a", "data": { "source_url": "https://tiktok.com/@example/video/123", "media_type": "video/mp4", "download_url": "https://hypervision.art/assets/...", "quality": "1080p" } }
POST

/v1/social

Launch a concurrent OSINT (Open Source Intelligence) scan across 330+ social networks and dark web nodes to find profiles matching a username.

Parameters

Name Type Description
username * string The target username to hunt for across the network grid.

Request Example

curl -X POST "https://api.hypervision.art/v1/social" \ -H "X-API-Key: hv_live_123456789" \ -H "Content-Type: application/json" \ -d '{ "username": "johndoe123" }'

Response Example

{ "status": "success", "id": "osint_7d1e8c4b", "data": { "target": "johndoe123", "platforms_scanned": 330, "hits": ["Instagram", "Twitter", "GitHub", "Reddit"], "confidence": 0.94 } }

Error Codes

The HyperVision API uses standard HTTP response codes to indicate the success or failure of an API request.

Status Code Meaning
200 OK The request was successful.
400 Bad Request Missing required parameters (e.g. forgot to include prompt).
401 Unauthorized Your API key is missing or invalid. Check your headers.
429 Too Many Requests You have exceeded your plan's rate limit or monthly quota.
500 Server Error The neural network experienced an unexpected failure.