Files & artifacts

Envie arquivos para uma tarefa, recupere os arquivos que um agent produz, gere mídia e renderize documentos polidos no servidor.

Uploads (arquivos de entrada)

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

faz upload de um arquivo (multipart); seu texto extraído pode ser integrado a uma tarefa de chat ou agent.

Artifacts (arquivos de saída)

Arquivos que um agent cria são rastreados como artifacts:

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

lista (filtre por kind, favorites_only, pagine).

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

uma URL de download assinada nova.

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

um payload de preview inline (tabelas parseadas no servidor; Office → PDF).

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

converte para outro formato (to).

Gerar mídia

Geração de imagem / vídeo / fala é assíncrona — envie, então faça polling da tarefa:

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

prompt → polling

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 —

taxas atuais por unidade.

Renderizar documentos

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

renderiza um arquivo polido a partir de entrada estruturada: format (pdf / docx / xlsx / slides / md) mais sections, slides ou sheets. CJK é tratado (sem 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%**."}]}'

Geração e renderização são cobradas pelas taxas mostradas em /generate/pricing; a cobrança é liquidada contra o saldo do workspace quando o arquivo é entregue.