Video

Colossyan
API integration

Ship Video features without building the integration. Full Colossyan API access via Proxy and 10+ MCP-ready tools for AI agents — extend models and mappings to fit your product.

Talk to us

Use Cases

Why integrate with Colossyan

Common scenarios for SaaS companies building Colossyan integrations for their customers.

01

Embed AI Video Creation Inside Knowledge Platforms

Wikis, LMS, and documentation tools can let users transform written content into presenter-led videos without leaving the app. This turns static articles into engaging training assets and increases content consumption rates.

02

Scale Personalized Video Outreach

Sales engagement and marketing automation platforms can loop through prospect lists and generate hundreds of variable-injected videos from a single template. This unlocks a high-conversion channel that would otherwise require manual production.

03

Automate Training Content for L&D Teams

HR tech and corporate learning platforms can offer one-click video generation from policies, SOPs, or onboarding documents. This eliminates the studio, actor, and editing costs L&D teams currently pay to produce compliance content.

04

Auto-Populate Media Libraries with Rendered Videos

Content management and course authoring tools can pull finished video URLs, thumbnails, duration, and file size directly into their media library. Users get a fully synced asset catalog without manual uploads.

05

Dynamic Video Responses in Support Workflows

Helpdesk and customer education platforms can generate short avatar-led explainer videos on demand from ticket content or macro text. Support teams resolve complex issues faster with visual walkthroughs instead of long text replies.

What You Can Build

Ship these features with Truto + Colossyan

Concrete product features your team can ship faster by leveraging Truto’s Colossyan integration instead of building from scratch.

01

Native Avatar and Voice Picker

Render Colossyan's actors and voices inside your own UI so users can browse and select presenters without leaving your product.

02

Article-to-Video Button

Convert any long-form text into a Colossyan draft script using the knowledge-to-draft endpoint and kick off video generation in one click.

03

Template-Based Bulk Video Generation

Reference a pre-designed Colossyan template and inject per-recipient variables to produce personalized videos at scale from your workflow engine.

04

Async Render Status Dashboard

Track in-progress video generation jobs by polling job status and surface completion state, thumbnails, and public URLs inside your app.

05

Auto-Synced Video Media Library

Pull rendered video URLs, thumbnails, duration, and file size into your platform's media library the moment a job completes.

06

Custom Avatar Provisioning

Let end users create branded actor assets in Colossyan directly from your product's settings, keeping avatar management in-app.

SuperAI

Colossyan AI agent tools

Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.

list_all_colossyan_assets_actors

List avatars available in your Colossyan workspace. Returns each avatar with id, name, display_name, preview_url, version, type, gender, default_voice, views, features, and other attributes.

create_a_colossyan_assets_actor

Create a new avatar in Colossyan. Returns: name.

list_all_colossyan_assets_voices

List voices available to the workspace in Colossyan. Returns each voice record with id and voice-specific attributes.

create_a_colossyan_video_generation_jobs_template_job

Create a Colossyan video generation job from a saved template. Returns: id, videoId. Required: templateJobId and the template-specific generation payload.

create_a_colossyan_video_generation_job

Create a new Colossyan video generation job. Returns the queued job identifier and provisioned video id. Required: a JSON request body shaped by Colossyan's VideoGenerationJob schema.

get_single_colossyan_video_generation_job_by_id

Get the status and progress of a Colossyan video generation job by id. Returns: status, videoId, progress, maximumProgress. Required: id.

delete_a_colossyan_video_generation_job_by_id

Delete a Colossyan video generation job by id and stop any ongoing processing. Returns an empty 204 response on success. Required: id.

get_single_colossyan_generated_video_by_id

Get a generated video from Colossyan by id. Returns: id, jobId, publicUrl, thumbnailUrl, name, createdAt, videoSizeBytes, videoDurationSeconds. Required: id.

delete_a_colossyan_generated_video_by_id

Delete a generated video from Colossyan by id. Returns the deleted video record including id, publicUrl, thumbnailUrl, createdAt, name, jobId, videoSizeBytes, and videoDurationSeconds. Required: id.

create_a_colossyan_knowledge_to_draft_generate_draft

Generate a draft in Colossyan from structured textual data. Returns: url. Requires a request body. Required: summary.

Why Truto

Why use Truto’s MCP server for Colossyan

Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 550+ integrations.

01

Auto-generated, always up to date

Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.

02

Fine-grained access control

Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.

03

Multi-tenant by design

Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.

04

Works with every MCP client

Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.

05

Built-in auth, rate limits, and error handling

Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.

06

Expiring and auditable servers

Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.

How It Works

From zero to integrated

Go live with Colossyan in under an hour. No boilerplate, no maintenance burden.

01

Link your customer’s Colossyan account

Use Truto’s frontend SDK to connect your customer’s Colossyan account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

02

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

03

Call our API, we call Colossyan

Truto’s Proxy API is a 1-to-1 mapping of the Colossyan API. You call us, we call Colossyan, and pass the response back in the same cycle.

04

Unified response format

Every response follows a single format across all integrations. We translate Colossyan’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about Colossyan on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

How do end users connect their Colossyan account through Truto?

Colossyan uses API key authentication. Truto handles the credential capture, secure storage, and injection into every downstream request, so your users only paste their key once and your backend never touches it.

How does video generation work given it's asynchronous?

You create a job with create_a_colossyan_video_generation_job (or the template variant), then poll get_single_colossyan_video_generation_job_by_id for status. Once complete, fetch the rendered asset via get_single_colossyan_generated_video_by_id to retrieve the public URL, thumbnail, duration, and file size.

Can we generate videos from templates with dynamic variables?

Yes. create_a_colossyan_video_generation_jobs_template_job accepts a template ID plus a payload of variables, which is the recommended path for high-volume personalized video use cases like sales outreach.

Can we let users pick avatars and voices from within our UI?

Yes. list_all_colossyan_assets_actors and list_all_colossyan_assets_voices return the full catalog of available presenters and voice options, which you can render as native selectors in your own product.

Can we convert existing documents into video scripts?

Yes. create_a_colossyan_knowledge_to_draft_generate_draft accepts textual content and returns an optimized draft that can then be passed into a generation job, making it ideal for article-to-video workflows.

Can we clean up videos and jobs created through the integration?

Yes. delete_a_colossyan_video_generation_job_by_id removes generation jobs and delete_a_colossyan_generated_video_by_id removes rendered videos, letting you enforce retention policies or user-initiated deletions from your app.

ColossyanAPI integration