Capabilities

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, and it can run only those: an agent with none granted has none. 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. The id on each card is what you put in capabilities = […] in agent.toml, the API's capabilities field, or sky agent create --capability <id> to grant it; the list is empty unless you add ids, and the platform refuses any call outside it. 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_keywordsdataforseoread-only · per rundataforseo.ai-keywords

AI keyword data

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

Parameters

operationenum

Allowlisted operation for this capability. — search-volume — default: "search-volume"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.llm_responsesdataforseoread-only · per rundataforseo.llm-responses

LLM response data

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

Parameters

operationenum

Allowlisted operation for this capability. — live · submit · get — default: "live"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.app_infodataforseoread-only · per rundataforseo.app-info

App information

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

Parameters

operationenum

Allowlisted operation for this capability. — apple-submit · apple-get · google-submit · google-get — default: "apple-submit"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.app_searchdataforseoread-only · per rundataforseo.app-search

App search

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

Parameters

operationenum

Allowlisted operation for this capability. — apple-submit · apple-get · google-submit · google-get — default: "apple-submit"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.backlinksdataforseoread-only · per rundataforseo.backlinks

Backlink analytics

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

Parameters

operationenum

Allowlisted operation for this capability. — anchors · backlinks · referring-domains · summary — default: "anchors"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.business_reviewsdataforseoread-only · per rundataforseo.business-reviews

Business reviews

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

Parameters

operationenum

Allowlisted operation for this capability. — google-submit · google-get · tripadvisor-submit · tripadvisor-get · trustpilot-submit · trustpilot-get — default: "google-submit"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.business_pinterestdataforseoread-only · per rundataforseo.business-pinterest

Pinterest business data

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

Parameters

operationenum

Allowlisted operation for this capability. — live — default: "live"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.content_analysisdataforseoread-only · per rundataforseo.content-analysis

Content analysis

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

Parameters

operationenum

Allowlisted operation for this capability. — phrase-trends · search · summary — default: "phrase-trends"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.technologiesdataforseoread-only · per rundataforseo.technologies

Technology analytics

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

Parameters

operationenum

Allowlisted operation for this capability. — domains · summary — default: "domains"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.keyword_datadataforseoread-only · per rundataforseo.keyword-data

Keyword data

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

Parameters

operationenum

Allowlisted operation for this capability. — bing-search-volume · google-keywords-for-keywords · google-search-volume · google-trends — default: "bing-search-volume"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.labsdataforseoread-only · per rundataforseo.labs

SEO Labs

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

Parameters

operationenum

Allowlisted operation for this capability. — competitors · domain-rank · historical-volume · keyword-ideas · keyword-suggestions · ranked-keywords · related-keywords — default: "competitors"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.amazondataforseoread-only · per rundataforseo.amazon

Amazon marketplace data

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

Parameters

operationenum

Allowlisted operation for this capability. — asin-submit · asin-get · products-submit · products-get · sellers-submit · sellers-get · ready — default: "asin-submit"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

dataforseo.onpagedataforseoread-only · per rundataforseo.onpage

On-page analysis

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

Parameters

operationenum

Allowlisted operation for this capability. — content-parsing · instant-page · lighthouse — default: "content-parsing"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

embedding

embedding.createopenairead-only · per million_tokensembedding.openai

Create embeddings

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

Parameters

inputarrayrequired

Text strings to embed.

modelstring

Embedding model override.

Returns

dataarray

Embedding vectors.

modelstring

Model used.

providerstring

Resolved provider.

timeout 60s

embedding.createvoyageread-only · per million_tokensembedding.voyage

Create embeddings

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

Parameters

inputarrayrequired

Text strings to embed.

modelstring

Embedding model override.

Returns

dataarray

Embedding vectors.

modelstring

Model used.

providerstring

Resolved provider.

timeout 60s

rerank

rerankvoyageread-only · per million_tokensrerank.voyage

Rerank documents

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

Parameters

modelenum

Reranking model. — rerank-3 · rerank-3-lite · rerank-2.5 · rerank-2.5-lite

querystringrequired

Ranking query.

documentsarrayrequired

Candidate documents.

top_kinteger

Maximum results; omission ranks up to 100 documents. — 1–100

Returns

resultsarray

Ranked documents.

modelstring

Model used.

providerstring

Resolved provider.

timeout 60s · up to 100 results

ocr

ocr.parsemistralread-only · per pageocr.mistral

OCR document

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

Parameters

modelenum

OCR model. — mistral-ocr-latest · mistral-ocr-4-1

document_urlurl

Public document URL.

document_base64string

Base64 PDF, PNG or JPEG; data URL MIME must match bytes.

