MVK NexuS

Conversiones ▶

Conversión de Códigos Hexadecimales a Nombres de Colores

Ruta: /color?hex=

Descripción: Convierte un código hexadecimal de color en su nombre correspondiente en español.

Parámetro requerido: hex: El código hexadecimal del color.

Ejemplos de solicitud:

/color?hex=FF5733
/color?hex=00FF00
/color?hex=0000FF

Respuesta esperada: El nombre del color en español.

Conversión de Timestamp Unix a Tiempo Formateado

Ruta: /timestamp?unix=

Descripción: Convierte un timestamp Unix a un formato legible.

Parámetro requerido: unix: El timestamp Unix en segundos.

Ejemplos de solicitud:

/timestamp?unix=1609459200 (1 de enero de 2021)
/timestamp?unix=1640995200 (1 de enero de 2022)
/timestamp?unix=1672531200 (1 de enero de 2023)

Respuesta esperada: El tiempo formateado.

Conversión de Unidades

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

Descripción: Convierte una cantidad de una unidad a otra.

Parámetros requeridos: valor, de y a.

Ejemplos de solicitud:

/convertirunidad?valor=10&de=metros&a=pies
/convertirunidad?valor=100&de=kilogramos&a=libras
/convertirunidad?valor=30&de=celsius&a=fahrenheit

Respuesta esperada: La cantidad convertida.

Unidades Disponibles

Ruta: /unidades

Descripción: Devuelve una lista de todas las unidades disponibles.

Ejemplo de solicitud: /unidades

Respuesta esperada: Lista de unidades disponibles para conversión.

Fechas ▶

Diferencia de Días Entre Fechas

Ruta: /datediff?date1=&date2=

Descripción: Calcula la diferencia en días entre dos fechas.

Parámetros requeridos: date1 y date2 en formato ISO.

Ejemplos de solicitud:

/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

Respuesta esperada: La diferencia en días.

Texto ▶

Conversión de Texto a Código Morse

Ruta: /morse?text=

Descripción: Convierte un texto en código morse.

Parámetro requerido: text.

Ejemplos de solicitud:

/morse?text=Hola
/morse?text=SOS
/morse?text=MVK NexuS

Respuesta esperada: El código morse correspondiente.

Diccionario

Ruta: /diccionario?palabra=

Descripción: Devuelve la definición de una palabra proporcionada.

Parámetro requerido: palabra: La palabra que deseas buscar.

Ejemplos de solicitud:

/diccionario?palabra=hola
/diccionario?palabra=efímero
/diccionario?palabra=serendipia

Respuesta esperada: La definición de la palabra en español.

Traducir Texto

Ruta: /traducir?idioma=&texto=

Descripción: Traduce automáticamente un texto de un idioma detectado al idioma especificado.

Parámetros requeridos:

idioma: El código del idioma de destino (por ejemplo, 'en' para inglés, 'fr' para francés).
texto: El texto que deseas traducir.

Ejemplos de solicitud:

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

Respuesta esperada: El texto traducido en el idioma especificado.

Imágenes ▶

Generación de QR Codes

Ruta: /qr?text=

Descripción: Genera un código QR basado en el texto proporcionado.

Parámetro requerido: text: El texto que deseas convertir en un código QR.

Ejemplos de solicitud:

/qr?text=https://www.ejemplo.com
/qr?text=Contacto: Juan Pérez, Tel: 123-456-7890
/qr?text=WiFi:NombreRed;Password:ContraseñaSegura;

Respuesta esperada: Una imagen del código QR que representa el texto proporcionado.

Búsqueda de Imágenes

Ruta: /search-images?q=

Descripción: Busca imágenes basadas en una consulta proporcionada.

Parámetro requerido: q: La consulta de búsqueda para encontrar imágenes.

Ejemplos de solicitud:

/search-images?q=auroras
/search-images?q=gatos+graciosos
/search-images?q=paisajes+montañosos

Respuesta esperada: Un array de URLs de imágenes que coinciden con la consulta.

Generación de Imágenes de Bienvenida

Ruta: /welcome-image

Método: POST

Content-Type: application/json

Descripción: Este endpoint genera una imagen de bienvenida personalizada con un fondo, texto y avatar del usuario.

Parámetros requeridos (POST - JSON):

background: URL de la imagen de fondo.
text1: Primer texto a mostrar en la imagen.
text2: Segundo texto a mostrar en la imagen.
useravatar: URL del avatar del usuario.

