Media Generation Tool

The MediaGeneration tool lets your agents generate images, videos, and music directly in conversations. It's available as a built-in MCP tool at mcp__teamday-media__MediaGeneration.

Provider credentials, plan policy, quota, and estimated cost are checked before generation. Successful usage is attributed automatically to Teamday credits or the workspace's own provider key.

---

Actions

---

Image Generation

Basic Usage

Generate a blog cover image of a futuristic AI workspace with soft neon lighting.

The agent calls:

{
  "action": "generateImage",
  "prompt": "Futuristic AI workspace with soft neon lighting, clean modern design",
  "outputPath": "images/ai-workspace.png"
}

Parameters

Aspect Ratios

Image Models

---

Video Generation

Image-to-Video

Animate a static image into a short video clip. Requires either imagePath (local file in workspace) or imageUrl (public URL).

{
  "action": "imageToVideo",
  "imagePath": "images/product-shot.png",
  "prompt": "Subtle zoom in with gentle particle effects",
  "provider": "fal",
  "model": "fal-ai/kling-video/v3/pro/image-to-video",
  "duration": 5,
  "outputPath": "videos/product-animation.mp4"
}

Parameters

Video Models

Note: Alibaba Cloud models (wan2.7-i2v, happyhorse-1.0-i2v) and ByteDance ModelArk models (seedance) require the corresponding provider credentials configured on your workspace. Contact your workspace admin to enable these providers.

---

Checking Provider Availability

Check whether the required provider credential is available before generation:

{
  "action": "checkBalance"
}

Returns:

{
  "ok": true,
  "balance": {
    "configured": {
      "modelark": true,
      "fal": true,
      "xai": false,
      "gemini": true
    },
    "dry_run": false
  }
}

---

How It Works

1. Agent calls the tool --- the MCP server runs inside the computer service
2. Policy pre-check --- verifies credentials, plan policy, quota, and estimated cost
3. API call --- sends the request to Google Gemini, FAL.AI, xAI, Alibaba Cloud, or ByteDance ModelArk depending on the model
4. File saved --- downloads the result and saves it to the workspace
5. Usage recorded --- estimated and provider-reported actual cost are attributed to platform or BYOK billing

All generated files are saved to the agent's workspace (space directory). The agent can then reference them in responses, embed them in documents, or use them as inputs for further processing.

---

Tips for Agents

• Always specify outputPath with a meaningful filename
• Use checkBalance to confirm provider availability before expensive generation
• For blog images, use 16:9; for profile images, use 1:1
• Use grok-imagine-video-1.5 only with imagePath or imageUrl
• Set generateAudio: true only when you need Kling 3 native audio; it raises the provider cost

---

Pricing Summary

All costs are per generation in USD cents.

Images:

Videos: