API pública
API de figuras científicas
Genera y edita ilustraciones científicas, crea gráficos a partir de tus datos y dibuja diagramas de flujo mediante HTTP, con los mismos motores que el sitio web de SciFig.
Los mismos créditos que en el sitio web: cómpralos una vez en la página de precios y úsalos donde quieras.
curl -X POST https://scifig.ai/api/v1/images/generations \
-H "Authorization: Bearer $SCIFIG_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Prefer: wait=25" \
-H "Content-Type: application/json" \
-d '{"prompt": "Mitochondrial electron transport chain, labelled", "aspect_ratio": "4:3"}'Obtener acceso
- 1
Iniciar sesión
Usa tu cuenta de SciFig. Las claves de solo lectura funcionan con cualquier cuenta; las claves que crean figuras requieren una suscripción activa o un saldo positivo de créditos adquiridos en paquetes.
- 2
Crear una clave
En Ajustes → Desarrollador, elige solo lectura o lectura y generación, además de una fecha de caducidad. La clave solo se muestra una vez.
- 3
Llamar y esperar
Envía una solicitud con un Idempotency-Key y
Prefer: wait=25; después descarga los resultados o consulta la tarea hasta que termine.
Qué hace la API
Generación de imágenes
POST /images/generations
Ilustraciones científicas a partir de una descripción, con estilos, paletas y hasta tres imágenes de referencia.
Edición de imágenes
POST /images/edits
Edita mediante instrucciones o una región enmascarada: fondo blanco, otra relación de aspecto, cambio de colores o sustitución del texto en su posición.
Ampliaciones
POST /images/upscales
Amplía a 2K, 4K u 8K para imprimir.
Conversiones
POST /images/conversions
SVG editable mediante vectorización; PNG, PDF, TIFF y PPTX a 300–1000 DPI, incluidos los diagramas de flujo.
Gráficos
POST /charts/generations
Gráficos listos para publicar a partir de CSV o Excel, con estilos de revistas científicas y ediciones posteriores.
Diagramas de flujo
POST /flowcharts/generations
Diagramas CONSORT, flujos de trabajo y secuencias de procesamiento en SVG editable, con ediciones posteriores.
Archivos
POST /files · GET /files/{id}
Sube imágenes, máscaras y archivos adjuntos; descarga cada resultado con un enlace firmado.
Tareas y créditos
GET /jobs/{id} · GET /credits
Estado, resultados y cantidades exactas de créditos reservados, cobrados y devueltos.
¿Trabajas desde un asistente de IA?
Conecta Claude, ChatGPT, Claude Code, Codex o Cursor al servidor MCP de SciFig. Claude, ChatGPT, Claude Code y Codex inician sesión con tu cuenta de SciFig; Cursor usa una clave API.
Cuánto cuesta cada llamada
| Operation | Credits |
|---|---|
| Generación de imagen | 50 / 75 / 100 (standard / advanced / premium) |
| Edición de imagen | 50 / 75 / 100; región o texto 100 |
| Detección de texto | Gratis |
| Ampliación | 50 / 100 / 150 (2K / 4K / 8K) |
| Conversión | SVG 150; PNG, PDF, TIFF y PPTX gratis |
| Crear o editar un gráfico | 100 |
| Crear o editar un diagrama de flujo | 100 |
| Consultar tareas, archivos, créditos y precios | Gratis |
Los créditos se reservan al empezar una tarea, se cobran una sola vez si se completa y se devuelven íntegramente si falla. Todos los precios.
Límites
20
solicitudes de creación por minuto y clave
40
solicitudes de creación por minuto y cuenta
120
solicitudes de lectura por minuto y clave
30 s
espera máxima por solicitud
200
conversiones ráster gratuitas por día
Las tareas simultáneas y por hora dependen de tu plan y se comparten con el sitio web. Una respuesta 429 incluye Retry-After: espera y vuelve a intentarlo con el mismo Idempotency-Key.
Preguntas
¿Necesito un plan de pago?+
Las claves de solo lectura funcionan con cualquier cuenta. Las claves que crean figuras requieren una suscripción activa o un saldo positivo de créditos adquiridos en paquetes, porque cada creación consume créditos.
¿Los créditos de la API son distintos de los del sitio web?+
No. El sitio web, la API y el servidor MCP comparten un saldo y una lista de precios.
¿Qué ocurre si una tarea falla?+
Se devuelve íntegramente la reserva. Una ilustración que haya superado el tiempo límite puede entregarse gratis durante las 24 horas siguientes; la tarea indica hasta cuándo.
¿Mis resultados aparecen en el sitio web?+
Sí. Los gráficos y diagramas de flujo aparecen como conversaciones en sus espacios de trabajo, donde puedes seguir editándolos. Sus resultados incluyen una editor_url que los abre allí. Los enlaces de descarga de las respuestas API duran una hora; consulta la tarea de nuevo para obtener otro.
¿Hay un modo de prueba?+
No. Las llamadas de solo lectura y las conversiones a PNG, PDF, TIFF y PPTX son gratuitas, así que puedes preparar gran parte de una integración sin gastar créditos.
¿Puedo obtener límites más altos?+
Escríbenos desde la página de contacto e indica el volumen que prevés.
Empieza con la solicitud anterior
Crea una clave, pega el comando cURL en un terminal y tu figura estará lista en aproximadamente un minuto.