Parámetros opcionales (POST - JSON):

textColor: Color del texto en formato hexadecimal (por defecto: blanco).
bordeColor: Color del borde del avatar y del contorno de la imagen en formato hexadecimal (por defecto: blanco).

Ejemplos de solicitud POST (JSON):

{
  "background": "https://example.com/background.jpg",
  "text1": "Bienvenido",
  "text2": "a nuestro servidor",
  "useravatar": "https://example.com/avatar.png",
  "textColor": "#FF0000",
  "bordeColor": "#0000FF"
}

{
  "background": "https://example.com/space.jpg",
  "text1": "Hola",
  "text2": "Explorador",
  "useravatar": "https://example.com/astronaut.png",
  "bordeColor": "#FFFF00"
}

{
  "background": "https://example.com/forest.jpg",
  "text1": "Bienvenido",
  "text2": "a la aventura",
  "useravatar": "https://example.com/explorer.png",
  "textColor": "#00FF00",
  "bordeColor": "#FF00FF"
}

Respuesta esperada: La URL de la imagen de bienvenida generada.

Generación de Tarjetas de Rango/Nivel

Ruta: /rank

Método: POST

Content-Type: application/json

Descripción: Genera una tarjeta de rango o nivel personalizada para usuarios, ideal para mostrar progresos en plataformas o juegos.

Parámetros requeridos (POST - JSON):

background (string): URL de la imagen de fondo para la tarjeta.
username (string): Nombre del usuario que se mostrará en la tarjeta.
color (string): Color del texto del nombre de usuario.
level (number): Nivel actual del usuario.
xp (number): Experiencia actual del usuario.
requiredXp (number): Experiencia necesaria para el siguiente nivel.
status (string): Estado del usuario (ej: "Online", "Offline", "Ausente").
border (string): Color del borde de la tarjeta.
avatar (string): URL de la imagen de perfil del usuario (avatar).

Parámetros opcionales (POST - JSON):

rank (number): Posición del usuario en la clasificación general. Si no se proporciona, no se mostrará el rango.
colorBar (string): Color de la barra de progreso (formato hexadecimal). Por defecto: #ffffff (blanco).
textcolorBar (string): Color del texto dentro de la barra de progreso (formato hexadecimal). Por defecto: #000000 (negro).

Ejemplos de solicitud POST (JSON):

{
  "background": "https://example.com/rank_bg.png",
  "username": "UsuarioEjemplo",
  "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"
}

{
  "background": "https://example.com/dark_bg.jpg",
  "username": "DarknessDev",
  "color": "#FF0000",
  "level": 10,
  "xp": 1500,
  "requiredXp": 2000,
  "status": "Offline",
  "border": "#800080",
  "avatar": "https://example.com/dark_avatar.jpg"
}

Respuesta esperada (JSON):

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

Respuesta de error (JSON):

{
  "error": "Error al generar la tarjeta"
}

Inteligencia Artificial ▶

Interacción con ChatGPT

Ruta: /chatgpt

Método: POST

Descripción: Envía un texto a la API de ChatGPT y recibe una respuesta generada.

Parámetros requeridos (POST): text, userID.

Parámetros opcionales (POST): personality, longitud, systemInstruction.

Ejemplos de solicitud POST:

{
    "text": "Hola, ¿cómo estás?",
    "userID": "12345",
    "personality": "feliz",
    "longitud": 500,
    "systemInstruction": "conversación casual"
}

{
    "text": "Explícame la teoría de la relatividad",
    "userID": "67890",
    "personality": "profesor",
    "longitud": 1000,
    "systemInstruction": "clase de física avanzada"
}

{
    "text": "Escribe un poema sobre el amor",
    "userID": "13579",
    "personality": "romántico",
    "longitud": 300
}

Respuesta esperada: La respuesta generada por ChatGPT.

Interacción con Gemini

Ruta: /gemini

Método: POST

Descripción: Envía un texto a la API de Gemini y recibe una respuesta generada.

Parámetros requeridos (POST): text, userID.

Parámetros opcionales (POST): personality, longitud, systemInstruction, model.

Ejemplos de solicitud POST:

{
    "text": "Hola, ¿cómo estás?",
    "userID": "12345",
    "personality": "feliz",
    "longitud": 500,
    "systemInstruction": "conversación casual",
    "model": "gemini-1.5-flash"
}

