# Capabilities reference — what your agent can do out of the box

Built-in capabilities are actions the agent invokes on its own while working — search the web, fetch pages, generate images and video, transcribe voice. You choose which ones an agent gets when you create it; no API keys or extra subscriptions.

Each action below is listed with its input parameters, what it returns, and its per-call limits. Some actions have more than one provider — the agent uses the default unless asked otherwise. Media outputs are returned as hosted assets the agent can deliver on any channel. Usage is metered per the listed unit and billed from your credits; actions marked with an approval threshold ask before spending more than it.

## dataforseo

### dataforseo.ai_keywords

AI keyword data — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.ai-keywords` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. search-volume — default: "search-volume"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.llm_responses

LLM response data — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.llm-responses` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. live · submit · get — default: "live"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.app_info

App information — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.app-info` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. apple-submit · apple-get · google-submit · google-get — default: "apple-submit"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.app_search

App search — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.app-search` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. apple-submit · apple-get · google-submit · google-get — default: "apple-submit"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.backlinks

Backlink analytics — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.backlinks` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. anchors · backlinks · referring-domains · summary — default: "anchors"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.business_reviews

Business reviews — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.business-reviews` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. google-submit · google-get · tripadvisor-submit · tripadvisor-get · trustpilot-submit · trustpilot-get — default: "google-submit"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.business_pinterest

Pinterest business data — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.business-pinterest` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. live — default: "live"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.content_analysis

Content analysis — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.content-analysis` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. phrase-trends · search · summary — default: "phrase-trends"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.technologies

Technology analytics — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.technologies` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. domains · summary — default: "domains"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.keyword_data

Keyword data — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.keyword-data` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. bing-search-volume · google-keywords-for-keywords · google-search-volume · google-trends — default: "bing-search-volume"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.labs

SEO Labs — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.labs` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. competitors · domain-rank · historical-volume · keyword-ideas · keyword-suggestions · ranked-keywords · related-keywords — default: "competitors"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.amazon

Amazon marketplace data — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.amazon` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. asin-submit · asin-get · products-submit · products-get · sellers-submit · sellers-get · ready — default: "asin-submit"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

### dataforseo.onpage

On-page analysis — Unavailable until the supplier pricing contract for these operations is verified.

id: `dataforseo.onpage` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Allowlisted operation for this capability. content-parsing · instant-page · lighthouse — default: "content-parsing"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

## embedding

### embedding.create (openai)

Create embeddings — Unavailable pending native request, billing and release acceptance. Generate vectors for text input.

id: `embedding.openai` (grant it via `capabilities = […]`) · provider: openai · read-only · billed per million_tokens

Parameters:

- `input` (array, required) — Text strings to embed.
- `model` (string) — Embedding model override.

Returns:

- `data` (array) — Embedding vectors.
- `model` (string) — Model used.
- `provider` (string) — Resolved provider.

Limits: timeout 60s

### embedding.create (voyage)

Create embeddings — Unavailable pending native request, billing and release acceptance. Generate Voyage vectors for text input.

id: `embedding.voyage` (grant it via `capabilities = […]`) · provider: voyage · read-only · billed per million_tokens

Parameters:

- `input` (array, required) — Text strings to embed.
- `model` (string) — Embedding model override.

Returns:

- `data` (array) — Embedding vectors.
- `model` (string) — Model used.
- `provider` (string) — Resolved provider.

Limits: timeout 60s

## rerank

### rerank

Rerank documents — Unavailable pending native request, billing and release acceptance. Score and order candidate documents for a query.

id: `rerank.voyage` (grant it via `capabilities = […]`) · provider: voyage · read-only · billed per million_tokens

Parameters:

- `model` (enum) — Reranking model. rerank-3 · rerank-3-lite · rerank-2.5 · rerank-2.5-lite
- `query` (string, required) — Ranking query.
- `documents` (array, required) — Candidate documents.
- `top_k` (integer) — Maximum results; omission ranks up to 100 documents. 1–100

Returns:

- `results` (array) — Ranked documents.
- `model` (string) — Model used.
- `provider` (string) — Resolved provider.

Limits: timeout 60s · up to 100 results

## ocr

### ocr.parse

OCR document — Unavailable pending native request, billing and release acceptance. Parse a PDF or image document with Mistral OCR.

