Skip to content
agent-media docs
IntroductionStart here: what Agent Media does and which path to follow.↵QuickstartConnect, check your account, upload references and generate.↵Core conceptsAccounts, connectors, tools, models, credits and jobs.↵Connect your agentClaude, Claude Code, ChatGPT, Codex, Cursor and MCP setup.↵Agent workflowThe sequence from request to finished media.↵Tool referenceTools, arguments and schemas from the official connector.↵Upload imagesMultiple reference images, drag and drop, 24-hour expiry.↵Choose a modelVideo modes, image models, audio, supported inputs and limits.↵Write better promptsRealism, framing and reference guidance.↵RecipesProduct images, talking heads and consistent characters.↵Account and billingPaid credits, account checks, payments and draft recovery.↵Generation pricingQuotes and model costs.↵REST APIAuthentication, endpoints and OpenAPI.↵Jobs and retriesRecover timeouts without duplicate generations.↵
Public documentation · No sign-in required
Documentation / Core concepts

Get started

Core concepts

Understand the account, connector, tools, models and jobs before your first run.

On this page

Your account

The hosted account owns your credits, generations and temporary upload sessions. Connecting an agent authorizes it to act on that account. Do not paste account keys, login codes or storage credentials into shared chats.

Connector and public skill

The MCP connector exposes callable tools. The public skill explains how to use them together. Installing a skill alone does not establish the authenticated connector connection.

Connect an agent →Public skill source ↗

Tools and models

A tool is an action such as generating an image, quoting a request or checking a job. A model is the provider-backed engine used for that action. Video modes determine whether the input is a text prompt, a starting frame or references.

Tool reference →Choose a model →

Asynchronous jobs

Generation returns a job ID before the media is finished. Poll that ID with get_run_status. Keep the original ID through delays and status errors; creating a new request can create another paid run.

Quotes and credits

A quote estimates the intended request. The account balance is a snapshot, not a reservation. Generation performs the final credit checks. Connection checks, quotes and temporary uploads do not grant credits.