Visión general

La API REST de SciDraw AI ofrece endpoints estables basados en trabajos para generar imágenes, editarlas y convertir formatos.

URL base: https://sci-draw.com

Especificación legible por máquina: OpenAPI JSON · OpenAPI YAML

Ambos archivos describen esta misma API en formato OpenAPI. Importa cualquiera de los dos en Postman o Insomnia y tendrás todos los endpoints ya rellenados; pásalo por un generador de código y obtendrás un cliente tipado; entrégaselo a un agente de IA y podrá llamar a la API sin que escribas la petición a mano. Los dos formatos son intercambiables: usa el que acepte tu herramienta.

Inicio rápido

1. Crea una clave de API en Ajustes → Claves API y selecciona solo los ámbitos que necesite tu integración.
2. Envía la clave como Authorization: Bearer sd_....
3. Añade un Idempotency-Key único a cada petición de creación.
4. Guarda el identificador de trabajo devuelto y consulta su URL Location hasta que llegue a succeeded, failed o canceled.

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: order-7842-figure-1' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A clean scientific illustration of exosome biogenesis",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "count": 1
  }'

Una petición de creación devuelve normalmente 202 Accepted, un objeto de trabajo, una cabecera Location y Retry-After: 2. Puedes añadir Prefer: wait=10 para esperar hasta diez segundos. Esperar no cambia nunca la semántica del trabajo: el estado es 200 solo si el trabajo ya terminó; en caso contrario sigue siendo 202.

Endpoints

Todas las respuestas son envolturas JSON. Cada respuesta lleva un X-Request-Id; incluye ese identificador al contactar con soporte. Las únicas referencias a archivos que se devuelven son las URL de salida y los identificadores públicos de archivo. El enrutado de capacidades lo gestiona SciDraw AI.