id: `ocr.mistral` (grant it via `capabilities = […]`) · provider: mistral · read-only · billed per page

Parameters:

- `model` (enum) — OCR model. mistral-ocr-latest · mistral-ocr-4-1
- `document_url` (url) — Public document URL.
- `document_base64` (string) — Base64 PDF, PNG or JPEG; data URL MIME must match bytes.
- `document_type` (enum) — Use image for an image URL; inline data is detected from bytes. document · image

Returns:

- `pages` (array) — Parsed page content.
- `provider` (string) — Resolved provider.

Limits: timeout 120s · up to 10 MB

## Web

### web.search

Search web — Find public web pages and return sourced search results.

id: `exa.search` (grant it via `capabilities = […]`) · provider: exa · read-only · billed per run

Parameters:

- `query` (string, required) — Search query text sent to the web search provider.
- `limit` (integer) — Maximum number of search results to return. default: 8 — 1–20

Returns:

- `results` (array) — Search result objects.
- `provider` (string) — Resolved provider.

Limits: timeout 30s · up to 20 results

### web.fetch

Fetch web page — Retrieve readable public URL content as markdown, text, or JSON metadata.

id: `exa.contents` (grant it via `capabilities = […]`) · provider: exa · read-only · billed per page · default provider for this action

Parameters:

- `url` (url, required) — Public URL to fetch.
- `format` (enum) — Returned content format. markdown · text · json — default: "markdown"

Returns:

- `url` (url) — Fetched URL.
- `content` (string) — Normalized content.
- `provider` (string) — Resolved provider.

Limits: timeout 30s · up to 2 MB

### web.fetch (tinyfish)

Fetch JS-heavy page — Explicit JS-heavy/browser fallback for pages Exa cannot fetch statically.

id: `tinyfish.fetch` (grant it via `capabilities = […]`) · provider: tinyfish · read-only · billed per page

Parameters:

- `url` (url, required) — Public URL to fetch.
- `format` (enum) — Returned content format. markdown · text · json — default: "markdown"

Returns:

- `url` (url) — Fetched URL.
- `content` (string) — Normalized content.
- `provider` (string) — Resolved provider.

Limits: timeout 60s · up to 2 MB

### web.browser

Browser session — Returns connection details for a session; it does not execute browser interactions.

id: `tinyfish.browser` (grant it via `capabilities = […]`) · provider: tinyfish · read-only · billed per minute

Parameters:

- `url` (url, required) — Public URL to open.
- `task` (string) — Legacy hint retained for compatibility; session creation does not execute it. default: "extract readable content"

Returns:

- `url` (url) — Opened URL.
- `content` (string) — Session id and connection URLs encoded as JSON.
- `provider` (string) — Resolved provider.

Limits: timeout 120s · up to 120s duration

### web.automate

Browser automation — Runs browser interactions and returns the completed structured result.

id: `tinyfish.agent` (grant it via `capabilities = […]`) · provider: tinyfish · acts on a public site · billed per step

Parameters:

- `url` (url, required) — Public URL where the automation starts.
- `goal` (string, required) — Browser goal to execute.

Returns:

- `url` (url) — Starting URL.
- `provider` (string) — Resolved provider.
- `goal` (string) — Executed browser goal.
- `status` (string) — Terminal automation status.
- `runId` (string) — Automation run id.
- `steps` (integer) — Supplier-reported billable steps.
- `result` (object) — Completed structured result.

Limits: timeout 120s · up to 1 MB · up to 90s duration · capped at $4.8/call · asks for approval above $1.6 per call

## SEO / SERP

### serp.search

Search SERP — Run bounded Google organic search and retrieve owned tasks.

id: `dataforseo.serp` (grant it via `capabilities = […]`) · provider: dataforseo · read-only · billed per run

Parameters:

- `operation` (enum) — Supported bounded Google organic operation. Bing, Maps, News and YouTube operations are unavailable and rejected before supplier dispatch. google-organic-live · google-organic-submit · google-organic-get — default: "google-organic-live"
- `tasks` (array) — Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.
- `query` (string) — Query shortcut supported by SERP operations.
- `locale` (string) — Locale used by the SERP query shortcut. default: "en-US"
- `limit` (integer) — Legacy result-limit hint; provider returns its native result page. default: 10 — 1–100
- `task_id` (string) — Task identifier for task-get operations.
- `max_cost_usd` (number) — Maximum provider cost accepted for POST operations. 0–10

