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ágenesGeneración de gráficosTrabajos y espera acotadaCréditosErroresLímites de peticiones y concurrenciaRegistro de cambios de la API
Documentación de la API

Generación de imágenes

Crear trabajos de texto a imagen

POST /api/v1/images/generations crea de una a cuatro imágenes a partir de una descripción textual. Ámbito requerido: images:generate.

Cuerpo JSON

CampoTipoObligatorioPredeterminadoReglas
promptstringsí—sin espacios sobrantes, 5–2.000 caracteres
aspect_ratiostringno1:11:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5 o 21:9
resolutionstringno2K2K o 4K
countintegerno11–4

Los campos desconocidos se rechazan. La petición pública no tiene opciones de enrutado de capacidades.

Créditos

ResoluciónCréditos por imagen
2K5
4K20

La reserva total es el coste por imagen multiplicado por count. Los créditos se reservan de forma atómica al aceptarse el trabajo, se liquidan al completarse y se liberan si termina en fallo.

Autenticación e idempotencia

Claves de API, ámbitos, identificadores de petición y reintentos seguros

Edición de imágenes

Editar una imagen subida con instrucciones en lenguaje natural

Tabla de contenidos

Cuerpo JSON
Créditos
cURL
JavaScript
Python
Dimensiones de salida

cURL

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: manuscript-42-panel-a' \
  -H 'Prefer: wait=10' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"A labeled plant cell diagram","aspect_ratio":"4:3","resolution":"2K","count":1}'

JavaScript

const response = await fetch('https://sci-draw.com/api/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SCIDRAW_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ prompt: 'A labeled plant cell diagram' }),
});
const body = await response.json();

Python

import os, uuid, requests

response = requests.post(
    "https://sci-draw.com/api/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['SCIDRAW_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={"prompt": "A labeled plant cell diagram", "resolution": "2K"},
)
job = response.json()["data"]

Devuelve 202 mientras está en cola o procesándose, y 200 si la espera acotada alcanza un estado terminal. Consulta Trabajos para el esquema de respuesta y el flujo de sondeo.

Dimensiones de salida

2K y 4K son niveles de tamaño, no longitudes de lado fijas. La tabla muestra los píxeles reales. Las proporciones no admitidas devuelven HTTP 400 (INVALID_REQUEST) antes de crear el trabajo o reservar créditos.

aspect_ratio2K4K
1:12048×20482880×2880
16:92560×14403840×2160
9:161440×25602160×3840
4:32304×17283264×2448
3:41728×23042448×3264
3:22496×16643504×2336
2:31664×24962336×3504
5:42240×17923200×2560
4:51792×22402560×3200
21:93136×13443808×1632