# SciFig API

Crea ilustraciones científicas, gráficos y diagramas de flujo mediante HTTP, con los mismos motores, precios y créditos que el sitio web de SciFig.

Fuente: https://scifig.ai/es/docs/api

## Inicio rápido

- Crea una clave API en [Ajustes → Desarrollador](/es/app/settings?tab=developer). Las claves de generación requieren una suscripción activa o un saldo positivo de créditos adquiridos en paquetes; las claves de solo lectura funcionan con cualquier cuenta.
- Envía una solicitud de creación con un `Idempotency-Key`. Con `Prefer: wait=25`, la respuesta espera hasta 25 segundos y devuelve la tarea terminada si se completa a tiempo.
- Si la tarea sigue en `queued` o `processing`, consulta `GET /jobs/{id}` cada pocos segundos, respetando `Retry-After`, hasta que pase a `succeeded` o `failed`.
- Descarga cada resultado desde su `download_url`, válido durante una hora, o pasa su `file_id` a otro punto de acceso.

```bash
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"}'
```

URL base: `https://scifig.ai/api/v1`. Contrato legible por máquinas: [OpenAPI JSON](https://scifig.ai/api/v1/openapi.json) y [OpenAPI YAML](https://scifig.ai/api/v1/openapi.yaml). Los asistentes de IA pueden usar las mismas funciones mediante el [servidor MCP](/es/mcp).

## Puntos de acceso

| Punto de acceso | Función | Créditos |
| --- | --- | --- |
| POST /images/generations | Generar una ilustración científica a partir de una descripción | 50 / 75 / 100 |
| POST /images/edits | Editar mediante instrucciones o una región, fondo blanco, relación de aspecto, cambio de colores, sustitución de texto | 50 / 75 / 100; región o texto 100 |
| POST /images/text-detections | Detectar el texto de una imagen antes de sustituirlo | 0 |
| POST /images/upscales | Ampliar a 2K, 4K u 8K | 50 / 100 / 150 |
| POST /images/conversions | Vectorización SVG; exportación a PNG, PDF, TIFF y PPTX | SVG 150; PNG, PDF, TIFF y PPTX gratis |
| POST /charts/generations | Crear un gráfico con datos CSV, TSV o Excel | 100 |
| POST /charts/edits | Modificar la versión más reciente de un gráfico | 100 |
| POST /flowcharts/generations | Dibujar un diagrama de flujo en SVG | 100 |
| POST /flowcharts/edits | Modificar la versión más reciente de un diagrama de flujo | 100 |
| POST /files | Subir una imagen, una máscara o un archivo adjunto | 0 |
| GET /files/{file_id} | Descargar un archivo | 0 |
| GET /jobs/{id} | Consultar una tarea | 0 |
| GET /jobs | Enumerar las tareas recientes | 0 |
| GET /credits | Saldo, plan y límites de tareas | 0 |
| GET /pricing | Todos los precios, sin autenticación | 0 |
| GET /openapi.json | Descripción OpenAPI 3.1, sin autenticación | 0 |
| GET /openapi.yaml | La misma descripción en YAML, sin autenticación | 0 |

No hay webhooks, SDK ni herramientas de línea de comandos: llama directamente a los puntos de acceso desde un servidor o un script. La API no permite solicitudes CORS desde el navegador.