Returns:

- `results` (array) — Provider result objects.
- `tasks` (array) — Provider task receipts.
- `provider` (string) — Resolved provider.
- `operation` (string) — Resolved operation.

Limits: timeout 60s · up to 100 results

## Images

### image.generate

Generate image — Create an image from a text prompt with OpenAI gpt-image-2.

id: `gptimage.generate` (grant it via `capabilities = […]`) · provider: openai · generates media · billed per asset

Parameters:

- `prompt` (string, required) — Image prompt.
- `size` (enum) — Output image size. 1024x1024 · 1024x1536 · 1536x1024 — default: "1024x1024"

Returns:

- `assetId` (asset-ref) — Guild asset id.
- `mimeType` (string) — Output MIME type.
- `provider` (string) — Resolved provider.

Limits: timeout 300s · up to 20 MB · capped at $1/call · asks for approval above $1 per call

### image.remove_background

Remove image background — Deterministic background removal for images.

id: `rembg.remove-background` (grant it via `capabilities = […]`) · provider: rembg · transforms input · billed per asset

Parameters:

- `image` (file, required) — Input image file.

Returns:

- `assetId` (asset-ref) — Guild asset id.
- `mimeType` (string) — Output MIME type.
- `provider` (string) — Resolved provider.

Limits: timeout 60s · up to 20 MB

## Video

### video.generate

Generate video — Generate a video from a text prompt.

id: `seedance.generate` (grant it via `capabilities = […]`) · provider: bytedance · generates media · billed per second · default provider for this action

Parameters:

- `prompt` (string, required) — Video prompt.
- `duration` (integer) — Duration in seconds. default: 5 — 1–10
- `ratio` (enum) — Aspect ratio. 16:9 · 9:16 · 1:1 — default: "16:9"

Returns:

- `assetId` (asset-ref) — Guild asset id.
- `mimeType` (string) — Output MIME type.
- `provider` (string) — Resolved provider.

Limits: timeout 300s · up to 10s duration · capped at $5/call · asks for approval above $5 per call

### video.generate (alibaba)

Generate with Wan 2.7 — Staged Wan2.7 text-to-video; unavailable until supplier release acceptance.

id: `wan.t2v` (grant it via `capabilities = […]`) · provider: alibaba · generates media · billed per second

Parameters:

- `max_cost_usd` (number) — Maximum supplier cost accepted; unavailable for unverified clip continuation. min 0
- `prompt` (string, required) — Video prompt up to 5000 characters.
- `negative_prompt` (string) — Exclude these elements; up to 500 characters.
- `audio_url` (url) — Optional driving audio URL.
- `ratio` (enum) — Output aspect ratio. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 — default: "16:9"
- `duration` (integer) — Requested output seconds. default: 5 — 2–15
- `resolution` (enum) — Output resolution. 720P · 1080P — default: "1080P"
- `watermark` (boolean) — Include watermark. default: false
- `seed` (integer) — Random seed. 0–2147483647
- `prompt_extend` (boolean) — Rewrite the prompt before generation. default: true

Returns:

- `assetId` (asset-ref) — Generated video asset.
- `mimeType` (string) — Output MIME type.
- `provider` (string) — Resolved provider.

Limits: timeout 300s · up to 15s duration · capped at $5/call

### video.generate (alibaba)

Generate with HappyHorse 1.1 — Staged HappyHorse 1.1 text-to-video. Only the documented five-second request is supported; unavailable until release acceptance.

id: `happyhorse.t2v` (grant it via `capabilities = […]`) · provider: alibaba · generates media · billed per second

Parameters:

- `max_cost_usd` (number) — Maximum supplier cost accepted; unavailable for unverified clip continuation. min 0
- `prompt` (string, required) — Video prompt: up to 5000 non-Chinese or 2500 Chinese characters.
- `ratio` (enum) — Output aspect ratio. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 · 5:4 · 9:21 · 21:9 — default: "16:9"
- `duration` (integer) — Requested output seconds. default: 5 — 5–5
- `resolution` (enum) — Output resolution. 480P · 720P · 1080P — default: "1080P"
- `watermark` (boolean) — Include watermark. default: true
- `seed` (integer) — Random seed. 0–2147483647

Returns:

