Files & artifacts

Envía archivos a una tarea, recupera los archivos que produce un agent, genera multimedia y renderiza documentos pulidos en el servidor.

Uploads (archivos de entrada)

POST/v1/workspaces/{workspace_id}/uploads —

sube un archivo (multipart); su texto extraído puede integrarse en una tarea de chat o agent.

Artifacts (archivos de salida)

Los archivos que crea un agent se rastrean como artifacts:

GET/v1/workspaces/{workspace_id}/artifacts —

lista (filtra por kind, favorites_only, paginar).

GET/v1/workspaces/{workspace_id}/artifacts/{artifact_id}/download —

una URL de descarga firmada y fresca.

POST/v1/workspaces/{workspace_id}/artifacts/preview —

una payload de vista previa en línea (tablas parseadas en el servidor; Office → PDF).

POST/v1/workspaces/{workspace_id}/artifacts/{artifact_id}/convert —

convierte a otro formato (to).

Generar multimedia

La generación de imagen / vídeo / voz es asíncrona: envía y luego haz polling de la tarea:

POST/v1/workspaces/{workspace_id}/generate/image —

prompt → haz polling de

GET/v1/workspaces/{workspace_id}/generate/image/{task_id} —

POST/v1/workspaces/{workspace_id}/generate/video —

prompt, duration_sec, aspect_ratio.

POST/v1/workspaces/{workspace_id}/generate/speech —

text, voice.

GET/v1/workspaces/{workspace_id}/generate/pricing —

tarifas actuales por unidad.

Renderizar documentos

POST/v1/workspaces/{workspace_id}/render —

renderiza un archivo pulido a partir de entrada estructurada: format (pdf / docx / xlsx / slides / md) más sections, slides o sheets. Se gestiona CJK (sin tofu).

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/render \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format": "pdf", "title": "Q2 Review",
     "sections": [{"heading": "Summary", "markdown_text": "Revenue **up 18%**."}]}'

La generación y el renderizado se facturan a las tarifas mostradas por /generate/pricing; el cargo se liquida contra el saldo del workspace cuando se entrega el archivo.