{
    "text": "Explícame la teoría de la relatividad",
    "userID": "67890",
    "personality": "profesor",
    "longitud": 1000,
    "context": "systemInstruction",
    "model": "gemini-2.0-flash-exp"
}

{
    "text": "Escribe un poema sobre el amor",
    "userID": "13579",
    "personality": "romántico",
    "longitud": 300,
    "model": "gemini-exp-1206"
}

Respuesta esperada: La respuesta generada por Gemini.

Interacción con DeepSeek

Ruta: /deep-ai

Método: POST

Descripción: Envía un texto a la API de DeepSeek y recibe una respuesta generada.

Parámetros requeridos (POST): text, userID.

Parámetros opcionales (POST): personality, longitud, context.

Ejemplos de solicitud POST:

{
    "text": "Hola, ¿cómo estás?",
    "userID": "12345",
    "personality": "feliz",
    "longitud": 500,
    "context": "conversación casual"
}

{
    "text": "Explícame la teoría de la relatividad",
    "userID": "67890",
    "personality": "profesor",
    "longitud": 1000,
    "context": "clase de física avanzada"
}

{
    "text": "Escribe un poema sobre el amor",
    "userID": "13579",
    "personality": "romántico",
    "longitud": 300
}

Respuesta esperada: La respuesta generada por DeepSeek.

Interacción con Meta AI

Ruta: /meta-ai

Método: POST

Descripción: Envía un texto a la API de Meta AI y recibe una respuesta generada.

Parámetros requeridos (POST): text, userID.

Parámetros opcionales (POST): personality, longitud, context.

Ejemplos de solicitud POST:

{
    "text": "Hola, ¿cómo estás?",
    "userID": "12345",
    "personality": "feliz",
    "longitud": 500,
    "context": "conversación casual"
}

{
    "text": "Explícame la teoría de la relatividad",
    "userID": "67890",
    "personality": "profesor",
    "longitud": 1000,
    "context": "clase de física avanzada"
}

{
    "text": "Escribe un poema sobre el amor",
    "userID": "13579",
    "personality": "romántico",
    "longitud": 300
}

Respuesta esperada: La respuesta generada por Meta AI.

Análisis de Imágenes con IA

Ruta: /vision

Método: GET

Descripción: Este endpoint analiza una imagen utilizando inteligencia artificial y proporciona una descripción basada en el contenido de la imagen.

Parámetros:

url (obligatorio): La URL de la imagen que se desea analizar.
prompt (opcional): Un texto adicional para guiar el análisis de la imagen.

Ejemplos de solicitud:

/vision?url=https://example.com/image.jpg
/vision?url=https://example.com/landscape.png&prompt=Describe los elementos naturales en esta imagen
/vision?url=https://example.com/portrait.jpg&prompt=Analiza la expresión facial y el estado de ánimo

Respuesta esperada: Una descripción detallada del contenido de la imagen basada en el análisis de IA.

Generación de Imágenes con IA

Ruta: /image-ai

Método: POST

Content-Type: application/x-www-form-urlencoded

Descripción: Este endpoint genera imágenes utilizando inteligencia artificial basada en el prompt y el modelo especificados.

Headers requeridos:

API-KEY: Tu clave de API. Tienes que ir al final de este endpoint

Parámetros requeridos:

prompt: El texto descriptivo para generar la imagen.
modelo: El modelo de IA a utilizar para la generación de la imagen.

Modelos disponibles:

v1
v2
v2-beta
v3
lexica
prodia
simurg
animefy
raava
shonin

Nota: Los modelos v1, v2, v2-beta, y v3 son los modelos DALLE que usa ChatGPT.

Ejemplos de solicitud POST:

POST /image-ai HTTP/1.1
Content-Type: application/x-www-form-urlencoded
API-KEY: tu_clave_de_api_aqui

prompt=Un gato jugando al ajedrez&modelo=v3

POST /image-ai HTTP/1.1
Content-Type: application/x-www-form-urlencoded
API-KEY: tu_clave_de_api_aqui

prompt=Paisaje futurista con naves espaciales&modelo=lexica

POST /image-ai HTTP/1.1
Content-Type: application/x-www-form-urlencoded
API-KEY: tu_clave_de_api_aqui

prompt=Retrato de una persona en estilo anime&modelo=animefy

Respuesta esperada: La URL de la imagen generada por la IA según el prompt y el modelo especificados.

Conseguir API Key

