FTIR.funFTIR.fun
Integración de desarrollador e IA

Conecta FTIR.fun con cualquier herramienta o aplicación de IA

Proporciona a tu asistente de IA o a tu propio código acceso directo a 320,000+ espectros de referencia, razonamiento de picos basado en grafos de conocimiento e interpretación respaldada por la literatura. Elige una de las tres formas de conexión: MCP para asistentes de IA, la API REST para código o una Skill lista para usar en plataformas sin código. Cada opción incluye instrucciones paso a paso escritas para usuarios principiantes.

1. Elija su ruta 2. Configuración de MCP 3. API REST 4. Habilidades y complementos 5. Qué puede hacer su IA 6. Solución de problemas
Listado en

Antes de comenzar, obtenga su clave API

MCP y la API REST utilizan la misma clave de API de FTIR.fun. Coze/Doubao utiliza una clave de servicio configurada por el editor del complemento, por lo que los usuarios finales trabajan a través del complemento sin pegar una clave personal. Obtener una clave personal lleva aproximadamente un minuto:

  1. Iniciar sesión en FTIR.fun Crea una cuenta gratuita (las cuentas nuevas incluyen créditos de prueba gratuitos).
  2. Abra el panel de claves API Ir a Cuenta → Claves API y haga clic en Generar.
  3. Ver o copiar tu clave de API La clave completa (empieza con ftir_) sigue disponible en el panel de Claves de API. Puede volver allí para verla, copiarla o revocarla.
🔑 ¿Listo? Abra el panel de Claves API en una nueva pestaña, luego regrese y siga la ruta que eligió anteriormente.

Paso 1 — ¿Qué conexión es la adecuada para usted?

Los tres se conectan al mismo motor: 320,000+ espectros, razonamiento basado en grafos de conocimiento y citas bibliográficas. Solo necesitas uno. Elige la vía que se ajuste a tu forma de trabajar; MCP es una opción cómoda para los usuarios de asistentes de IA.

Lo que tu IA realmente puede hacer

Los servicios unificados de MCP y REST exponen el mismo catálogo de operaciones de FTIR.fun. Las claves de API pueden recibir un alcance de capacidades más reducido, mientras que las declaraciones específicas de la plataforma pueden publicar intencionadamente solo un subconjunto. Las operaciones siguientes comparten los mismos servicios de FTIR.fun.

Tarea Herramienta MCP Punto final REST Dile esto a tu IA
Leer un archivo de instrumento parse_ftir_spectrum POST /parse-spectrum Analice sample.spc y enumere los picos detectados.
Convertir datos nativos y preservar metadatos convert_native_spectrum POST /native-spectrum/convert Convierte sample.spa a JDX y conserva los metadatos de origen.
Identificar un espectro desconocido analyze_ftir_spectrum POST /ftir/analyze_spectrum Identifique qué polímero es este espectro.
Envía un informe completo de tres ejes submit_ftir_report POST /ftir/reports Envía sample.spa para un informe completo en modo ATR.
Consulta y recupera ese informe. get_ftir_report_status GET /ftir/reports/{task_id} Verifique la tarea del informe y deme el enlace cuando termine.
Explicar picos explain_peaks POST /ftir/explain_peak_assignments ¿Qué indican los picos a 1715 y 1450 cm-1?
Encuentra un espectro de referencia conocido find_spectra POST /ftir/find_spectra Encuentre espectros de referencia para poliestireno.
Vuelva a abrir un resultado anterior fetch_result GET /ftir/result/{result_num} Obtén el resultado 20260528100755416137536.
🎓 Asignación de picos académica — Para muestras con una composición conocida, la capacidad avanzada REST/MCP de FTIR.fun asigna cada pico medido con evidencia rastreada en la literatura. Cada envío cuesta 30 puntos o es gratuito con una suscripción activa; las consultas de estado no tienen costo. Describa la tarea de forma natural (por ejemplo: ＂Asigne todos los picos FTIR medidos para este espectro; la muestra es PMMA conocido; envíeme el informe por correo electrónico＂) — el cliente proporciona el archivo y usted nunca necesita construir JSON o Base64 usted mismo. Los resultados completados devuelven tanto el estado JSON como las direcciones de informe protegidas; los informes no se exponen en una ruta de descarga pública.

Extensiones de nombre de archivo de espectro admitidas (36): .spa, .spc, .sp, .abs, .irf, .irs, .dt, .jws, .jdx, .dx, .asc, .dpt, .opju, .opus, .ispd, .[0-9]+, .xlsx, .xls, .ods, .csv, .dat, .txt, .tsv, .json, .tab, .a2r, .asp, .spe, .map, .bsp, .spg, .srs, .smf, .ird, .fsm, .mat. Mantenga la extensión de nombre de archivo original. Los archivos no admitidos o ilegibles devuelven supported_extensions y supported_formats. Los valores válidos de sampling_mode son Pastilla de KBr, Vapor, Disolvente, Película delgada, Mull de parafina, ATR, Reflectancia difusa, Micro IR y Otros. Transmisión no es un valor válido.

ejemplo de respuesta de find_spectra