- `assetId` (asset-ref) — Generated video asset.
- `mimeType` (string) — Output MIME type.
- `provider` (string) — Resolved provider.

Limits: timeout 300s · up to 5s duration · capped at $5/call

### video.generate (minimax)

Generate with MiniMax-H3 — Generate MiniMax-H3 video using a prompt and optional public media URLs. Requested duration is billed rounded up to whole seconds.

id: `minimax.h3` (grant it via `capabilities = […]`) · provider: minimax · generates media · billed per second

Parameters:

- `max_cost_usd` (number) — Maximum supplier cost accepted. min 0
- `prompt` (string, required) — Video prompt.
- `quality` (enum, required) — Required H3 generation quality. low · high
- `duration_s` (number) — Requested seconds, billed rounded up. default: 5 — 3–15
- `resolution` (enum) — Output resolution. 480p · 768p · 1080p — default: "768p"
- `aspect_ratio` (enum) — Output aspect ratio. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 — default: "16:9"
- `watermark` (boolean) — Include watermark. default: false
- `enhance` (boolean) — Enhance prompt. default: true
- `priority` (integer) — Normal 1000 or immediate 0 priority. default: 1000 — 0–1000
- `seed` (integer) — Nonnegative safe integer seed. 0–9007199254740991
- `first_frame_image_url` (url) — Optional first frame URL.
- `last_frame_image_url` (url) — Optional last frame; requires a first frame.
- `reference_video_url` (array) — At most one public video URL; cannot combine references and frames.
- `reference_image_url` (array) — One to four public image URLs; cannot combine references and frames.

Returns:

- `assetId` (asset-ref) — Generated video asset.
- `mimeType` (string) — Output MIME type.
- `provider` (string) — Resolved provider.

Limits: timeout 300s · up to 15s duration · capped at $5/call

### video.from_image

Image to video — Generate with the existing Wan2.6 I2V Flash wrapper from a public image URL.

id: `mm.i2v` (grant it via `capabilities = […]`) · provider: alibaba · generates media · billed per second · default provider for this action

Parameters:

- `image` (url, required) — Public first-frame image URL.
- `prompt` (string) — Motion/video prompt.
- `duration` (integer) — Duration in seconds. default: 5 — 1–10

Returns:

- `assetId` (asset-ref) — Guild asset id.
- `mimeType` (string) — Output MIME type.
- `provider` (string) — Resolved provider.

Limits: timeout 300s · up to 10s duration · capped at $5/call · asks for approval above $5 per call

### video.from_image (alibaba)

Animate with Wan 2.7 — Staged Wan2.7 frame or clip video. Full reported continuation duration is billable; unavailable until release acceptance.

id: `wan.i2v` (grant it via `capabilities = […]`) · provider: alibaba · generates media · billed per second

Parameters:

- `max_cost_usd` (number) — Maximum supplier cost accepted; unavailable for unverified clip continuation. min 0
- `media` (array, required) — Native media objects with type and public url: first_frame with optional last_frame/driving_audio, or first_clip with optional last_frame.
- `prompt` (string) — Optional video prompt up to 5000 characters.
- `negative_prompt` (string) — Exclude these elements; up to 500 characters.
- `duration` (integer) — Requested output seconds. default: 5 — 2–15
- `resolution` (enum) — Output resolution. 720P · 1080P — default: "1080P"
- `watermark` (boolean) — Include watermark. default: false
- `seed` (integer) — Random seed. 0–2147483647
- `prompt_extend` (boolean) — Rewrite the prompt before generation. default: true

Returns:

- `assetId` (asset-ref) — Generated video asset.
- `mimeType` (string) — Output MIME type.
- `provider` (string) — Resolved provider.

Limits: timeout 300s · up to 15s duration · capped at $5/call

## Voice

### voice.transcribe

Transcribe voice with Fish Audio — Default transcription for audio and video files.

id: `fish-audio.transcribe` (grant it via `capabilities = […]`) · provider: fish-audio · transforms input · billed per minute

Parameters:

- `audio` (file, required) — Audio or video file to transcribe.
- `language` (string) — Language code or auto. default: "auto"
- `format` (enum) — Transcript output format. text · json · srt — default: "text"

Returns:

- `text` (string) — Transcript text.
- `language` (string) — Detected or requested language.
- `provider` (string) — Resolved provider.

Limits: timeout 120s · up to 50 MB · up to 3600s duration