Trends

A trend is a ready-made recipe: you supply the inputs it asks for (a photo, a video, a short text or a choice) and Kolbo runs the whole recipe as one job. The recipe's steps and prompts stay private; you see its inputs, examples, price and the finished output.

Three catalogs are served through the same routes, distinguished by the slug:

Endpoints

GET  /api/v1/trends                      list trends (?family=)
GET  /api/v1/trends/motion               list Motion Library presets as trends
GET  /api/v1/trends/styles               list Morphious catalog styles as trends
GET  /api/v1/trends/:slug                one trend (also /motion/:slug, /style/:slug)
POST /api/v1/trends/:slug/estimate       free price quote (also /motion/:slug/estimate, /style/:slug/estimate)
POST /api/v1/trends/:slug/runs           start a run (also /motion/:slug/runs, /style/:slug/runs)
GET  /api/v1/trends/runs                 your runs (?project_id=&limit=)
GET  /api/v1/trends/runs/:runId          one run
POST /api/v1/trends/runs/:runId/cancel   cancel a run

Responses use { "status": true, "data": { ... } }; errors use { "status": false, "code": "...", "message": "..." }. Starting and cancelling a run need a write-enabled API key (403 FORBIDDEN). Limits: 120 requests per minute per account across these routes, and estimate and run calls are additionally capped at 20 per minute. Both count every request, and a limited request receives the plain-text body Too many requests, please try again later.

Read a trend

GET /api/v1/trends returns data: { trends: [...], free_trials_left }. GET /api/v1/trends/:slug returns one trend plus free_trials_left. A missing slug returns 404 TREND_NOT_FOUND.

Each entry in inputs:

Estimate and run

POST /api/v1/trends/:slug/estimate is free and runs nothing. POST /api/v1/trends/:slug/runs starts the run and spends credits.

{
  "project_id": "YOUR_PROJECT_ID",
  "inputs": { "slot_1": ["https://cdn.example.com/me-front.jpg", "https://cdn.example.com/me-side.jpg"] },
  "resolution": "720p",
  "idempotency_key": "trend-run-0001"
}

A run may use at most 25 images in total (400 INVALID_INPUT).

The estimate returns data: { trend, total_credits, known_credits, provisional, resolution?, aspect_ratio?, preview? }. provisional: true means some steps settle at their measured price (for example a step priced by your video's length).

Free trials. Each account has 2 free trend runs. Send "free_trial": true on a trend whose free_trial is true; the run is paid with credits granted for it, up to 300, so it works with an empty balance. Trials run only in your own projects. When none are left the run returns 402 TRIAL_USED; a trend outside the trial returns 400 TRIAL_NOT_AVAILABLE. Trial runs cannot be cancelled (409 TRIAL_RUN_NOT_CANCELLABLE).

Track a run

Starting, reading and cancelling all return the same run object:

Poll GET /api/v1/trends/runs/:runId until status is completed, failed, cancelled or needs_attention. An unknown run, or one that is not yours, returns 404 RUN_NOT_FOUND. GET /api/v1/trends/runs returns data: { runs: [...] }, newest first, for one project (project_id) or all of your projects; limit is up to 100 (default 30).

Motion Library

The Motion Library is a read-only catalog of motion presets. Each one is also runnable as a trend under motion/<slug> (above).

GET /api/v1/recast-presets          list presets
GET /api/v1/recast-presets/:slug    one preset

Query parameters for the list: section (kolbo or community), category (up to 40 characters), limit (1–200, default 60) and offset (default 0). The list returns data: { presets, total, offset, limit }; each preset has slug, name, summary, category, section, mode, model, source, prompt, references, examples and badges. An unknown slug returns 404 PRESET_NOT_FOUND.

MCP

list_trends, get_trend, estimate_trend_run, run_trend, get_trend_run, list_trend_runs and cancel_trend_run. estimate_trend_run is free; run_trend spends credits.