Documentação da API

Conversão de imagens

Converter imagens para SVG, PPTX, PNG, PDF ou TIFF

POST /api/v1/images/conversions aceita multipart/form-data. Escopo necessário: images:convert.

Campos do formulário

Campo	Tipo	Obrigatório	Padrão	Regras
`image`	file	sim	—	PNG, JPEG ou WebP; no máximo 10 MiB e 40 milhões de pixels decodificados
`format`	string	sim	—	`svg`, `pptx`, `png`, `pdf` ou `tiff`
`vector_mode`	string	não	`editable_text`	somente SVG
`dpi`	string	não	`300`	`300`, `600` ou `1000`; somente PNG, PDF e TIFF

Os dois modos de SVG

As duas opções de SVG estão implementadas e disponíveis no mesmo endpoint:

`vector_mode`	Resultado	Créditos
`editable_text`	SVG com texto editável quando possível	10
`full_vector`	saída SVG totalmente vetorizada	15

Os nomes descrevem capacidades de saída. O roteamento de capacidades é gerenciado pela SciDraw AI e não faz parte do contrato público.

Edição de imagens

Editar uma imagem enviada com instruções em linguagem natural

Jobs e espera limitada

Consultar trabalho assíncrono e ler resultados higienizados

Sumário

Campos do formulário

Os dois modos de SVG

Outros formatos e créditos

cURL: SVG com texto editável

JavaScript

Python

Formato	Opção	Créditos
`pptx`	—	10
`png`, `pdf`, `tiff`	`dpi=300`	5
`png`, `pdf`, `tiff`	`dpi=600`	10
`png`, `pdf`, `tiff`	`dpi=1000`	15

curl https://sci-draw.com/api/v1/images/conversions \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: figure-12-svg-editable' \
  -F 'image=@figure.png;type=image/png' \
  -F 'format=svg' \
  -F 'vector_mode=editable_text'

const form = new FormData();
form.set('image', file);
form.set('format', 'svg');
form.set('vector_mode', 'full_vector');
const response = await fetch('https://sci-draw.com/api/v1/images/conversions', {
  method: 'POST',
  headers: { Authorization: `Bearer ${apiKey}`, 'Idempotency-Key': crypto.randomUUID() },
  body: form,
});

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/conversions",
        headers={"Authorization": f"Bearer {api_key}", "Idempotency-Key": str(uuid.uuid4())},
        files={"image": ("figure.png", image, "image/png")},
        data={"format": "svg", "vector_mode": "full_vector"},
    )