Kolbo.AIKolbo.AI Docs
Developer API

Morphious Styles

List the Morphious look catalog, save your own styles from reference images, and apply them to a video.

A Morphious style is a whole-video look (for example an illustration or animation style). You apply one by passing its id as style_id to a Morphious model in Video to Video or Elements; each page lists which Morphious models accept a style. Kolbo redraws the clip's first frame in the style, then transfers the source's movement onto it. The style's internal instructions are never returned.

Endpoints

GET    /api/v1/morphious-styles                    list the catalog plus your custom styles
POST   /api/v1/morphious-styles/custom             create a custom style
DELETE /api/v1/morphious-styles/custom/:id         delete one of your custom styles
POST   /api/v1/morphious-styles/original-motion    add the smooth 24 fps version of a styled result as its own card

All four use your API key (X-API-Key). Responses use { "status": true, "data": { ... } }; errors use { "status": false, "code": "...", "message": "..." }. The three POST/DELETE routes need a write-enabled key (403 FORBIDDEN otherwise). The routes share one limit of 120 requests per minute per account, counting every request; when exceeded the response is the plain-text body Too many requests, please try again later.

List styles

GET /api/v1/morphious-styles returns data: { styles: [...] }: published catalog styles plus your own custom styles.

FieldTypeNotes
idstringPass this as style_id
slugstringStable name of the style
namestringDisplay name
cover, preview, thumbstring | nullCard media
motionobject | nullThe style's motion settings, when it has any
custombooleantrue for a style you created

Create a custom style

POST /api/v1/morphious-styles/custom

{ "name": "Paper cutout", "image_urls": ["https://cdn.example.com/look-1.jpg", "https://cdn.example.com/look-2.jpg"] }
FieldTypeRequiredNotes
namestringYesTrimmed and cut to 60 characters
image_urlsstring[]Yes1–8 distinct https:// image URLs that show the look. imageUrls is also accepted. The first image becomes the cover

You can keep up to 50 custom styles. The response is data with the new style in the list shape above. Validation failures (missing name, wrong image count, non-https URL, style limit) return 400 INVALID_STYLE with the reason in message.

Delete a custom style

DELETE /api/v1/morphious-styles/custom/:id archives one of your own styles and returns data: { deleted: true }. A catalog style, someone else's style or an unknown id returns 404 STYLE_NOT_FOUND.

Original Motion

A styled run is delivered at its style's frame rate. When the run also kept a smooth 24 fps master, POST /api/v1/morphious-styles/original-motion with { "generation_id": "..." } (also generationId) adds that master to the same session as its own result. It renders nothing and costs no credits. Repeating the call returns the same result.

The response is data: { generationId, sessionId, videoUrl, created }, where created is false when the card already existed. A generation that is not yours, or whose session you can no longer create in, returns 404 NOT_FOUND; a result without a smooth master returns 400 NO_ORIGINAL_MOTION.

Run a style without a generation request

Each catalog style is also available as a one-step trend at /api/v1/trends/style/:slug, with a free price estimate before you run it. See Trends.

MCP

list_morphious_styles, create_morphious_style and delete_morphious_style. Pass the chosen id as style_id to generate_video_from_video or generate_elements.