respuesta de find_spectra 
{
  "success": true,
  "query": "polystyrene",
  "match_mode": "synonym",
  "match_count": 3,
  "summary": "Found 3 reference spectrum candidates for 'polystyrene'.",
  "results": [
    {"num": 555, "spectrum_number": 555, "name": "PS/PPO",
     "cas": "-", "source_type": "instrument_import",
     "peaks": [697, 756, 1028, ...], "x": [...], "y": [...]}
  ]
}

ejemplo de respuesta de explain_peaks

Respuesta de explain_peaks 
{
  "success": true,
  "search_mode": "peak_explanation",
  "peak_explanations": [
    {"peaks_cm1": [1715, 1450],
     "assignment": "1715 cm-1 suggests C=O stretching (ester or carboxylic acid)...",
     "evidence_type": "llm_general_knowledge"}
  ],
  "summary": "Peak explanation based on general FTIR knowledge..."
}

Obtener el informe completo (asíncrono)

El análisis rápido (analyze_spectrum) devuelve el resultado inmediatamente. El informe completo de tres ejes se ejecuta en segundo plano y normalmente tarda entre 30 y 90 segundos. Conserva el task_id y consulta su estado en lugar de volver a enviarlo.

  1. Enviar Llame a submit_ftir_report (MCP) o POST /ftir/reports (REST). Obtendrá un task_id y un result_num reservado. El campo file_base64 es obligatorio; otros campos (sampling_mode, prior_context, language_code, sample_name, sample_order_no) son opcionales.
    Ejemplo de envío (REST) 
    curl -X POST https://ftir.fun/ftir/reports \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_base64": "V2F2ZW51bWJlci...", "filename": "sample.spa", "sampling_mode": "ATR", "language_code": "en"}'
    Enviar respuesta 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Encuesta Llame a get_ftir_report_status (MCP) o a GET /ftir/reports/{task_id} cada 5–10 segundos hasta que completed sea true. La respuesta completada incluye report_url, un objeto report (contenido de resultado estructurado, con el detallado report_view dentro) y result_num.
    Ejemplo de consulta 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Respuesta de consulta (en curso) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Respuesta de sondeo (completado) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Abra el informe final Abra la URL completa https://ftir.fun/outputdata/?num={result_num} en un navegador para ver la página completa de resultados tri-axiales renderizada por FTIR.fun.
⚠️ Conserve el task_id y consulte periódicamente hasta que se complete o falle. Las solicitudes duplicadas mientras están en cola o en ejecución desperdician puntos.

Solución de problemas

Lo que ves Qué significa Qué hacer
El cliente abre una página de autorización del navegador, o dice que la página de autorización no existe. Tu cliente está usando una entrada de servidor antigua de estilo OAuth. FTIR.fun no utiliza OAuth, solo una clave API. Eliminar la entrada antigua del servidor ftirfun, pegar la configuración exacta de esta página, recargar el cliente e iniciar ftirfun de nuevo.
401 (MCP) / 401 invalid_api_key (REST) La clave API falta, ha expirado, ha sido revocada o se pegó incorrectamente. Reinicie el servidor y pegue solo la clave sin procesar (comienza con ftir_). Genere una nueva clave desde el Panel de Claves API si es necesario.
El servidor se inicia pero no aparecen herramientas. El cliente no ha actualizado su catálogo, o la configuración usa el nombre de clave incorrecto. Para VS Code, confirma que mcp.json usa servers (no mcpServers). Luego detén y reinicia ftirfun, o recarga la ventana.
403 insufficient_balance La cuenta no tiene suficientes puntos para ese análisis. Verifica tu saldo o suscripción en FTIR.fun, luego vuelve a intentarlo.
429 rate_limit_exceeded El análisis y análisis REST permiten 60 solicitudes por minuto por clave API; las lecturas de resultados REST y report-status utilizan un bucket separado de 120 solicitudes por minuto; MCP permite 60 llamadas por minuto para cada clave API y herramienta. Espere el período de reintento informado por la herramienta antes de llamar nuevamente.
Un informe permanece en cola o en ejecución. Los informes completos se ejecutan de forma asíncrona y toman más tiempo que la revisión rápida. Mantén el mismo task_id y consulta su estado. Si has perdido el task_id, llama a GET /ftir/tasks para enumerar tus tareas recientes y encontrarlo de nuevo.
422 o missing_input El cuerpo de la solicitud carece de campos obligatorios o tiene un formato no válido. Para analyze_spectrum, debe proporcionar al menos uno de: peaks, query o file_base64. Verifique que su JSON sea válido, Content-Type sea application/json y los campos obligatorios estén presentes. Consulte los ejemplos de solicitudes anteriores.
413 file_too_large El archivo de espectro subido excede el límite de tamaño. Exporte un archivo más pequeño o use solo las posiciones de los picos a través del campo spectrum.peaks.

¿Listo para construir?

La referencia completa de REST incluye todos los endpoints, formatos de solicitud y respuesta, autenticación, límites de velocidad, códigos de error, definiciones de herramientas MCP y ejemplos de código en Python y curl.

Enviar Requisito Formulario