Files & artifacts

タスクにファイルを送り、エージェントが生成したファイルを取得し、メディアを生成し、サーバー側で洗練されたドキュメントをレンダリングします。

アップロード（入力ファイル）

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

ファイル（multipart）をアップロード；抽出されたテキストはチャットやエージェントタスクに組み込めます。

Artifacts（出力ファイル）

エージェントが作成したファイルは artifacts として追跡されます：

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

一覧（kind、favorites_only でフィルタ、ページネーション対応）。

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

新しく発行された署名付きダウンロード URL。

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

インラインのプレビューペイロード（テーブルはサーバー側で解析；Office → PDF）。

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

別の形式に変換（to）。

メディアの生成

画像／動画／音声生成は非同期です——送信後、タスクをポーリングします：

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

prompt → ポーリング

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 —

現在の単価。

ドキュメントのレンダリング

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

構造化入力から洗練されたファイルをレンダリング：format（pdf／docx／xlsx／slides／md）と sections、slides、または sheets。CJK に対応（豆腐になりません）。

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

生成とレンダリングは /generate/pricing に表示されるレートで課金され、ファイルの配送時にワークスペース残高から決済されます。