01
Create a scoped API key.
Use API keys in the Starzero app’s settings. Start with a processed library you can access. Search requires library:search; reading analysis resources requires appropriate library access such as library:read.
DEVELOPERS / STARZERO API & MCPUnderstand video.
Understand video.
Build what
happens next.
Turn footage into searchable moments, structured context, and new productions. Build with individual APIs or connect your assistant to Starzero’s media and production tools through MCP.
BUILD DISCOVERY
Find visual content and dialogue at moment, shot, scene, or media boundaries.
BUILD UNDERSTANDING
Use transcripts, summaries, speakers, narrative threads, scenes, and shot data.
BUILD PRODUCTION
Connect reframing, rendering, agent chats, and workflow orchestration to your product.
BUILD AROUND THE JOBThe video layer
The video layer
in your product.
Start with one capability. Connect understanding and production wherever they belong in your application.
BUILD / DISCOVERY IN YOUR DAMFind the moment.
Find the moment.
Return the source.
Put natural-language search inside your own media application. Search visual content and dialogue across a library, then use returned media and time boundaries to take users to the relevant footage.
Explore the search request ↓- Input
- A query, an accessible library, and optional media filters.
- Operation
POST /library/{libraryId}/search/unified- Build with the result
- Search candidates and associated media for your own results view or source player.
BUILD / CONTEXT FOR YOUR APPLICATIONGive software
Give software
the shape of the story.
Use short and detailed summaries, follow narrative threads through scenes, and inspect shot boundaries. Connect transcript segments to speakers and use annotated names where available.
Retrieve an analysis resource ↓- Input
- A processed video in an accessible library.
- Operation
GET /library/{libraryId}/media/{mediaId}/data/{resource}- Build with the result
- Summary views, scene navigation, source research, and context for your own assistant.
BUILD / A RECURRING CONTENT OPERATIONFrom matching moments
From matching moments
to the next production.
Assemble material from several videos, reframe a segment, or give a production brief to Starzero’s agents. Connect longer workflows to the systems that receive and review the output.
Connect the production tools ↓- Input
- Source media, output requirements, and creative direction.
- MCP tools
create_compilationreframe_mediaagent_create_chat- Build with the result
- Clip production, portrait versions, agent-directed edits, and repeatable media workflows.
START WITH A LIBRARY YOU CAN ACCESSMake the first call.
Make the first call.
Then build around it.
Use the REST API for direct integration, or the remote MCP server to give a compatible assistant access to Starzero tools.
02
Search the content.
Replace the placeholders with your library ID and key. This request combines visual and transcript search with scene boundaries.
curl -X POST \
"https://api.starzero.ai/library/YOUR_LIBRARY_ID/search/unified" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"a speaker discussing the product launch","visualBoundary":"scene"}'The response includes search results and related media records. Use the actual returned media IDs for the next request.
03
Retrieve the source understanding.
Use an accessible media ID to retrieve a summary. Other resources include narrative_threads, scenes, shots, and speakers.
curl --location \
"https://api.starzero.ai/library/YOUR_LIBRARY_ID/media/YOUR_MEDIA_ID/data/summary" \
-H "Authorization: Bearer YOUR_API_KEY"Examples require your account and processed media. Keep keys in your own trusted environment; this page does not accept or execute them.
01
Add Starzero to your client.
Use the remote server address below in an MCP-compatible assistant and follow its authorization flow. The client and your account access determine which actions are available.
https://mcp.starzero.ai/mcp02
Start with discovery.
Ask the assistant to list your libraries, search the selected library, and retrieve the transcript or source context for relevant media.
list_librariessearch_unifiedsearch_visualget_transcript_full03
Direct a production.
Bring relevant material into an agent chat, create a compilation, or reframe a segment. Orchestrate larger jobs and inspect their progress through the available task tools.
agent_create_chatcreate_compilationreframe_mediataskulator_launch“Find the product-demo moments in this library, show me the candidates, then have Starzero build a captioned portrait cut.”
CONNECT IN BOTH DIRECTIONSYour assistant
Your assistant
can use Starzero.
Starzero can use your tools.
The Starzero MCP server exposes media and production tools to compatible clients. Separately, you can connect external MCP plugins inside Starzero so its agents can work with other services alongside the built-in video tools.
For recurring jobs, use workflow templates, variables, task budgets, and result callbacks. Scope an integration around the actual processing lifecycle and the systems receiving the output.
Explore workflow operations ↗Before production traffic.
Can processing take longer than a normal API call?
Yes. Rendering, reframing, and generation can be long-running work. Plan for progress tracking, suitable timeouts, and result handling. Workflow callbacks can connect job completion to your systems.
How should we plan usage and limits?
Discuss expected media volume, concurrency, operations, and delivery requirements with the team. Account access, credits, and endpoint limits apply; confirm the commercial arrangement before sizing a production integration.
Can we start with just search or summaries?
Yes. You can use the media understanding and search surfaces without building a full editor. Add reframing, rendering, or agent production where your product needs them.