Saltar al contenido principal

🛠️ Endpoints de Utilidad

SpeckUIX proporciona varios endpoints de utilidad para obtener información de IP, geolocalización, clima y conversión de moneda. A continuación se detalla cada uno de ellos.

🌐 Obtener IP Actual​

Obtiene la dirección IP del dispositivo que realiza la petición.

Endpoint​

GET /api/ip
Ver ejemplo de uso
curl --request GET \
  --url 'https://api.speckuix.page/api/ip' \
  --header 'Authorization: Bearer 1xxxxxx-1x-1x-1x-1x'
Ver ejemplo de respuesta
{
  "ip": "181.55.68.70"
}
Costo

$0.000014 USD por solicitud

🗺️ Geolocalización por IP​

Obtiene información detallada de geolocalización basada en una dirección IP.

Endpoint​

GET /api/geo-location

Parámetros de Consulta​

ParámetroTipoDescripciónRequerido
ipstringDirección IP a consultar✅
Ver ejemplo de uso
curl --request GET \
  --url 'https://api.speckuix.page/api/geo-location?ip=181.55.68.70' \
  --header 'Authorization: Bearer 1xxxxxx-1x-1x-1x-1x'
Ver ejemplo de respuesta
{
  "ip": "190.144.218.193",
  "country_code": "CO",
  "country_name": "Colombia",
  "region_name": "Bogota D.C.",
  "city_name": "Bogotá",
  "latitude": 4.6313,
  "longitude": -74.0344,
  "postal": "110231",
  "utc_offset": "-0500",
  "asn": "AS14080",
  "as": "Latin American and Caribbean IP Address Regional Registry",
  "is_proxy": false,
  "network": "190.144.208.0/20",
  "version": "IPv4",
  "region_code": "DC",
  "country_code_iso3": "COL",
  "country_capital": "Bogota",
  "country_tld": ".co",
  "continent_code": "SA",
  "in_eu": false,
  "timezone": "America/Bogota",
  "country_calling_code": "+57",
  "currency": "COP",
  "currency_name": "Peso",
  "languages": "es-CO",
  "country_area": 1138910,
  "country_population": 49648685,
  "org": "Telmex Colombia S.A."
}
Costo

$0.003 USD por solicitud

⛅ Información del Clima​

Obtiene información actualizada del clima.

Endpoint​

GET /api/weather
Ver ejemplo de uso
curl --request GET \
  --url 'https://api.speckuix.page/api/weather' \
  --header 'Authorization: Bearer 1xxxxxx-1x-1x-1x-1x'
Ver ejemplo de respuesta
{
  "latitude": 38.890526,
  "longitude": -77.02716,
  "generationtime_ms": 0.05507469177246094,
  "utc_offset_seconds": 0,
  "timezone": "GMT",
  "timezone_abbreviation": "GMT",
  "elevation": 12,
  "current_weather_units": {
    "time": "iso8601",
    "interval": "seconds",
    "temperature": "°F",
    "windspeed": "km/h",
    "winddirection": "°",
    "is_day": "",
    "weathercode": "wmo code"
  },
  "current_weather": {
    "time": "2024-11-29T00:00",
    "interval": 900,
    "temperature": 41.6,
    "windspeed": 10.3,
    "winddirection": 299,
    "is_day": 0,
    "weathercode": 0
  }
}
Costo

$0.0015 USD por solicitud

💱 Conversor de Moneda​

Convierte cantidades entre diferentes monedas usando tasas de cambio actualizadas.

Lista Completa de Monedas

Ver la lista completa de monedas soportadas (161 monedas mundiales)

Endpoint​

GET /api/currency-converter

Parámetros de Consulta​

ParámetroTipoDescripciónRequerido
basestringMoneda base (ej: USD)✅
tostringMoneda destino (ej: COP)✅
amountnumberCantidad a convertir✅
Ver ejemplo de uso
curl --request GET \
  --url 'https://api.speckuix.page/api/currency-converter?base=USD&to=COP&amount=1' \
  --header 'Authorization: Bearer 1xxxxxx-1x-1x-1x-1x'
