MVK NexuS

API Documentation

API que ofrece varios servicios principales

Endpoints Disponibles

Esta API ofrece varios servicios principales, categorizados a continuación:

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.

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.