Media Tasks
Media processing background jobs
How to use this capability
Ways to interact with this capability — pick a path to jump to the relevant section below.
SDK
Call actions from Node or React apps using the Ossy SDK — typed payloads and workspace context built in.
View section ↓
MCP
Connect Cursor to http://localhost:3006/mcp when MCP tools are available for media-tasks.
View section ↓
HTTP
Call actions over HTTP with Bearer token authentication — create a token in Profile for scripts and automation.
View section ↓
Background tasks
Event-driven and scheduled handlers run in the background — triggered by the platform, not invoked like actions.
View section ↓
Actions
Invokable intents — call directly via SDK, POST /actions, or MCP tools. This is the agent-facing surface, not background jobs.
Categorize
@ossy/media-tasks/actions/categorize
Invoke @ossy/media-tasks/actions/categorize
MCP: ossy_media_tasks_categorize
sdk.invoke('@ossy/media-tasks/actions/categorize', { … })POST /actions
{ "action": "@ossy/media-tasks/actions/categorize", "payload": { … } }Background tasks
Background and scheduled handlers — triggered by events or cron, not called via SDK, POST /actions, or MCP. Ids use the tasks/ path (distinct from actions/).
Categorize
@ossy/media-tasks/tasks/categorize
Convert Common Audio
@ossy/media-tasks/tasks/convert-common-audio
Convert Common Image
@ossy/media-tasks/tasks/convert-common-image
Embed Resource
@ossy/media-tasks/tasks/embed-resource
Extract Colors
@ossy/media-tasks/tasks/extract-colors
Extract Structured Data
@ossy/media-tasks/tasks/extract-structured-data
Resize Common Web
On image upload — generates thumbnails, gallery sizes, and BlurHash as task outputs.
@ossy/media-tasks/tasks/resize-common-web
Run Prompt
Configurable OpenRouter prompt. Writes a completion artifact, and a placed document when a folder is set.
@ossy/media-tasks/tasks/run-prompt
Text To Voice
OpenRouter TTS for Markdown or text — writes an MP3 artifact (and a placed document when a folder is set).
@ossy/media-tasks/tasks/text-to-voice
Visual Content Descriptors
On image/video upload — suggests title, description, tags, and alt (apply from Storage → Tasks).
@ossy/media-tasks/tasks/visual-content-descriptors
Resource types
Structured entities and templates registered for resources.
Categorization
@ossy/media-tasks/schema/categorization
Convert Common Audio
@ossy/media-tasks/schema/convert-common-audio
Convert Common Image
@ossy/media-tasks/schema/convert-common-image
Embed Resource
@ossy/media-tasks/schema/embed-resource
Extract Colors
@ossy/media-tasks/schema/extract-colors
Resize Common Web
@ossy/media-tasks/schema/resize-common-web
Text To Voice
@ossy/media-tasks/schema/text-to-voice
Visual Content Descriptors
@ossy/media-tasks/schema/visual-content-descriptors
Integrations
Third-party connectors and credential requirements.
Openrouter
openrouter
Credentials: OPENROUTER_API_KEY