document_typeenum

Use image for an image URL; inline data is detected from bytes. — document · image

Returns

pagesarray

Parsed page content.

providerstring

Resolved provider.

timeout 120s · up to 10 MB

Web

web.searchexaread-only · per runexa.search

Search web

Find public web pages and return sourced search results.

Parameters

querystringrequired

Search query text sent to the web search provider.

limitinteger

Maximum number of search results to return. — default: 8 — 1–20

Returns

resultsarray

Search result objects.

providerstring

Resolved provider.

timeout 30s · up to 20 results

web.fetchexadefaultread-only · per pageexa.contents

Fetch web page

Retrieve readable public URL content as markdown, text, or JSON metadata.

Parameters

urlurlrequired

Public URL to fetch.

formatenum

Returned content format. — markdown · text · json — default: "markdown"

Returns

urlurl

Fetched URL.

contentstring

Normalized content.

providerstring

Resolved provider.

timeout 30s · up to 2 MB

web.fetchtinyfishread-only · per pagetinyfish.fetch

Fetch JS-heavy page

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

Parameters

urlurlrequired

Public URL to fetch.

formatenum

Returned content format. — markdown · text · json — default: "markdown"

Returns

urlurl

Fetched URL.

contentstring

Normalized content.

providerstring

Resolved provider.

timeout 60s · up to 2 MB

web.browsertinyfishread-only · per minutetinyfish.browser

Browser session

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

Parameters

urlurlrequired

Public URL to open.

taskstring

Legacy hint retained for compatibility; session creation does not execute it. — default: "extract readable content"

Returns

urlurl

Opened URL.

contentstring

Session id and connection URLs encoded as JSON.

providerstring

Resolved provider.

timeout 120s · up to 120s duration

web.automatetinyfishacts on a public site · per steptinyfish.agent

Browser automation

Runs browser interactions and returns the completed structured result.

Parameters

urlurlrequired

Public URL where the automation starts.

goalstringrequired

Browser goal to execute.

Returns

urlurl

Starting URL.

providerstring

Resolved provider.

goalstring

Executed browser goal.

statusstring

Terminal automation status.

runIdstring

Automation run id.

stepsinteger

Supplier-reported billable steps.

resultobject

Completed structured result.

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.searchdataforseoread-only · per rundataforseo.serp

Search SERP

Run bounded Google organic search and retrieve owned tasks.

Parameters

operationenum

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"

tasksarray

Provider-native task objects: exactly one for live search; 1-10 for asynchronous submission.

querystring

Query shortcut supported by SERP operations.

localestring

Locale used by the SERP query shortcut. — default: "en-US"

limitinteger

Legacy result-limit hint; provider returns its native result page. — default: 10 — 1–100

task_idstring

Task identifier for task-get operations.

max_cost_usdnumber

Maximum provider cost accepted for POST operations. — 0–10

Returns

resultsarray

Provider result objects.

tasksarray

Provider task receipts.

providerstring

Resolved provider.

operationstring

Resolved operation.

timeout 60s · up to 100 results

Images

image.generateopenaigenerates media · per assetgptimage.generate

Generate image

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

Parameters

promptstringrequired

Image prompt.

sizeenum

Output image size. — 1024x1024 · 1024x1536 · 1536x1024 — default: "1024x1024"

Returns

assetIdasset-ref

Guild asset id.

mimeTypestring

Output MIME type.

providerstring

Resolved provider.

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

image.remove_backgroundrembgtransforms input · per assetrembg.remove-background

Remove image background

Deterministic background removal for images.

Parameters

imagefilerequired

Input image file.

Returns

assetIdasset-ref

Guild asset id.

mimeTypestring

Output MIME type.

providerstring

Resolved provider.

timeout 60s · up to 20 MB

Video

video.generatebytedancedefaultgenerates media · per secondseedance.generate

Generate video

Generate a video from a text prompt.

Parameters

promptstringrequired

Video prompt.

durationinteger

Duration in seconds. — default: 5 — 1–10

ratioenum

Aspect ratio. — 16:9 · 9:16 · 1:1 — default: "16:9"

Returns

assetIdasset-ref

Guild asset id.

mimeTypestring

Output MIME type.

providerstring

Resolved provider.

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

video.generatealibabagenerates media · per secondwan.t2v

Generate with Wan 2.7

Staged Wan2.7 text-to-video; unavailable until supplier release acceptance.

Parameters

max_cost_usdnumber

Maximum supplier cost accepted; unavailable for unverified clip continuation. — min 0

promptstringrequired

Video prompt up to 5000 characters.

negative_promptstring

