Generación de imágenes

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

Campo	Tipo	Obligatorio	Predeterminado	Reglas
`prompt`	string	sí	—	sin espacios sobrantes, 5–2.000 caracteres
`aspect_ratio`	string	no	`1:1`	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `5:4`, `4:5` o `21:9`
`resolution`	string	no	`2K`	`2K` o `4K`
`count`	integer	no	`1`	1–4

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

Créditos

Resolución	Créditos por imagen
`2K`	5
`4K`	20

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.

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.

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_ratio`	`2K`	`4K`
1:1	2048×2048	2880×2880
16:9	2560×1440	3840×2160
9:16	1440×2560	2160×3840
4:3	2304×1728	3264×2448
3:4	1728×2304	2448×3264
3:2	2496×1664	3504×2336
2:3	1664×2496	2336×3504
5:4	2240×1792	3200×2560
4:5	1792×2240	2560×3200
21:9	3136×1344	3808×1632

Cuerpo JSON

Créditos

cURL

JavaScript

Python

Dimensiones de salida

Tabla de contenidos