MVK NexuS API Documentation

Conversions ▶

Hex Code Color Information

Route: /color?hex=

Description: Provides detailed information about a hexadecimal color code, including RGB, HSL, CMYK values, luminosity, and names in English and Spanish.

Required parameter: hex: The hexadecimal color code (e.g., FF5733 or #FF5733).

Request examples:

/color?hex=FF5733
/color?hex=%2300FF00 (Use %23 for #)
/color?hex=0000FF

Expected response (JSON):


{
  "color": {
    "originalHex": "#FF0000",
    "hex": "#FF0000",
    "rgb": {
      "string": "rgb(255, 0, 0)",
      "array": [255, 0, 0]
    },
    "hsl": {
      "string": "hsl(0, 100%, 50%)",
      "array": [0, 100, 50]
    },
    "cmyk": [0, 100, 100, 0],
    "luminosity": 0.2126,
    "isLight": false,
    "isDark": true,
    "names": {
      "english": "red",
      "spanish": "rojo"
    },
    "requestCount": 1
  }
}

Unix Timestamp to Formatted Time Conversion

Route: /timestamp?unix=

Description: Converts a Unix timestamp to a human-readable date and time format.

Required parameter: unix: The Unix timestamp in seconds.

Request examples:

/timestamp?unix=1609459200 (January 1, 2021)
/timestamp?unix=1640995200 (January 1, 2022)
/timestamp?unix=1672531200 (January 1, 2023)

Expected response (Plain Text): Plain text representing the formatted date and time (e.g., `Friday, August 23, 2024 10:00:00 AM UTC`).

Unit Conversion

Route: /convertirunidad?valor=&de=&a=

Description: Converts a quantity from one unit to another.

Required parameters: valor, de (from), and a (to).

Request examples:

/convertirunidad?valor=10&de=metros&a=pies (meters to feet)
/convertirunidad?valor=100&de=kilogramos&a=libras (kilograms to pounds)
/convertirunidad?valor=30&de=celsius&a=fahrenheit (Celsius to Fahrenheit)

Expected response (Plain Text): Plain text representing the converted value and unit (e.g., `32.81 pies`).

Available Units

Route: /unidades

Description: Returns a list of all available units for conversion.

Request example: /unidades

Expected response: List of units available for conversion (likely JSON or plain text list).

Dates ▶

Day Difference Between Dates

Route: /datediff?date1=&date2=

Description: Calculates the difference in days between two dates.

Required parameters: date1 and date2 in ISO format (YYYY-MM-DD).

Request examples:

/datediff?date1=2023-01-01&date2=2024-08-21
/datediff?date1=2022-05-15&date2=2023-05-15
/datediff?date1=2024-02-29&date2=2025-02-28

Expected response (Plain Text): Plain text representing the number of days (e.g., `598`).

Text ▶

Text to Morse Code Conversion

Route: /morse?text=

Description: Converts text into Morse code.

Required parameter: text.

Request examples:

/morse?text=Hello
/morse?text=SOS
/morse?text=MVK%20NexuS (URL encode spaces)

Expected response (Plain Text): Plain text containing the Morse code representation (e.g., `.... . .-.. .-.. ---`).

Translate Text

Route: /traducir?idioma=&texto=

Description: Automatically translates text from a detected language to the specified language.

Required parameters:

idioma (language): The target language code (e.g., 'en' for English, 'fr' for French, 'es' for Spanish).
texto (text): The text you want to translate.

Request examples:

/traducir?idioma=en&texto=Hola%20mundo
/traducir?idioma=fr&texto=Good%20morning
/traducir?idioma=es&texto=I%20love%20programming

Expected response (JSON):


{
  "result": "Hello world"
}

Images ▶

QR Code Generation

Route: /qr?text=

Description: Generates a QR code based on the provided text and returns the URL to the generated image.

Required parameter: text: The text you want to convert into a QR code.

Request examples:

/qr?text=https://www.example.com
/qr?text=Contact:%20John%20Doe,%20Tel:%20123-456-7890
/qr?text=WiFi:NetworkName;Password:SecurePassword;

Expected response (JSON):


{"qr":"https://nexus.adonis-except.xyz/public/qr_1746483998957.jpg"}

Image Search

Route: /search-images?q=

Description: Searches for images based on a provided query using Google Images. Returns up to 100 image URLs.

Required parameter: q: The search query to find images.

Request examples:

/search-images?q=auroras
/search-images?q=funny+cats
/search-images?q=mountain+landscapes

Expected response (JSON):


{
  "result": [
    "https://example.com/image1.jpg",
    "https://example.com/image2.png",
    "...",
    "https://example.com/image100.gif"
  ]
}

Welcome Image Generation

Route: /welcome/welcome-image

Method: POST

Content-Type: application/json

Description: This endpoint generates a custom welcome image with a background, text, and user avatar. Requires an API Key sent via header. Returns the path/URL to the generated image.

Required Headers:

x-api-key: Your API key.

Required parameters (POST - JSON Body):

background: URL of the background image.
text1: First text to display on the image.
text2: Second text to display on the image.
useravatar: URL of the user's avatar.

Optional parameters (POST - JSON Body):

textColor: Text color in hexadecimal format (default: white).
bordeColor (border color): Color of the avatar border and image outline in hexadecimal format (default: white).
type (number, optional): Specifies the style of the welcome image. Valid values: 1, 2, or 3.

Example POST requests (JSON):


POST /welcome/welcome-image
Content-Type: application/json
x-api-key: your_api_key_here

{
  "background": "https://example.com/background.jpg",
  "text1": "Welcome",
  "text2": "to our server",
  "useravatar": "https://example.com/avatar.png",
  "textColor": "#FF0000",
  "bordeColor": "#0000FF",
  "type": 1
}


POST /welcome/welcome-image
Content-Type: application/json
x-api-key: your_api_key_here

{
  "background": "https://example.com/space.jpg",
  "text1": "Hello",
  "text2": "Explorer",
  "useravatar": "https://example.com/astronaut.png",
  "bordeColor": "#FFFF00",
  "type": 2
}


POST /welcome/welcome-image
Content-Type: application/json
x-api-key: your_api_key_here

{
  "background": "https://example.com/forest.jpg",
  "text1": "Welcome",
  "text2": "to the adventure",
  "useravatar": "https://example.com/explorer.png",
  "textColor": "#00FF00",
  "bordeColor": "#FF00FF",
  "type": 3
}

Expected response (JSON):


{
  "result": "/public/generated_image_hash.png"
}

Join Discord for API Key

Rank/Level Card Generation

Route: /rank

Method: POST

Content-Type: application/json

Description: Generates a custom rank or level card for users, ideal for displaying progress in platforms or games. Offers multiple card styles via the type parameter. Requires an API Key sent via header. Returns the path/URL to the generated image.

Required Headers:

x-api-key: Your API key.

General Parameters (POST - JSON Body):

These parameters are generally accepted, but their exact effect or applicability might vary depending on the chosen card type (see details below).

background (string): URL or hex color for the card background (usage varies by type).
username (string): User's name to display.
level (number): User's current level.
xp (number): User's current experience points.
requiredXp (number): Experience points needed for the next level.
avatar (string): URL of the user's profile picture (avatar).
status (string, optional): User's status (e.g., "online", "idle", "dnd", "offline"). Usage varies by type, often defaults to "online".
rank (number, optional): User's position in the ranking. Displayed if provided (required for some types).
color (string, optional): Color for username text (hex format). Default and usage vary by type.
border (string/number, optional): Card/avatar border color (hex) or width (number). Usage and format vary by type.
colorBar (string, optional): Color of the progress bar (hex format). Default and usage vary by type.
textcolorBar (string, optional): Color of text inside the progress bar (hex format). Usage varies by type.
tag (string, optional): User's tag (e.g., discriminator). Usage varies by type.
type (number, optional): Specifies the style of the rank card. Valid values: 1, 2, 3, or 4. Defaults to 1 if not specified or invalid.

Rank Card Types & Specific Parameter Behavior:

The type parameter determines the card's appearance and how other parameters are used.

Type 1

Working Parameters:

background: URL or hexadecimal color for the card background.
username: Username displayed on the card.
level: User's current level.
xp: Current experience points.
requiredXp: Experience needed for the next level.
avatar: URL of the user's avatar image.
color: Color for the username text (hexadecimal format, default #FFFFFF).
status: User status (e.g., online, dnd, etc.), default online.
border: Card border color (hexadecimal format, default #000000).
colorBar: Progress bar color (hexadecimal format, default #FFFFFF).
textcolorBar: Progress bar text color (hexadecimal format, default #000000).
rank: User rank (optional, displayed if provided).

Non-Working Parameters:

tag: Not used in this generator type.

Type 2

Working Parameters:

username: Username displayed on the card.
level: User's current level (displayed as "Level X").
avatar: URL of the user's avatar image.
xp: Current experience points.
requiredXp: Experience needed for the next level (used for progress calculation).
status: User status (e.g., online, dnd, etc.).
colorBar: Progress bar color (used as color in the underlying rankcard library, default #FFFFFF). This often influences other elements too.
rank: User rank (optional, displayed if provided).

Non-Working Parameters:

background: Not compatible with this generator type.
color: Not used directly for username text; colorBar takes priority for the general color scheme.
border: Not used for defining borders in this type.
textcolorBar: Not used for the progress bar text color.
tag: Not used in this generator type.

Type 3

Working Parameters:

background: URL or hexadecimal color for the background (if URL, used as image; if color, applied to background and optionally "bubbles").
username: Username displayed on the card.
level: User's current level.
rank: User rank (required in this type).
avatar: URL of the user's avatar image.
xp: Current experience points.
requiredXp: Experience needed for the next level.
status: User status (e.g., online, dnd, etc.), default online.
border: Avatar border color (hexadecimal format, default #0CA7FF if not specified).
colorBar: Progress bar or "bubbles" color (hexadecimal format, default #0CA7FF).
textcolorBar: Default color for text (includes current/required XP, default #FFFFFF).
color: Color for the username text (hexadecimal format, default #0CA7FF).

Non-Working Parameters:

tag: Not used in this generator type.

Type 4

Working Parameters:

background: Hexadecimal color for the background (colors only, no URLs; default #23272A).
username: Username displayed on the card.
tag: User tag (optional, displayed if provided).
level: User's current level.
rank: User rank (required in this type).
avatar: URL of the user's avatar image.
xp: Current experience points.
requiredXp: Experience needed for the next level.
color: Color for username text and other text elements (hexadecimal format, default #DDA0DD).
border: Numeric width of the avatar border (in pixels, default 8 if not a valid number).
colorBar: Progress bar color (hexadecimal format, default #FF69B4).

Non-Working Parameters:

status: Not used in this generator type.
textcolorBar: Not used directly; text color is controlled by color.

Example POST requests (JSON):

Using Type 1 (default):


POST /rank
Content-Type: application/json
x-api-key: your_api_key_here

{
  "background": "https://example.com/rank_bg.png",
  "username": "UserExample",
  "color": "#FFFFFF",
  "level": 5,
  "xp": 750,
  "requiredXp": 1000,
  "status": "online",
  "border": "#00FFFF",
  "avatar": "https://example.com/user_avatar.png",
  "rank": 15,
  "colorBar": "#00FF00",
  "textcolorBar": "#FFFFFF"
}

Explicitly requesting Type 2:


POST /rank
Content-Type: application/json
x-api-key: your_api_key_here

{
  "username": "DarknessDev",
  "level": 10,
  "xp": 1500,
  "requiredXp": 2000,
  "status": "dnd",
  "avatar": "https://example.com/dark_avatar.jpg",
  "colorBar": "#FF5733",
  "rank": 3,
  "type": 2
}

Requesting Type 3 (Rank is required):


POST /rank
Content-Type: application/json
x-api-key: your_api_key_here

{
  "background": "#334455",
  "username": "BubbleMaster",
  "color": "#0CA7FF",
  "level": 20,
  "xp": 4500,
  "requiredXp": 5000,
  "status": "idle",
  "border": "#FFFF00",
  "avatar": "https://example.com/bubble_avatar.png",
  "rank": 1,
  "colorBar": "#0CA7FF",
  "textcolorBar": "#FFFFFF",
  "type": 3
}

Requesting Type 4 (Rank is required):


POST /rank
Content-Type: application/json
x-api-key: your_api_key_here

{
  "background": "#2C2F33",
  "username": "ModernUser",
  "tag": "0001",
  "color": "#DDA0DD",
  "level": 8,
  "xp": 1200,
  "requiredXp": 1500,
  "border": 10,
  "avatar": "https://example.com/modern_avatar.png",
  "rank": 25,
  "colorBar": "#FF69B4",
  "type": 4
}

Expected response (JSON):


{
  "result": "/public/rank_card_hash.png"
}

Error response (JSON):


{
  "error": "Error generating the card"
}

Join Discord for API Key

Level Up Card Generation

Route: /rank/level-up

Method: POST

Content-Type: application/json

Description: Generates a level-up card showing user level progression. Requires an API Key sent via header. Returns the path/URL to the generated image.

Required Headers:

x-api-key: Your API key.

Required parameters (POST - JSON Body):

avatar (string): URL of the user's avatar image.
backround (string): Background color (HEX) or image URL.
username (string): Username to display on the card.
levels (array or object): Previous and new level information (e.g., [10, 11] or {"old": 10, "new": 11}).

Optional parameters (POST - JSON Body):

border (string): Card border color in HEX format.
avatarBorder (string): Avatar border color in HEX format.
opacity (number): Overlay opacity value (0-1).

Example POST requests (JSON):


POST /rank/level-up
Content-Type: application/json
x-api-key: your_api_key_here

{
  "avatar": "https://example.com/imagen-avatar.png",
  "backround": "#070d19",
  "username": "JuanPerez",
  "levels": [10, 11],
  "border": "#FF0000",
  "avatarBorder": "#00FF00",
  "opacity": 0.8
}


POST /rank/level-up
Content-Type: application/json
x-api-key: your_api_key_here

{
  "avatar": "https://example.com/imagen-avatar.png",
  "backround": "https://example.com/fondo.jpg",
  "username": "JuanPerez",
  "levels": { "old": 10, "new": 11 },
  "border": "#FF0000"
}

Expected response (JSON):


{
  "result": "/public/level_up_hash.png"
}

Join Discord for API Key

Artificial Intelligence ▶

ChatGPT Interaction

Route: /chatgpt

Method: POST

Content-Type: application/json

Description: Sends text to the ChatGPT API and receives a generated response. Requires an API Key sent via header.

Required Headers:

x-api-key: Your API key.

Required parameters (POST - JSON Body):

text: The user's input text.
userID: A unique identifier for the user.

Optional parameters (POST - JSON Body):

personality: Defines the personality of the AI (e.g., "happy", "professor").
longitud (length): Desired approximate length of the response.
systemInstruction: Specific instructions for the AI's behavior or context.
model: The specific model to use. Available models: gpt-4o-mini, o3-mini. Default: gpt-4o-mini.

Example POST requests:


POST /chatgpt
Content-Type: application/json
x-api-key: your_api_key_here

{
    "text": "Hello, how are you?",
    "userID": "12345",
    "personality": "happy",
    "longitud": 500,
    "systemInstruction": "casual conversation"
}


POST /chatgpt
Content-Type: application/json
x-api-key: your_api_key_here

{
    "text": "Explain the theory of relativity",
    "userID": "67890",
    "personality": "professor",
    "longitud": 1000,
    "systemInstruction": "advanced physics class",
    "model": "o3-mini"
}

Expected response (JSON):


{
  "result": "Respuesta de la IA"
}

Join Discord for API Key

Gemini Interaction

Route: /gemini

Method: POST

Content-Type: application/json

Description: Sends text to the Gemini API and receives a generated response. Can also analyze images and videos if provided. Requires an API Key sent via header.

Required Headers:

x-api-key: Your API key.

Required parameters (POST - JSON Body):

text: The user's input text.
userID: A unique identifier for the user.

Optional parameters (POST - JSON Body):

personality: Defines the personality of the AI.
longitud (length): Desired approximate length of the response.
systemInstruction: Specific instructions for the AI's behavior.
model: The specific Gemini model to use (e.g., "gemini-1.5-flash", "gemini-pro").
image (string or array of strings): URL(s) of image(s) (e.g., .PNG, .JPG, .GIF) or video(s) (e.g., .MP4) to send to the AI for analysis. Send a single URL as a string, or multiple URLs as an array of strings.

Example POST requests:


POST /gemini
Content-Type: application/json
x-api-key: your_api_key_here

{
    "text": "Hello, how are you?",
    "userID": "12345",
    "personality": "happy",
    "longitud": 500,
    "systemInstruction": "casual conversation",
    "model": "gemini-1.5-flash"
}


POST /gemini
Content-Type: application/json
x-api-key: your_api_key_here

{
    "text": "Describe the objects in these images.",
    "userID": "13579",
    "image": [
        "https://example.com/image1.png",
        "https://example.com/image2.gif",
        "https://example.com/video.mp4"
    ]
}

Expected response (JSON):


{
  "result": "Respuesta de la IA"
}

Join Discord for API Key

DeepSeek Interaction

Route: /deep-ai

Method: POST

Content-Type: application/json

Description: Sends text to the DeepSeek API and receives a generated response. Requires an API Key sent via header.

Required Headers:

x-api-key: Your API key.

Required parameters (POST - JSON Body):

text: The user's input text.
userID: A unique identifier for the user.

Optional parameters (POST - JSON Body):

personality: Defines the personality of the AI.
longitud (length): Desired approximate length of the response.
context: Specific context or instructions for the AI (replaces systemInstruction).

Example POST requests:


POST /deep-ai
Content-Type: application/json
x-api-key: your_api_key_here

{
    "text": "Hello, how are you?",
    "userID": "12345",
    "personality": "happy",
    "longitud": 500,
    "context": "casual conversation"
}

Expected response (JSON):


{
  "result": "Respuesta de la IA"
}

Join Discord for API Key

Meta AI Interaction

Route: /meta-ai

Method: POST

Content-Type: application/json

Description: Sends text to the Meta AI API and receives a generated response. Requires an API Key sent via header.

Required Headers:

x-api-key: Your API key.

Required parameters (POST - JSON Body):

text: The user's input text.
userID: A unique identifier for the user.

Optional parameters (POST - JSON Body):

personality: Defines the personality of the AI.
longitud (length): Desired approximate length of the response.
context: Specific context or instructions for the AI (replaces systemInstruction).

Example POST requests:


POST /meta-ai
Content-Type: application/json
x-api-key: your_api_key_here

{
    "text": "Hello, how are you?",
    "userID": "12345",
    "personality": "happy",
    "longitud": 500,
    "context": "casual conversation"
}

Expected response (JSON):


{
  "result": "Respuesta de la IA"
}

Join Discord for API Key

AI Image Analysis (Vision)

Route: /vision

Method: POST

Content-Type: application/json

Description: This endpoint analyzes an image using artificial intelligence and provides a description based on the image content. Requires a Nexus API Key.

Required Headers:

x-api-key: Your Nexus API Key.

Required Body Parameters (JSON):

url: The URL of the image to be analyzed.
prompt: Text to guide the image analysis.
userID: A unique identifier for the user making the request.

Request examples:


POST /vision
Content-Type: application/json
x-api-key: your_nexus_api_key

{
  "url": "https://example.com/image.jpg",
  "prompt": "Describe everything you see in the image.",
  "userID": "user123"
}

Expected response (JSON): Likely a JSON object containing the analysis, similar to other AI endpoints.


{
  "result": "AI-generated description of the image content."
}

Join Discord for API Key

AI Image Generation

Route: /image-ai

Method: POST

Content-Type: application/json

Description: This endpoint generates images using artificial intelligence based on the specified prompt and model. All optional parameters listed below are supported by all available models. Requires an API Key sent via header. Returns the path/URL to the generated image.

Required Headers:

x-api-key: Your API key. You need to join the Discord server to get one.

Required Parameters (POST - JSON Body):

prompt (string): The descriptive text to generate the image. Example: "Un castillo en las nubes al atardecer".

Optional Parameters (POST - JSON Body):

negative_prompt (string, default: ""): Elements you do not want in the image. Example: "personas, texto, desenfoque".
model (string, default: "flux"): The AI model to use for image generation. Example: "flux-realism".
width (number, default: 1024): Width of the generated image in pixels. Example: 512.
height (number, default: 1024): Height of the generated image in pixels. Example: 768.
seed (number, default: null): Seed number for reproducible results. If not defined, generation is random. Example: 12345.
nologo (boolean, default: false): If true, attempts to generate the image without logos or watermarks.
private (boolean, default: false): If true, marks the image as private (depending on the storage system).
enhance (boolean, default: false): If true, applies quality enhancements to the image (depending on the model or API support).
safe (boolean, default: false): If true, applies filters to ensure the generated image is safe for all audiences.

Available models:

flux
flux-realism
flux-anime
flux-3d
flux-pro
any-dark
turbo
pimp-diffusion
magister-diffusion
dolly-mini
stable-diffusion
stable-diffusion-animation
photo3dwillit
lucid-sonic-dreams
codeformer (Note: This model is likely for face restoration, parameter behavior might differ slightly in practice)
bark (Note: This model is primarily for audio, parameter behavior might differ significantly or it might not be a valid image model)
3d-photo-inpainting (Note: Parameter behavior might differ for this specific task)

Note: While all parameters are listed as accepted for all models, some models like codeformer, bark, or 3d-photo-inpainting might have specialized purposes where certain parameters (like negative_prompt, width/height in the standard sense, etc.) might not have the typical effect of standard text-to-image models.

Example POST requests (JSON):


POST /image-ai
Content-Type: application/json
x-api-key: your_api_key_here

{
  "prompt": "A castle in the clouds at sunset, detailed, epic fantasy",
  "model": "flux-realism",
  "width": 1024,
  "height": 768,
  "seed": 67890,
  "negative_prompt": "blurry, low quality"
}

Expected response (JSON):


{
    "result": "/public/ai_image_hash.jpg"
}

Join Discord for API Key

Tools ▶

Uptime

Route: /uptime

Description: Checks the status and uptime of the API.

Request example: /uptime

Expected response: Message indicating if the API is active and its uptime (likely plain text or simple JSON).

IP Information

Route: /ip?dir=

Description: Provides geographical and network information about a given IP address.

Required parameter: dir: The IP address to look up.

Request examples:

/ip?dir=8.8.8.8
/ip?dir=1.1.1.1
/ip?dir=198.51.100.0 (Example public IP)

Expected response (JSON):


{
  "ip": "8.8.8.8",
  "pais": "US",
  "codigo_pais": "US",
  "region": "No disponible",
  "latitud": 37.751,
  "longitud": -97.822,
  "zona_horaria": "America/Chicago",
  "isp": [134744064, 134744575],
  "organizacion": "No disponible"
}

BDFD Functions (Bot Designer for Discord)

Route: /bdfd?funcion=

Method: GET

Description: Provides detailed information about a specific BDFD function.

Required parameter: funcion (function): The name of the BDFD function (URL encode special characters like $ to %24).

Request examples:

/bdfd?funcion=%24title[]
/bdfd?funcion=%24nomention
/bdfd?funcion=%24randomText[]

Expected response (JSON):


{"nombre":"$title","descripcion":"Añade un título a un embed.","sintaxis":"$title[Title;(Index)]","ejemplo_descripcion":"Establece 'Mensaje Importante' como título del primer embed.","ejemplo_codigo":"$nomention\n$title[Mensaje Importante;1]\n$description[Contenido...]","premium":false,"intents":0,"bdscript_version":"1 y 2","deprecated":false,"deprecated_for":null}

MVK NexuS

API Documentation

Available Endpoints

Hex Code Color Information

Unix Timestamp to Formatted Time Conversion

Unit Conversion

Available Units

Day Difference Between Dates

Text to Morse Code Conversion

Translate Text

QR Code Generation

Image Search

Welcome Image Generation

Example POST requests (JSON):

Rank/Level Card Generation

Rank Card Types & Specific Parameter Behavior:

Type 1

Type 2

Type 3

Type 4

Example POST requests (JSON):

Level Up Card Generation

Example POST requests (JSON):

ChatGPT Interaction

Example POST requests:

Gemini Interaction

Example POST requests:

DeepSeek Interaction

Example POST requests:

Meta AI Interaction

Example POST requests:

AI Image Analysis (Vision)

AI Image Generation

Example POST requests (JSON):

Uptime

IP Information

BDFD Functions (Bot Designer for Discord)