Exclude these elements; up to 500 characters.

audio_urlurl

Optional driving audio URL.

ratioenum

Output aspect ratio. — 16:9 · 9:16 · 1:1 · 4:3 · 3:4 — default: "16:9"

durationinteger

Requested output seconds. — default: 5 — 2–15

resolutionenum

Output resolution. — 720P · 1080P — default: "1080P"

watermarkboolean

Include watermark. — default: false

seedinteger

Random seed. — 0–2147483647

prompt_extendboolean

Rewrite the prompt before generation. — default: true

Returns

assetIdasset-ref

Generated video asset.

mimeTypestring

Output MIME type.

providerstring

Resolved provider.

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

video.generatealibabagenerates media · per secondhappyhorse.t2v

Generate with HappyHorse 1.1

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

Parameters

max_cost_usdnumber

Maximum supplier cost accepted; unavailable for unverified clip continuation. — min 0

promptstringrequired

Video prompt: up to 5000 non-Chinese or 2500 Chinese characters.

ratioenum

Output aspect ratio. — 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 4:5 · 5:4 · 9:21 · 21:9 — default: "16:9"

durationinteger

Requested output seconds. — default: 5 — 5–5

resolutionenum

Output resolution. — 480P · 720P · 1080P — default: "1080P"

watermarkboolean

Include watermark. — default: true

seedinteger

Random seed. — 0–2147483647

Returns

assetIdasset-ref

Generated video asset.

mimeTypestring

Output MIME type.

providerstring

Resolved provider.

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

video.generateminimaxgenerates media · per secondminimax.h3

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.

Parameters

max_cost_usdnumber

Maximum supplier cost accepted. — min 0

promptstringrequired

Video prompt.

qualityenumrequired

Required H3 generation quality. — low · high

duration_snumber

Requested seconds, billed rounded up. — default: 5 — 3–15

resolutionenum

Output resolution. — 480p · 768p · 1080p — default: "768p"

aspect_ratioenum

Output aspect ratio. — 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 — default: "16:9"

watermarkboolean

Include watermark. — default: false

enhanceboolean

Enhance prompt. — default: true

priorityinteger

Normal 1000 or immediate 0 priority. — default: 1000 — 0–1000

seedinteger

Nonnegative safe integer seed. — 0–9007199254740991

first_frame_image_urlurl

Optional first frame URL.

last_frame_image_urlurl

Optional last frame; requires a first frame.

reference_video_urlarray

At most one public video URL; cannot combine references and frames.

reference_image_urlarray

One to four public image URLs; cannot combine references and frames.

Returns

assetIdasset-ref

Generated video asset.

mimeTypestring

Output MIME type.

providerstring

Resolved provider.

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

video.from_imagealibabadefaultgenerates media · per secondmm.i2v

Image to video

Generate with the existing Wan2.6 I2V Flash wrapper from a public image URL.

Parameters

imageurlrequired

Public first-frame image URL.

promptstring

Motion/video prompt.

durationinteger

Duration in seconds. — default: 5 — 1–10

Returns

assetIdasset-ref

Guild asset id.

mimeTypestring

Output MIME type.

providerstring

Resolved provider.

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

video.from_imagealibabagenerates media · per secondwan.i2v

Animate with Wan 2.7

Staged Wan2.7 frame or clip video. Full reported continuation duration is billable; unavailable until release acceptance.

Parameters

max_cost_usdnumber

Maximum supplier cost accepted; unavailable for unverified clip continuation. — min 0

mediaarrayrequired

Native media objects with type and public url: first_frame with optional last_frame/driving_audio, or first_clip with optional last_frame.

promptstring

Optional video prompt up to 5000 characters.

negative_promptstring

Exclude these elements; up to 500 characters.

durationinteger

Requested output seconds. — default: 5 — 2–15

resolutionenum

Output resolution. — 720P · 1080P — default: "1080P"

watermarkboolean

Include watermark. — default: false

seedinteger

Random seed. — 0–2147483647

prompt_extendboolean

Rewrite the prompt before generation. — default: true

Returns

assetIdasset-ref

Generated video asset.

mimeTypestring

Output MIME type.

providerstring

Resolved provider.

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

Voice

voice.transcribefish-audiotransforms input · per minutefish-audio.transcribe

Transcribe voice with Fish Audio

Default transcription for audio and video files.

Parameters

audiofilerequired

Audio or video file to transcribe.

languagestring

Language code or auto. — default: "auto"

formatenum

Transcript output format. — text · json · srt — default: "text"

Returns

textstring

Transcript text.

languagestring

Detected or requested language.

providerstring

Resolved provider.

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