API de JPEG a SVG#

Convierte un JPEG al formato SVG con POST /v1/convert/jpeg-to-svg, que codifica el JPEG en base64 y lo incrusta como un URI de datos dentro de un elemento <image> de SVG. Esto no es vectorización: la salida es la imagen ráster completa envuelta en un contenedor SVG, útil para flujos de trabajo que requieren SVG pero aceptan contenido ráster incrustado. Las respuestas devuelven bytes sin procesar para descarga directa, o metadatos JSON con una URL de descarga prefirmada.

Endpoint#

POST /v1/convert/jpeg-to-svg

Content-Type: multipart/form-data

Entrada aceptada: archivos .jpeg or .jpg

Formato de salida: .svg (image/svg+xml)

Autenticación#

Requiere una clave de API privada o un token JWT obtenido a partir de una clave pública.

X-API-Key: sk_your_private_key

O bien:

Authorization: Bearer <jwt_token>

Parámetros de la solicitud#

Detalles de la conversión#

• El JPEG se codifica en base64 y se incrusta dentro de un elemento <image> de SVG como un URI de datos
• Las dimensiones del SVG y el viewBox coinciden con las dimensiones en píxeles de la imagen original
• Esto NO es vectorización -- la salida contiene los datos completos de la imagen ráster, no rutas vectoriales
• Útil para flujos de trabajo que requieren formato SVG pero aceptan contenido ráster incrustado

Respuesta#

Descarga directa (direct_download=true, predeterminado)#

HTTP 200 OK
Content-Type: image/svg+xml
Content-Disposition: inline; filename="photo_20260405_123456789.svg"

Devuelve los bytes de la imagen sin procesar.

Respuesta de metadatos (direct_download=false)#

{
    "presigned_url": "https://spaces.example.com/...",
    "object_key": "env/files/{project_id}/jpeg-to-svg/photo_20260405_123456789.svg",
    "filename": "photo_20260405_123456789.svg",
    "file_size": 45678,
    "conversion_time_seconds": 0.5
}

Ejemplos de código#

Python#

import requests

with open("photo.jpg", "rb") as f:
    response = requests.post(
        "https://api.enconvert.com/v1/convert/jpeg-to-svg",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("photo.jpg", f)}
    )

with open("photo_20260405_123456789.svg", "wb") as out:
    out.write(response.content)

Node.js#

const form = new FormData();
form.append("file", fs.createReadStream("photo.jpg"));

const response = await fetch("https://api.enconvert.com/v1/convert/jpeg-to-svg", {
    method: "POST",
    headers: { "X-API-Key": "sk_your_private_key" },
    body: form
});

fs.writeFileSync("photo_20260405_123456789.svg", Buffer.from(await response.arrayBuffer()));

PHP#

$ch = curl_init("https://api.enconvert.com/v1/convert/jpeg-to-svg");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: sk_your_private_key"],
    CURLOPT_POSTFIELDS => ["file" => new CURLFile("photo.jpg")]
]);
$output = curl_exec($ch);
curl_close($ch);
file_put_contents("photo_20260405_123456789.svg", $output);

Go#

body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("file", "photo.jpg")
file, _ := os.Open("photo.jpg")
io.Copy(part, file)
writer.Close()

req, _ := http.NewRequest("POST", "https://api.enconvert.com/v1/convert/jpeg-to-svg", body)
req.Header.Set("Content-Type", writer.FormDataContentType())
req.Header.Set("X-API-Key", "sk_your_private_key")
resp, _ := http.DefaultClient.Do(req)

Respuestas de error#

Límites#

Preguntas frecuentes#

¿Cómo convierto un JPG a SVG con una API REST?#

Envía una solicitud POST multipart/form-data a /v1/convert/jpeg-to-svg con tu archivo .jpeg o .jpg en el campo file, autenticada mediante X-API-Key o un token JWT Bearer. La API devuelve un SVG con tu imagen incrustada en base64 dentro de un elemento <image>.

¿La API de JPEG a SVG vectoriza mi imagen?#

No. Este endpoint no traza ni convierte la imagen a rutas vectoriales: incrusta el JPEG ráster dentro de un contenedor SVG como un URI de datos en base64. Las dimensiones del SVG y el viewBox coinciden con las dimensiones en píxeles de la imagen original.

¿Por qué la salida SVG es más grande que mi entrada JPEG?#

La codificación base64 añade aproximadamente un 33% de sobrecarga, por lo que el archivo de salida es más grande que el de entrada, ya que contiene los datos completos de la imagen ráster codificados como texto.

¿Puedo obtener una URL de descarga en lugar de los bytes del archivo sin procesar?#

Sí. Define direct_download=false y la API devuelve metadatos JSON que incluyen presigned_url, object_key, filename, file_size y conversion_time_seconds.