aimodelsfree 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ado
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,280 @@
+# <h1><img alt="aimodelsfree logo" src="https://cdn.skyultraplus.com/uploads/u44/9f2341d40b68a3e9.png" height="75"/></h1>
+
+# 🐢 aimodelsfree — Modelos de IA gratis
+
+[![npm version](https://badge.fury.io/js/aimodelsfree.svg)](https://www.npmjs.com/package/aimodelsfree)
+[![npm downloads](https://img.shields.io/npm/dm/aimodelsfree.svg)](https://www.npmjs.com/package/aimodelsfree)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/aimodelsfree.svg)](https://nodejs.org)
+
+> 🌱 Cliente Node.js ligero y directo para listar modelos y enviar prompts a endpoints tipo OpenAI.
+> Ideal para bots, prototipos y scripts.
+
+---
+
+> [!CAUTION]
+> **AVISO IMPORTANTE**
+>
+> aimodelsfree consume endpoints compatibles con OpenAI (por ejemplo: `/openapi/v1/chat/completions`).
+> Verifica siempre el `baseURL`, la licencia y los términos del proveedor. Úsalo responsablemente.
+
+---
+
+## 🔥 Lo que hace (en 1 línea)
+Lista modelos y envía preguntas a modelos IA de forma sencilla:
+- `GET /openapi/v1/models`
+- `POST /openapi/v1/chat/completions`
+
+---
+
+## 🧭 Por qué elegir aimodelsfree?
+- 🌿 **Ligero:** pensado para integrarse rápido en bots y proyectos Node.js.
+- 🦅 **Compatible:** payload OpenAI-like (`model`, `messages`, `max_completion_tokens`, etc.).
+- 🌱 **Cache de modelos:** reduce llamadas repetidas.
+- 🦋 **Configurable:** `apiKey`, `headers`, `timeoutMs`, `userAgent`, `referer`, etc.
+- 🐢 **Simple:** dos llamadas principales (`listModels()` y `ask()`).
+
+---
+
+## 📦 Instalación
+
+```bash
+npm install aimodelsfree
+# o
+yarn add aimodelsfree
+# o
+pnpm add aimodelsfree
+```
+
+> Requiere **Node.js >= 18**.
+
+---
+
+## ⚡ Quick Start — Rápido y bonito
+
+### ESModules (import)
+```js
+import AIModelsFree from 'aimodelsfree'
+
+const ai = new AIModelsFree({
+  baseURL: 'https://mj.gpt7.icu' // sin /openapi/v1
+})
+
+const models = await ai.listModels()
+console.log('🌿 Modelos (top 5):', models.slice(0, 5).map(m => m.id))
+
+if (!models.length) {
+  console.log('No hay modelos disponibles con ese baseURL.')
+} else {
+  const res = await ai.ask({
+    model: models[0].id,
+    question: '¡Hola! ¿Qué puedes hacer por mí hoy?',
+    maxCompletionTokens: 512
+  })
+
+  console.log('📝 Respuesta:', res.text)
+}
+```
+
+### CommonJS (require)
+```js
+const AIModelsFree = require('aimodelsfree')
+
+const ai = new AIModelsFree({ baseURL: 'https://mj.gpt7.icu' })
+
+;(async () => {
+  const models = await ai.listModels()
+  if (!models.length) return console.log('No hay modelos disponibles.')
+
+  const out = await ai.ask({
+    model: models[0].id,
+    question: '¡Hola!',
+    maxCompletionTokens: 256
+  })
+
+  console.log('🌱', out.text)
+})()
+```
+
+---
+
+## 🧩 API — Referencia rápida
+
+### `new AIModelsFree(options)`
+Crea la instancia del cliente.
+
+**Opciones**
+- `baseURL` (string) — URL base del proveedor **sin** `/openapi/v1`.  
+  Default: `https://mj.gpt7.icu`
+- `apiKey` (string) — se envía como `Authorization: Bearer <apiKey>` si se provee
+- `timeoutMs` (number) — timeout de axios en ms. Default: `60000`
+- `userAgent` (string) — default: `aimodelsfree/1.0 (+https://www.npmjs.com/package/aimodelsfree)`
+- `referer` (string) — opcional
+- `headers` (object) — headers adicionales (se mezclan con los internos)
+
+---
+
+### `await ai.listModels({ refresh, cacheTtlMs } = {})`
+Devuelve `Array<Model>`.
+
+**Parámetros**
+- `refresh` (boolean) — fuerza refrescar la lista (ignora cache). Default: `false`
+- `cacheTtlMs` (number) — TTL del cache en ms. Default: `5 * 60 * 1000` (5 min)
+
+**Retorno**
+- Array de objetos modelo (por ejemplo `{ id, object, ... }`)
+
+> Nota: el cliente normaliza payloads tipo OpenAI (`{ data: [...] }`) y también acepta arrays directos.
+
+---
+
+### `await ai.ask(params)`
+Envía una pregunta y devuelve `{ text, raw }`.
+
+**Parámetros principales**
+- `model` (string) — **obligatorio**
+- `question` (string) — **obligatorio**
+- `system` (string) — opcional (se añade como primer mensaje `role: "system"`)
+- `maxCompletionTokens` (number) — se envía como `max_completion_tokens` (default interno: `3072`)
+- `temperature` (number) — opcional (solo se envía si es number)
+- `topP` (number) — se envía como `top_p` (default: `1`)
+- `presencePenalty` (number) — `presence_penalty` (default: `0`)
+- `frequencyPenalty` (number) — `frequency_penalty` (default: `0`)
+- `stream` (boolean) — se envía al endpoint (default: `false`)
+
+**Retorno**
+- `{ text, raw }`
+  - `text` → texto extraído de `choices[0].message.content` (o `choices[0].text` si el proxy lo usa)
+  - `raw` → respuesta completa del endpoint
+
+> Nota: aunque puedes enviar `stream: true`, este cliente **no implementa streaming**; siempre devuelve la respuesta final parseada.
+
+---
+
+## 🎯 Ejemplos útiles
+
+### Comparar respuestas de 3 modelos
+```js
+const models = await ai.listModels()
+const pregunta = '¿Qué es la inteligencia artificial?'
+
+for (let i = 0; i < Math.min(3, models.length); i++) {
+  const r = await ai.ask({
+    model: models[i].id,
+    question: pregunta,
+    maxCompletionTokens: 200
+  })
+  console.log(`🌿 ${models[i].id} →`, r.text)
+}
+```
+
+### Integración rápida en un bot (handler WhatsApp)
+```js
+import AIModelsFree from 'aimodelsfree'
+const ai = new AIModelsFree({ baseURL: 'https://mj.gpt7.icu' })
+
+let handler = async (m, { conn, text, usedPrefix, command }) => {
+  const chatId = m?.chat || m?.key?.remoteJid
+  if (!chatId) return
+
+  if (command === 'aimodels') {
+    await conn.sendMessage(chatId, { react: { text: '🕒', key: m.key } })
+
+    try {
+      const models = await ai.listModels()
+      const top = models.slice(0, 30)
+
+      const msg = [
+        '「✦」Modelos disponibles (top 30):',
+        ...top.map((x, i) => `> ${i + 1}. *${x.id}*`),
+        '',
+        `> ✐ Uso » *${usedPrefix}ai <modelo>|<pregunta>*`,
+        `> ✐ Ejemplo » *${usedPrefix}ai gpt-4o-mini|Hola*`
+      ].join('\n')
+
+      await conn.sendMessage(chatId, { text: msg }, { quoted: m })
+      await conn.sendMessage(chatId, { react: { text: '✔️', key: m.key } })
+    } catch (e) {
+      await conn.sendMessage(chatId, { text: `「✦」Error listando modelos.\n> ${String(e?.message || e)}` }, { quoted: m })
+    }
+    return
+  }
+
+  if (!text || !text.includes('|')) {
+    return conn.sendMessage(
+      chatId,
+      { text: `「✦」Formato: *${usedPrefix + command} <modelo>|<pregunta>*\n> ✐ Ejemplo » *${usedPrefix + command} gpt-4o-mini|Hola*` },
+      { quoted: m }
+    )
+  }
+
+  const [model, ...rest] = text.split('|')
+  const question = rest.join('|').trim()
+
+  await conn.sendMessage(chatId, { react: { text: '🕒', key: m.key } })
+
+  try {
+    const out = await ai.ask({
+      model: model.trim(),
+      question,
+      maxCompletionTokens: 1024
+    })
+
+    await conn.sendMessage(
+      chatId,
+      { text: `「✦」*Modelo:* ${model.trim()}\n\n${out.text || 'Sin respuesta.'}` },
+      { quoted: m }
+    )
+    await conn.sendMessage(chatId, { react: { text: '✔️', key: m.key } })
+  } catch (e) {
+    await conn.sendMessage(chatId, { text: `「✦」Error consultando IA.\n> ${String(e?.message || e)}` }, { quoted: m })
+  }
+}
+
+handler.help = ['aimodels', 'ai <modelo>|<pregunta>']
+handler.tags = ['ai']
+handler.command = ['aimodels', 'ai']
+
+export default handler
+```
+
+---
+
+## 🛠️ Troubleshooting — Soluciones rápidas
+
+- **ETIMEDOUT** — aumenta `timeoutMs`:
+```js
+new AIModelsFree({ baseURL: 'https://mj.gpt7.icu', timeoutMs: 180000 })
+```
+
+- **401 Unauthorized** — revisa `apiKey`.
+
+- **No models available** — revisa `baseURL` y prueba refrescar:
+```js
+await ai.listModels({ refresh: true })
+```
+
+---
+
+## ⚖️ Disclaimer
+> Este proyecto no está afiliado ni es oficial de ningún proveedor de IA. Usa los endpoints respetando los términos del servicio del proveedor. El autor no se hace responsable por el uso indebido.
+
+---
+
+## 🧾 Licencia
+MIT © 2025 Ado — consulta el archivo [LICENSE](LICENSE).
+
+---
+
+## 👨‍💻 Autor
+
+<p>
+  <img src="https://github.com/Ado21.png" alt="Ado21" width="80" height="80" style="border-radius:50%;vertical-align:middle;margin-right:10px" />
+  <strong></strong><br/>
+  🐣 <a href="https://github.com/Ado21">Ado21</a> · 📦 <a href="https://www.npmjs.com/package/aimodelsfree">NPM</a>
+</p>
+
+---
+
+## 🌾 Changelog (rápido)
+- **1.1.0** — Versión inicial (2025-12-30)

package/README.md.bak

@@ -0,0 +1,280 @@
+# <h1><img alt="aimodelsfree logo" src="https://cdn.skyultraplus.com/uploads/u44/9f2341d40b68a3e9.png" height="75"/></h1>
+
+# 🐢 aimodelsfree — Modelos de IA gratis
+
+[![npm version](https://badge.fury.io/js/aimodelsfree.svg)](https://www.npmjs.com/package/aimodelsfree)
+[![npm downloads](https://img.shields.io/npm/dm/aimodelsfree.svg)](https://www.npmjs.com/package/aimodelsfree)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/aimodelsfree.svg)](https://nodejs.org)
+
+> 🌱 Cliente Node.js ligero y directo para listar modelos y enviar prompts a endpoints tipo OpenAI.
+> Ideal para bots, prototipos y scripts.
+
+---
+
+> [!CAUTION]
+> **AVISO IMPORTANTE**
+>
+> aimodelsfree consume endpoints compatibles con OpenAI (por ejemplo: `/openapi/v1/chat/completions`).
+> Verifica siempre el `baseURL`, la licencia y los términos del proveedor. Úsalo responsablemente.
+
+---
+
+## 🔥 Lo que hace (en 1 línea)
+Lista modelos y envía preguntas a modelos IA de forma sencilla:
+- `GET /openapi/v1/models`
+- `POST /openapi/v1/chat/completions`
+
+---
+
+## 🧭 Por qué elegir aimodelsfree?
+- 🌿 **Ligero:** pensado para integrarse rápido en bots y proyectos Node.js.
+- 🦅 **Compatible:** payload OpenAI-like (`model`, `messages`, `max_completion_tokens`, etc.).
+- 🌱 **Cache de modelos:** reduce llamadas repetidas.
+- 🦋 **Configurable:** `apiKey`, `headers`, `timeoutMs`, `userAgent`, `referer`, etc.
+- 🐢 **Simple:** dos llamadas principales (`listModels()` y `ask()`).
+
+---
+
+## 📦 Instalación
+
+```bash
+npm install aimodelsfree
+# o
+yarn add aimodelsfree
+# o
+pnpm add aimodelsfree
+```
+
+> Requiere **Node.js >= 18**.
+
+---
+
+## ⚡ Quick Start — Rápido y bonito
+
+### ESModules (import)
+```js
+import AIModelsFree from 'aimodelsfree'
+
+const ai = new AIModelsFree({
+  baseURL: 'https://mj.gpt7.icu' // sin /openapi/v1
+})
+
+const models = await ai.listModels()
+console.log('🌿 Modelos (top 5):', models.slice(0, 5).map(m => m.id))
+
+if (!models.length) {
+  console.log('No hay modelos disponibles con ese baseURL.')
+} else {
+  const res = await ai.ask({
+    model: models[0].id,
+    question: '¡Hola! ¿Qué puedes hacer por mí hoy?',
+    maxCompletionTokens: 512
+  })
+
+  console.log('📝 Respuesta:', res.text)
+}
+```
+
+### CommonJS (require)
+```js
+const AIModelsFree = require('aimodelsfree')
+
+const ai = new AIModelsFree({ baseURL: 'https://mj.gpt7.icu' })
+
+;(async () => {
+  const models = await ai.listModels()
+  if (!models.length) return console.log('No hay modelos disponibles.')
+
+  const out = await ai.ask({
+    model: models[0].id,
+    question: '¡Hola!',
+    maxCompletionTokens: 256
+  })
+
+  console.log('🌱', out.text)
+})()
+```
+
+---
+
+## 🧩 API — Referencia rápida
+
+### `new AIModelsFree(options)`
+Crea la instancia del cliente.
+
+**Opciones**
+- `baseURL` (string) — URL base del proveedor **sin** `/openapi/v1`.  
+  Default: `https://mj.gpt7.icu`
+- `apiKey` (string) — se envía como `Authorization: Bearer <apiKey>` si se provee
+- `timeoutMs` (number) — timeout de axios en ms. Default: `60000`
+- `userAgent` (string) — default: `aimodelsfree/1.0 (+https://www.npmjs.com/package/aimodelsfree)`
+- `referer` (string) — opcional
+- `headers` (object) — headers adicionales (se mezclan con los internos)
+
+---
+
+### `await ai.listModels({ refresh, cacheTtlMs } = {})`
+Devuelve `Array<Model>`.
+
+**Parámetros**
+- `refresh` (boolean) — fuerza refrescar la lista (ignora cache). Default: `false`
+- `cacheTtlMs` (number) — TTL del cache en ms. Default: `5 * 60 * 1000` (5 min)
+
+**Retorno**
+- Array de objetos modelo (por ejemplo `{ id, object, ... }`)
+
+> Nota: el cliente normaliza payloads tipo OpenAI (`{ data: [...] }`) y también acepta arrays directos.
+
+---
+
+### `await ai.ask(params)`
+Envía una pregunta y devuelve `{ text, raw }`.
+
+**Parámetros principales**
+- `model` (string) — **obligatorio**
+- `question` (string) — **obligatorio**
+- `system` (string) — opcional (se añade como primer mensaje `role: "system"`)
+- `maxCompletionTokens` (number) — se envía como `max_completion_tokens` (default interno: `3072`)
+- `temperature` (number) — opcional (solo se envía si es number)
+- `topP` (number) — se envía como `top_p` (default: `1`)
+- `presencePenalty` (number) — `presence_penalty` (default: `0`)
+- `frequencyPenalty` (number) — `frequency_penalty` (default: `0`)
+- `stream` (boolean) — se envía al endpoint (default: `false`)
+
+**Retorno**
+- `{ text, raw }`
+  - `text` → texto extraído de `choices[0].message.content` (o `choices[0].text` si el proxy lo usa)
+  - `raw` → respuesta completa del endpoint
+
+> Nota: aunque puedes enviar `stream: true`, este cliente **no implementa streaming**; siempre devuelve la respuesta final parseada.
+
+---
+
+## 🎯 Ejemplos útiles
+
+### Comparar respuestas de 3 modelos
+```js
+const models = await ai.listModels()
+const pregunta = '¿Qué es la inteligencia artificial?'
+
+for (let i = 0; i < Math.min(3, models.length); i++) {
+  const r = await ai.ask({
+    model: models[i].id,
+    question: pregunta,
+    maxCompletionTokens: 200
+  })
+  console.log(`🌿 ${models[i].id} →`, r.text)
+}
+```
+
+### Integración rápida en un bot (handler WhatsApp)
+```js
+import AIModelsFree from 'aimodelsfree'
+const ai = new AIModelsFree({ baseURL: 'https://mj.gpt7.icu' })
+
+let handler = async (m, { conn, text, usedPrefix, command }) => {
+  const chatId = m?.chat || m?.key?.remoteJid
+  if (!chatId) return
+
+  if (command === 'aimodels') {
+    await conn.sendMessage(chatId, { react: { text: '🕒', key: m.key } })
+
+    try {
+      const models = await ai.listModels()
+      const top = models.slice(0, 30)
+
+      const msg = [
+        '「✦」Modelos disponibles (top 30):',
+        ...top.map((x, i) => `> ${i + 1}. *${x.id}*`),
+        '',
+        `> ✐ Uso » *${usedPrefix}ai <modelo>|<pregunta>*`,
+        `> ✐ Ejemplo » *${usedPrefix}ai gpt-4o-mini|Hola*`
+      ].join('\n')
+
+      await conn.sendMessage(chatId, { text: msg }, { quoted: m })
+      await conn.sendMessage(chatId, { react: { text: '✔️', key: m.key } })
+    } catch (e) {
+      await conn.sendMessage(chatId, { text: `「✦」Error listando modelos.\n> ${String(e?.message || e)}` }, { quoted: m })
+    }
+    return
+  }
+
+  if (!text || !text.includes('|')) {
+    return conn.sendMessage(
+      chatId,
+      { text: `「✦」Formato: *${usedPrefix + command} <modelo>|<pregunta>*\n> ✐ Ejemplo » *${usedPrefix + command} gpt-4o-mini|Hola*` },
+      { quoted: m }
+    )
+  }
+
+  const [model, ...rest] = text.split('|')
+  const question = rest.join('|').trim()
+
+  await conn.sendMessage(chatId, { react: { text: '🕒', key: m.key } })
+
+  try {
+    const out = await ai.ask({
+      model: model.trim(),
+      question,
+      maxCompletionTokens: 1024
+    })
+
+    await conn.sendMessage(
+      chatId,
+      { text: `「✦」*Modelo:* ${model.trim()}\n\n${out.text || 'Sin respuesta.'}` },
+      { quoted: m }
+    )
+    await conn.sendMessage(chatId, { react: { text: '✔️', key: m.key } })
+  } catch (e) {
+    await conn.sendMessage(chatId, { text: `「✦」Error consultando IA.\n> ${String(e?.message || e)}` }, { quoted: m })
+  }
+}
+
+handler.help = ['aimodels', 'ai <modelo>|<pregunta>']
+handler.tags = ['ai']
+handler.command = ['aimodels', 'ai']
+
+export default handler
+```
+
+---
+
+## 🛠️ Troubleshooting — Soluciones rápidas
+
+- **ETIMEDOUT** — aumenta `timeoutMs`:
+```js
+new AIModelsFree({ baseURL: 'https://mj.gpt7.icu', timeoutMs: 180000 })
+```
+
+- **401 Unauthorized** — revisa `apiKey`.
+
+- **No models available** — revisa `baseURL` y prueba refrescar:
+```js
+await ai.listModels({ refresh: true })
+```
+
+---
+
+## ⚖️ Disclaimer
+> Este proyecto no está afiliado ni es oficial de ningún proveedor de IA. Usa los endpoints respetando los términos del servicio del proveedor. El autor no se hace responsable por el uso indebido.
+
+---
+
+## 🧾 Licencia
+MIT © 2025 Ado — consulta el archivo [LICENSE](LICENSE).
+
+---
+
+## 👨‍💻 Autor
+
+<p>
+  <img src="https://github.com/Ado21.png" alt="Ado21" width="80" height="80" style="border-radius:50%;vertical-align:middle;margin-right:10px" />
+  <strong></strong><br/>
+  🐣 <a href="https://github.com/Ado21">Ado21</a> · 📦 <a href="https://www.npmjs.com/package/aimodelsfree">NPM</a>
+</p>
+
+---
+
+## 🧾 Changelog (rápido)
+- **1.0.0** — Versión inicial (2025-12-30)

package/dist/index.cjs

@@ -0,0 +1,132 @@
+const axios = require('axios')
+
+function defaultHeaders(opts) {
+  opts = opts || {}
+  const h = { 'Content-Type': 'application/json' }
+  if (opts.userAgent) h['User-Agent'] = opts.userAgent
+  if (opts.referer) h['Referer'] = opts.referer
+  if (opts.apiKey) {
+    h['Authorization'] = String(opts.apiKey).startsWith('Bearer ') ? String(opts.apiKey) : ('Bearer ' + String(opts.apiKey))
+  }
+  if (opts.extraHeaders && typeof opts.extraHeaders === 'object') {
+    for (const k of Object.keys(opts.extraHeaders)) {
+      const v = opts.extraHeaders[k]
+      if (v != null) h[k] = String(v)
+    }
+  }
+  return h
+}
+
+function normalizeModelsPayload(payload) {
+  if (payload && Array.isArray(payload.data)) return payload.data
+  if (Array.isArray(payload)) return payload
+  if (payload && Array.isArray(payload.models)) return payload.models
+  return []
+}
+
+function extractChatText(data) {
+  const content = data && data.choices && data.choices[0] && data.choices[0].message && data.choices[0].message.content
+  if (typeof content === 'string') return content
+  const text = data && data.choices && data.choices[0] && data.choices[0].text
+  if (typeof text === 'string') return text
+  return ''
+}
+
+function safeJson(v) {
+  try { return JSON.stringify(v) } catch (e) { return String(v) }
+}
+
+class AIModelsFree {
+  constructor(opts) {
+    opts = opts || {}
+    const baseURL = (opts.baseURL || 'https://mj.gpt7.icu').toString().replace(/\/+$/, '')
+    this.baseURL = baseURL
+    this.apiKey = opts.apiKey
+    this.timeoutMs = opts.timeoutMs == null ? 60000 : opts.timeoutMs
+    this.userAgent = opts.userAgent || 'aimodelsfree/1.0 (+https://www.npmjs.com/package/aimodelsfree)'
+    this.referer = opts.referer
+    this.headers = opts.headers
+
+    this.http = axios.create({
+      baseURL: this.baseURL,
+      timeout: this.timeoutMs,
+      validateStatus: (s) => s >= 200 && s < 500
+    })
+
+    this._modelsCache = null
+    this._modelsCacheAt = 0
+  }
+
+  async listModels(opts) {
+    opts = opts || {}
+    const refresh = !!opts.refresh
+    const cacheTtlMs = opts.cacheTtlMs == null ? (5 * 60 * 1000) : opts.cacheTtlMs
+    const now = Date.now()
+
+    if (!refresh && this._modelsCache && (now - this._modelsCacheAt) < cacheTtlMs) {
+      return this._modelsCache
+    }
+
+    const res = await this.http.get('/openapi/v1/models', {
+      headers: defaultHeaders({
+        userAgent: this.userAgent,
+        referer: this.referer,
+        apiKey: this.apiKey,
+        extraHeaders: this.headers
+      })
+    })
+
+    if (res.status >= 400) {
+      throw new Error('aimodelsfree: /models HTTP ' + res.status + ': ' + safeJson(res.data))
+    }
+
+    const models = normalizeModelsPayload(res.data)
+    this._modelsCache = models
+    this._modelsCacheAt = now
+    return models
+  }
+
+  async ask(params) {
+    params = params || {}
+    const model = params.model
+    const question = params.question
+
+    if (!model) throw new Error('aimodelsfree: falta params.model')
+    if (!question) throw new Error('aimodelsfree: falta params.question')
+
+    const messages = []
+    if (params.system) messages.push({ role: 'system', content: String(params.system) })
+    messages.push({ role: 'user', content: String(question) })
+
+    const payload = {
+      model: String(model),
+      messages,
+      max_completion_tokens: params.maxCompletionTokens == null ? 3072 : params.maxCompletionTokens,
+      top_p: params.topP == null ? 1 : params.topP,
+      presence_penalty: params.presencePenalty == null ? 0 : params.presencePenalty,
+      frequency_penalty: params.frequencyPenalty == null ? 0 : params.frequencyPenalty,
+      stream: !!params.stream
+    }
+
+    if (typeof params.temperature === 'number') payload.temperature = params.temperature
+
+    const res = await this.http.post('/openapi/v1/chat/completions', payload, {
+      headers: defaultHeaders({
+        userAgent: this.userAgent,
+        referer: this.referer,
+        apiKey: this.apiKey,
+        extraHeaders: this.headers
+      })
+    })
+
+    if (res.status >= 400) {
+      throw new Error('aimodelsfree: /chat/completions HTTP ' + res.status + ': ' + safeJson(res.data))
+    }
+
+    const text = extractChatText(res.data)
+    return { text, raw: res.data }
+  }
+}
+
+module.exports = AIModelsFree
+module.exports.AIModelsFree = AIModelsFree

package/dist/index.js

@@ -0,0 +1,150 @@
+import axios from 'axios'
+
+function defaultHeaders({ userAgent, referer, apiKey, extraHeaders } = {}) {
+  const h = {
+    'Content-Type': 'application/json'
+  }
+  if (userAgent) h['User-Agent'] = userAgent
+  if (referer) h['Referer'] = referer
+  if (apiKey) h['Authorization'] = apiKey.startsWith('Bearer ') ? apiKey : `Bearer ${apiKey}`
+  if (extraHeaders && typeof extraHeaders === 'object') {
+    for (const [k, v] of Object.entries(extraHeaders)) {
+      if (v != null) h[k] = String(v)
+    }
+  }
+  return h
+}
+
+function normalizeModelsPayload(payload) {
+
+  if (payload && Array.isArray(payload.data)) return payload.data
+  if (Array.isArray(payload)) return payload
+  if (payload && Array.isArray(payload.models)) return payload.models
+  return []
+}
+
+function extractChatText(data) {
+  
+  const content = data?.choices?.[0]?.message?.content
+  if (typeof content === 'string') return content
+ 
+  const text = data?.choices?.[0]?.text
+  if (typeof text === 'string') return text
+  return ''
+}
+
+export class AIModelsFree {
+ 
+  constructor(opts = {}) {
+    const {
+      baseURL = 'https://mj.gpt7.icu',
+      apiKey,
+      timeoutMs = 60_000,
+      userAgent = 'aimodelsfree/1.0 (+https://www.npmjs.com/package/aimodelsfree)',
+      referer,
+      headers
+    } = opts
+
+    this.baseURL = String(baseURL || '').replace(/\/+$/, '')
+    this.apiKey = apiKey
+    this.timeoutMs = timeoutMs
+    this.userAgent = userAgent
+    this.referer = referer
+    this.headers = headers
+
+    this.http = axios.create({
+      baseURL: this.baseURL,
+      timeout: this.timeoutMs,
+      validateStatus: (s) => s >= 200 && s < 500
+    })
+
+    this._modelsCache = null
+    this._modelsCacheAt = 0
+  }
+
+  async listModels(opts = {}) {
+    const { refresh = false, cacheTtlMs = 5 * 60 * 1000 } = opts
+    const now = Date.now()
+
+    if (!refresh && this._modelsCache && now - this._modelsCacheAt < cacheTtlMs) {
+      return this._modelsCache
+    }
+
+    const res = await this.http.get('/openapi/v1/models', {
+      headers: defaultHeaders({
+        userAgent: this.userAgent,
+        referer: this.referer,
+        apiKey: this.apiKey,
+        extraHeaders: this.headers
+      })
+    })
+
+    if (res.status >= 400) {
+      throw new Error(`aimodelsfree: /models HTTP ${res.status}: ${safeJson(res.data)}`)
+    }
+
+    const models = normalizeModelsPayload(res.data)
+    this._modelsCache = models
+    this._modelsCacheAt = now
+    return models
+  }
+
+  async ask(params = {}) {
+    const {
+      model,
+      question,
+      system,
+      maxCompletionTokens = 3072,
+      temperature,
+      topP = 1,
+      presencePenalty = 0,
+      frequencyPenalty = 0,
+      stream = false
+    } = params
+
+    if (!model) throw new Error('aimodelsfree: falta params.model')
+    if (!question) throw new Error('aimodelsfree: falta params.question')
+
+    const messages = []
+    if (system) messages.push({ role: 'system', content: String(system) })
+    messages.push({ role: 'user', content: String(question) })
+
+    const payload = {
+      model: String(model),
+      messages,
+      max_completion_tokens: maxCompletionTokens,
+      top_p: topP,
+      presence_penalty: presencePenalty,
+      frequency_penalty: frequencyPenalty,
+      stream
+    }
+
+    if (typeof temperature === 'number') payload.temperature = temperature
+
+    const res = await this.http.post('/openapi/v1/chat/completions', payload, {
+      headers: defaultHeaders({
+        userAgent: this.userAgent,
+        referer: this.referer,
+        apiKey: this.apiKey,
+        extraHeaders: this.headers
+      })
+    })
+
+    if (res.status >= 400) {
+      throw new Error(`aimodelsfree: /chat/completions HTTP ${res.status}: ${safeJson(res.data)}`)
+    }
+
+    const text = extractChatText(res.data)
+    return { text, raw: res.data }
+  }
+}
+
+export default AIModelsFree
+
+function safeJson(v) {
+  try {
+    return JSON.stringify(v)
+  } catch {
+    return String(v)
+  }
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "aimodelsfree",
+  "version": "1.1.0",
+  "description": "Cliente ligero para listar modelos y chatear usando un endpoint OpenAI-compatible (/openapi/v1).",
+  "keywords": ["ai", "models", "openaifree", "chat", "client"],
+  "license": "MIT",
+  "author": "Ado",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node ./examples/esm-example.js"
+  },
+  "dependencies": {
+    "axios": "^1.6.8"
+  }
+}