# Conversión de imágenes

Vectoriza una imagen a SVG o exporta a PNG, PDF, TIFF y PPTX, incluidos los diagramas de flujo.

Fuente: https://scifig.ai/es/docs/api/image-conversions

## Cuerpo JSON

`POST /images/conversions`. Ámbito requerido: `figures:generate`.

| Campo | Tipo | Obligatorio | Valor predeterminado | Reglas |
| --- | --- | --- | --- | --- |
| image | string | sí | — | Un `file_id` de PNG o JPEG o el SVG de un diagrama de flujo, hasta 20 MB; `svg` también acepta WebP |
| format | string | sí | — | `svg`, `png`, `pdf`, `tiff` o `pptx` |
| vector_mode | string | no | `editable_text` | Solo para `svg`: `editable_text` o `full_vector` |
| dpi | integer | no | 300 | No para `svg`: 300, 600 o 1000 |
| width | integer | no | 2048 | Solo para fuentes SVG de diagramas de flujo: lado largo en píxeles, 256–4096, máximo 4,194,304 píxeles en total |

## Vectorización SVG

- Cuesta 150 créditos y requiere un plan de pago; usa el mismo vectorizador que la edición en el lienzo del sitio web. La fuente es una imagen PNG, JPEG o WebP.
- `editable_text` conserva el texto como texto SVG editable; `full_vector` traza todos los elementos, incluido el texto, como rutas.
- Se ejecuta como una tarea. Los créditos solo se reservan cuando se acepta la vectorización y los `credits` de la tarea se leen del registro contable. Una vectorización fallida devuelve sus créditos y responde `TASK_FAILED` para esa clave.
- Convertir una imagen ya vectorizada devuelve el SVG anterior sin coste para esta tarea.
- Si el vectorizador no está disponible temporalmente antes de iniciar la tarea, la respuesta es `503 SERVICE_UNAVAILABLE` con `Retry-After`: vuelve a intentarlo con la misma clave.

## PNG, PDF, TIFF y PPTX

- Gratis, hasta 200 conversiones por cuenta y día. Se completan al instante: la respuesta es una tarea `succeeded`.
- Una conversión solo cuenta para el cupo diario después de que su entrada supere todas las comprobaciones y una vez por Idempotency-Key: repetir la misma clave no cuenta de nuevo. Al superar el cupo, la respuesta es `429 RATE_LIMITED` con `details.reason = DAILY_CONVERSION_LIMIT` y `Retry-After` hasta que se reinicie la ventana diaria.
- La fuente es una imagen PNG o JPEG o el SVG de un diagrama de flujo; no se acepta WebP: `UNSUPPORTED_SOURCE_FORMAT`.
- Un archivo cuyo resultado codificado superaría 24 MiB se rechaza con `400 INVALID_REQUEST` y `OUTPUT_TOO_LARGE`; convierte una imagen más pequeña.
- `dpi` se escribe en el archivo y determina el tamaño físico de página de PDF y PPTX; no se remuestrean los píxeles. Para obtener más píxeles, [amplía](/es/docs/api/image-upscales) primero.
- PNG y TIFF requieren una fuente PNG; PDF y PPTX también aceptan JPEG. TIFF usa compresión Deflate sin pérdidas.
- El PPTX contiene una diapositiva con la imagen, no formas editables.

## Exportación de diagramas de flujo

El SVG de un diagrama de flujo se puede convertir a PNG, PDF, TIFF o PPTX. El servidor lo renderiza con fuentes Arial y Noto y `width` píxeles en el lado largo: 2048 por defecto, máximo 4096 y 4,194,304 píxeles en total; un gráfico cuadrado puede tener como máximo 2048 px. Una solicitud mayor devuelve `400 INVALID_REQUEST` con `RENDER_TOO_LARGE`. El texto que las fuentes no pueden representar se rechaza con `400 INVALID_REQUEST` y `SVG_NOT_RENDERABLE`, en lugar de dibujarse como cuadros vacíos. Si falla el renderizador, la respuesta es `503 SERVICE_UNAVAILABLE` con `SVG_RENDERER_UNAVAILABLE` y `Retry-After`: reintenta con la misma clave. No se pueden usar otros archivos SVG como entrada.

## cURL

```bash
curl -X POST https://scifig.ai/api/v1/images/conversions \
  -H "Authorization: Bearer $SCIFIG_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Prefer: wait=25" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "<file_id>",
    "format": "pdf",
    "dpi": 600
  }'
```

## JavaScript

```javascript
const response = await fetch('https://scifig.ai/api/v1/images/conversions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SCIFIG_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    Prefer: 'wait=25',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "image": "<file_id>",
    "format": "pdf",
    "dpi": 600
  }),
});
const result = await response.json();
console.log(response.status, result);
```

## Python

```python
import os
import uuid

import requests

headers = {
    "Authorization": f"Bearer {os.environ['SCIFIG_API_KEY']}",
    "Idempotency-Key": str(uuid.uuid4()),
    "Prefer": "wait=25",
}
response = requests.post(
    "https://scifig.ai/api/v1/images/conversions",
    headers=headers,
    json={
        "image": "<file_id>",
        "format": "pdf",
        "dpi": 600
    },
    timeout=60,
)
print(response.status_code, response.json())
```