Ver ejemplo de respuesta
{
  "value": 4390.4611
}
Costo

$0.0024 USD por solicitud

Monedas Soportadas​

El servicio soporta 161 monedas mundiales comúnmente circulantes.

Ver monedas principales

🌍 Monedas Principales​

  • USD (Dólar Estadounidense)
  • EUR (Euro)
  • GBP (Libra Esterlina)
  • JPY (Yen Japonés)
  • AUD (Dólar Australiano)
  • CAD (Dólar Canadiense)
  • CHF (Franco Suizo)
  • CNY (Yuan Chino)
Monedas Volátiles

Las siguientes monedas pueden experimentar alta volatilidad:

  • 🇦🇷 ARS (Peso Argentino)
  • 🇱🇾 LYD (Dinar Libio)
  • 🇸🇸 SSP (Libra Sudanesa del Sur)
  • 🇸🇾 SYP (Libra Siria)
  • 🇻🇪 VES (Bolívar Soberano Venezolano)
  • 🇾🇪 YER (Rial Yemení)
  • 🇿🇼 ZWL (Dólar Zimbabuense)

Servicios de IA​

Generación de Texto con Text-3B​

Genera texto utilizando un modelo de IA de 3 billones de tokens.

Endpoint​

POST /api/ai/text-3b

Ejemplo de Uso​

curl --request POST \
  --url 'https://api.speckuix.page/api/ai/text-3b' \
  --header 'Authorization: Bearer 1xxxxxx-1x-1x-1x-1x' \
  --header 'content-type: multipart/form-data' \
  --form prompt=hola

Respuesta​

La respuesta se envía en formato stream de texto. El texto se irá generando y enviando progresivamente.

Costo​

$0.015 USD por solicitud

Generación de Texto con Text-32B​

Genera texto utilizando un modelo de IA de 32 billones de tokens.

Endpoint​

POST /api/ai/text-32b

Ejemplo de Uso​

curl --request POST \
  --url 'https://api.speckuix.page/api/ai/text-32b' \
  --header 'Authorization: Bearer 1xxxxxx-1x-1x-1x-1x' \
  --header 'content-type: multipart/form-data' \
  --form prompt=hola

Respuesta​

La respuesta se envía en formato stream de texto. El texto se irá generando y enviando progresivamente.

Costo​

$0.03 USD por solicitud

Generación de Texto con Text-70B​

Genera texto utilizando un modelo de IA de 70 billones de tokens.

Endpoint​

POST /api/ai/text-70b

Ejemplo de Uso​

curl --request POST \
  --url 'https://api.speckuix.page/api/ai/text-70b' \
  --header 'Authorization: Bearer 1xxxxxx-1x-1x-1x-1x' \
  --header 'content-type: multipart/form-data' \
  --form prompt=hola

Respuesta​

La respuesta se envía en formato stream de texto. El texto se irá generando y enviando progresivamente.

Costo​

$0.05 USD por solicitud

Generación de Imágenes​

Genera imágenes utilizando IA.

Endpoint​

POST /api/ai/image

Ejemplo de Uso​

curl --request POST \
  --url 'https://api.speckuix.page/api/ai/image' \
  --header 'Authorization: Bearer 1xxxxxx-1x-1x-1x-1x' \
  --header 'content-type: multipart/form-data' \
  --form prompt='developer panda cartoon'

Respuesta​

La respuesta es un archivo de imagen en formato binario (Blob).

Costo​

$0.08 USD por solicitud

Generación de Imágenes Pixel Art​

Genera imágenes en estilo pixel art utilizando IA.

Endpoint​

POST /api/ai/pixel-image

Ejemplo de Uso​

curl --request POST \
  --url 'https://api.speckuix.page/api/ai/pixel-image' \
  --header 'Authorization: Bearer 1xxxxxx-1x-1x-1x-1x' \
  --header 'content-type: multipart/form-data' \
  --form prompt='developer panda cartoon'

Respuesta​

La respuesta es un archivo de imagen en formato binario (Blob).

Costo​

$0.06 USD por solicitud