🔑 Gestión de API Keys y Pagos

Para utilizar los endpoints de SpeckUIX, necesitarás una API Key que se obtiene después de realizar un pago. A continuación, se detalla el proceso completo.

💰 Costos por Transacción

Nota: Los precios están en USD y se descuentan automáticamente de tu saldo disponible.

Ver tabla de precios detallada

Endpoint	Costo (USD)	Descripción
/api/ip	$ 0.000014	Información de IP
/api/geo-location	$ 0.003	Datos de geolocalización
/api/weather	$ 0.0015	Información meteorológica
/api/currency-converter	$ 0.0024	Conversión de monedas
/api/ai/text-3b	$ 0.015	IA - Modelo pequeño
/api/ai/text-32b	$ 0.03	IA - Modelo mediano
/api/ai/text-70b	$ 0.05	IA - Modelo grande
/api/ai/image	$ 0.08	Generación de imágenes
/api/ai/pixel-image	$ 0.06	Imágenes estilo pixel

💳 Proceso de Pago

Rango de Pago

El monto debe estar entre $5 USD y $45 USD

Realizar Pago con Tarjeta de Crédito

Ver ejemplo de solicitud

curl --request POST \
  --url 'https://api.speckuix.page/api/pay/credit-card' \
  --header 'Authorization: Bearer 555aabbcc123' \
  --header 'content-type: multipart/form-data' \
  --form value=5 \
  --form docType=CC \
  --form docNumber=111111111 \
  --form name=John \
  --form lastName=Doe \
  --form email=johndoe@example.com \
  --form cellPhone=3111111111 \
  --form phone=6022222222 \
  --form cardNumber=4093550053561001 \
  --form cardExpYear=2025 \
  --form cardExpMonth=01 \
  --form cardCvc=123 \
  --form dues=1 \
  --form city=Ibague \
  --form 'address=Cl 123'

Parámetros del Pago

Parámetro	Tipo	Descripción	Requerido
value	number	Monto a pagar (entre $5 y $45 USD)	✅
docType	string	Tipo de documento (CC = Cédula)	✅
docNumber	string	Número de documento	✅
name	string	Nombre del titular	✅
lastName	string	Apellido del titular	✅
email	string	Correo electrónico	✅
cellPhone	string	Número de celular	✅
phone	string	Número de teléfono fijo	✅
cardNumber	string	Número de tarjeta	✅
cardExpYear	string	Año de expiración (YYYY)	✅
cardExpMonth	string	Mes de expiración (MM)	✅
cardCvc	string	Código de seguridad	✅
dues	number	Número de cuotas	✅
city	string	Ciudad	✅
address	string	Dirección	✅

🔐 Gestión de API Key

Importante

Solo puedes tener una API Key activa a la vez

Crear API Key

curl --request POST \
  --url 'https://api.speckuix.page/api/key' \
  --header 'Authorization: Bearer 555aabbcc123'

Ver respuesta

{
  "apiKey": "1xxxxxx-1x-1x-1x-1x"
}

Obtener API Key Actual

curl --request GET \
  --url 'https://api.speckuix.page/api/key' \
  --header 'Authorization: Bearer 555aabbcc123'

Eliminar API Key

curl --request DELETE \
  --url 'https://api.speckuix.page/api/key' \
  --header 'Authorization: Bearer 555aabbcc123'

⚠️ Consideraciones Importantes

• Solo puedes generar una API Key por cuenta
• La API Key estará disponible solo después de un pago exitoso
• El monto de pago debe estar entre $5 USD y $45 USD
• Cada transacción tiene un costo que se deduce de tu saldo
• Guarda tu API Key de forma segura
• El saldo no es reembolsable

🔧 Uso de la API Key

Para usar tu API Key, inclúyela en el encabezado de autorización:

Authorization: Bearer 1xxxxxx-1x-1x-1x-1x

Endpoints Disponibles

Servicios de Geolocalización y Clima

• /api/ip - Información de IP
• /api/geo-location - Geolocalización
• /api/weather - Información del clima

Servicios de IA

• /api/ai/text-3b - Generación de texto (modelo 3B)
• /api/ai/text-32b - Generación de texto (modelo 32B)
• /api/ai/text-70b - Generación de texto (modelo 70B)
• /api/ai/image - Generación de imágenes
• /api/ai/pixel-image - Generación de imágenes estilo pixel art

Ejemplo de Uso

curl --request GET \
  --url 'https://api.speckuix.page/api/weather' \
  --header 'Authorization: Bearer 1xxxxxx-1x-1x-1x-1x'