LogoLogoDocumentación de la API
LogoLogoDocumentación de la API
Página de inicio
Visión generalAutenticación e idempotenciaGeneración de imágenesEdición de imágenesConversión de imágenesTrabajos y espera acotadaCréditosErroresLímites de peticiones y concurrenciaRegistro de cambios de la API
Documentación de la API

Edición de imágenes

Editar una imagen subida con instrucciones en lenguaje natural

POST /api/v1/images/edits acepta multipart/form-data. Ámbito requerido: images:edit.

Campos del formulario

CampoTipoObligatorioPredeterminadoReglas
imagefilesí—PNG, JPEG o WebP; máximo 10 MiB y 40 millones de píxeles decodificados
promptstringsí—instrucción de edición, 5–2.000 caracteres
aspect_ratiostringnosegún el origenlas mismas proporciones públicas que en generación
resolutionstringno2K2K o 4K
countintegerno11–4

Las firmas de archivo se comprueban con independencia del tipo MIME declarado. Las imágenes inválidas, demasiado grandes o inseguras devuelven 400 INVALID_REQUEST, o HTTP 413 con el mismo código público.

Créditos

ResoluciónCréditos por salida
2K10
4K20

cURL

curl https://sci-draw.com/api/v1/images/edits \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: revise-figure-7-v2' \
  -F 'image=@figure.png;type=image/png' \
  -F 'prompt=Move the legend below the diagram and increase label contrast' \
  -F 'resolution=2K' \
  -F 'count=1'

JavaScript

const form = new FormData();
form.set('image', file);
form.set('prompt', 'Move the legend below the diagram');
const response = await fetch('https://sci-draw.com/api/v1/images/edits', {
  method: 'POST',

Python

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/edits",
        headers={"Authorization": f"Bearer

La imagen subida es entrada privada del trabajo y nunca se devuelve en respuestas de trabajo ni de registro. Las subidas idempotentes duplicadas se descartan; los originales aceptados se eliminan tras un resultado terminal.

Generación de imágenes

Crear trabajos de texto a imagen

Conversión de imágenes

Convertir imágenes a SVG, PPTX, PNG, PDF o TIFF

Tabla de contenidos

Campos del formulario
Créditos
cURL
JavaScript
Python
headers: { Authorization: `Bearer ${apiKey}`, 'Idempotency-Key': crypto.randomUUID() },
body: form,
});
{
api_key
}
"
,
"Idempotency-Key"
:
str
(uuid.uuid4())},
files={"image": ("figure.png", image, "image/png")},
data={"prompt": "Move the legend below the diagram"},
)