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 your organization's own provider key.

---

Actions

---

Image Generation

Basic Usage

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

The agent calls:

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

outputPath is relative to the chat's or mission's working directory — the folder chosen when it was created. Use an absolute organization path such as /marketing/images/cover.png to save somewhere else.

Parameters

Aspect Ratios

Image Models

---

Video Generation

Image-to-Video

Animate a static image into a short video clip. Requires either imagePath (a file in your organization's folders) 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 for your organization. Ask an organization owner to enable these providers under Settings → AI 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 at outputPath
5. Usage recorded --- estimated and provider-reported actual cost are attributed to platform or BYOK billing

Generated files land in the folder you choose: relative to the run's working directory by default, or at any absolute organization path you give in outputPath. 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: