Skip to main content
POST
Sube una imagen

Autorizaciones

Authorization
string
header
requerido

Una clave de API del espacio de trabajo: wdy_live_… / wdy_test_…. Se crea en POST /workspaces/{tenantId}/keys y se muestra exactamente una vez.

Cuerpo

application/json
fileName
string
requerido

Nombre de archivo original, p. ej. "loaf.jpg". Una etiqueta y la semilla de la clave, nunca una ruta.

Required string length: 1 - 200
data
string
requerido

El archivo de imagen, codificado en base64. Solo base64 sin procesar (sin el prefijo data:). Los bytes determinan el formato (PNG/JPEG/WebP/GIF/AVIF).

key
string

Id estable en kebab-case que el agente emite. Su valor predeterminado es un slug.

Maximum string length: 48
topics
array[]
Maximum array length: 8
agentId
object | null

El agente al que esto pertenece; null/ausente = el pool del espacio de trabajo.

Respuesta

id
string
requerido
agentId
object | null
requerido

null = el pool del espacio de trabajo.

key
string
requerido

La key estable que el agente emite para mostrarla.

kind
string
requerido
mimeType
string
requerido
byteSize
number
requerido
orientation
string
requerido
topics
string[]
requerido
description
string
requerido

Lo que la imagen MUESTRA; el planificador lo lee.

alt
object
requerido
status
string
requerido

pending, ready, failed, …

url
string<uri>
requerido

Una URL firmada y de corta duración. Nunca la almacenes.

createdAt
string<date-time>
requerido
updatedAt
string<date-time>
requerido
width
number
height
number
error
string