Herramientas ▶

Uptime

Ruta: /uptime

Descripción: Verifica el estado y el tiempo de actividad de la API.

Ejemplo de solicitud: /uptime

Respuesta esperada: Mensaje que indica si la API está activa y el tiempo de actividad.

Información de IP

Ruta: /ip?dir=

Descripción: Proporciona información sobre la IP pública de la solicitud.

Ejemplos de solicitud:

/ip?dir=8.8.8.8
/ip?dir=1.1.1.1
/ip?dir=192.168.1.1

Respuesta esperada: Objeto JSON con información detallada sobre la IP pública.

Funciones BDFD (Bot Designer for Discord)

Ruta: /bdfd?funcion=

Método: GET

Descripción: Proporciona información sobre las funciones de BDFD.

Parámetro requerido: funcion: El nombre de la función BDFD.

Ejemplos de solicitud:

/bdfd?funcion=$title[]
/bdfd?funcion=$nomention
/bdfd?funcion=$randomText[]

Respuesta esperada: Información detallada sobre la función BDFD especificada.

Juegos ▶

Akinator API

Ruta base: /aki

Descripción: Proporciona acceso al juego Akinator.

Cómo jugar a Akinator

Akinator es un juego en el que piensas en un personaje y el juego intenta adivinarlo haciendo preguntas. Sigue estos pasos para jugar:

Paso 1: Iniciar el juego

Para comenzar, haz una solicitud GET a:

GET /iniciar?region=es&modoInfantil=true

Esto inicia el juego en español y en modo infantil.

Opciones de región:

en - Inglés (por defecto)
es - Español
fr - Francés
de - Alemán
... y más.

Paso 2: Responder preguntas

A medida que Akinator te haga preguntas, responde enviando una solicitud GET a:

GET /respuesta/:juegoId?respuesta={tu_respuesta}

Ejemplo:

GET /respuesta/12345?respuesta=si

Reemplaza 12345 con el juegoId que obtuviste en el paso anterior y usa las siguientes respuestas:

si - Sí
no - No
no lo se - No lo sé
probablemente - Probablemente
probablemente no - Probablemente no

Paso 3 (opcional): Obtener la respuesta final

Cuando estés listo para que Akinator adivine tu personaje, envía una solicitud GET a:

GET /adivinar/:juegoId

Ejemplo:

GET /adivinar/12345

Esto te dará la mejor conjetura de Akinator.

Paso 4: Retroceder preguntas

Si deseas retroceder una pregunta, envía una solicitud GET a:

GET /retroceder/:juegoId

Ejemplo:

GET /retroceder/12345

Esto te permitirá volver a la pregunta anterior.

Paso 5: Ver progreso

Para ver el progreso del juego, haz una solicitud GET a:

GET /progreso/:juegoId

Ejemplo:

GET /progreso/12345

Esto te mostrará cuántas preguntas se han hecho hasta ahora.

Paso 6: Finalizar el juego

Si deseas eliminar un juego en curso, envía una solicitud DELETE a:

DELETE /juego/:juegoId

Esto finalizará y eliminará el juego.

MVK NexuS

API Documentation

Endpoints Disponibles

Conversión de Códigos Hexadecimales a Nombres de Colores

Conversión de Timestamp Unix a Tiempo Formateado

Conversión de Unidades

Unidades Disponibles

Diferencia de Días Entre Fechas

Conversión de Texto a Código Morse

Diccionario

Traducir Texto

Generación de QR Codes

Búsqueda de Imágenes

Generación de Imágenes de Bienvenida

Ejemplos de solicitud POST (JSON):

Generación de Tarjetas de Rango/Nivel

Ejemplos de solicitud POST (JSON):

Interacción con ChatGPT

Ejemplos de solicitud POST:

Interacción con Gemini

Ejemplos de solicitud POST:

Interacción con DeepSeek

Ejemplos de solicitud POST:

Interacción con Meta AI

Ejemplos de solicitud POST:

Análisis de Imágenes con IA

Generación de Imágenes con IA

Ejemplos de solicitud POST:

Uptime

Información de IP

Funciones BDFD (Bot Designer for Discord)

Akinator API

Cómo jugar a Akinator

Paso 1: Iniciar el juego

Paso 2: Responder preguntas

Paso 3 (opcional): Obtener la respuesta final

Paso 4: Retroceder preguntas

Paso 5: Ver progreso

Paso 6: Finalizar el juego