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

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.

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'

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']}"

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.

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
,
},
body: JSON.stringify({ prompt: 'A labeled plant cell diagram' }),
});
const body = await response.json();
,
"Idempotency-Key": str(uuid.uuid4()),
},
json={"prompt": "A labeled plant cell diagram", "resolution": "2K"},
)
job = response.json()["data"]