# Kinoforge - agent and LLM API guide (llms.txt)

Kinoforge turns a brief and an optional reference image into a finished, narrated video, and finds the best short clips inside a long video.
One key and one credit balance cover the whole job: writing, visuals, narration, captions, editing, storage and delivery. No model accounts, prompts or editing software are needed.
This index lists the guides an autonomous agent reads to drive it over HTTP. Read the API basics first, then only the guides your task needs.

Product overview for people: https://videogpt.dev/llms.txt
Base URL: https://agents.kinoforge.dev

## What you can make
- Clips: Give a long video (a link or a file). Get its strongest short moments, each with a title, a hook and exact start and end times, ready to cut or to render as vertical clips.
- Story: Give an idea, a script or a brief, optionally with a reference image. Get a planned set of scenes, a picture or AI clip per scene, narration, optional music, and a finished video. Useful for social media, marketing, education, and entertainment.
- Series: Give a premise and a recurring cast. Get connected episodes that keep the same characters and look, each made like a Story.
- Canvas (on for some accounts): connect nodes (a prompt, an image, a clip, a join) into your own video recipe and run it.
- Publishing: once the account holder connects a YouTube channel in the dashboard, you publish finished videos and clips to it yourself, for a few credits each and within YouTube's rules.

## Discover
GET /v1/segments
   -> each segment's name, a plain description, its status ("available" or "planned"), its features, and "start_here": the few routes to begin with ({"method", "path", "does"}).
GET /v1/features
   -> the features on for this account.
Some answers are long (the model list most of all). Filter them instead of reading them whole, for example:
   curl -s -H "Authorization: Bearer $KEY" "https://agents.kinoforge.dev/v1/videogen/models?kind=video&limit=100" | jq '.models[] | {provider, model, credits}'

## Guides
- https://agents.kinoforge.dev/llms.api.txt: API basics. Read it before any call: keys, limits, errors, features, live updates, media and deleting.
- https://agents.kinoforge.dev/llms.billing.txt: Credits and prices. Read it to price work before you spend and to read what was charged.
- https://agents.kinoforge.dev/llms.story.txt: Make a video. Read it to make a video from a brief, step by step.
- https://agents.kinoforge.dev/llms.styles.txt: Visual styles. Read it to set or make the look of every scene.
- https://agents.kinoforge.dev/llms.models.txt: Models. Read it to pick the model each step runs on.
- https://agents.kinoforge.dev/llms.screenwriters.txt: Screenwriters. Read it to reuse or make the agent that writes the script.
- https://agents.kinoforge.dev/llms.series.txt: Series. Read it to make connected episodes with a recurring cast.
- https://agents.kinoforge.dev/llms.clips.txt: Clips. Read it to find and render the best short clips in a long video.
- https://agents.kinoforge.dev/llms.publish.txt: Publishing. Read it to publish finished videos and clips to a connected channel.
- https://agents.kinoforge.dev/llms.canvas.txt: Canvas. Read it to build a video from connected nodes.
- https://agents.kinoforge.dev/llms-full.txt: every guide in one file.

These guides are living; capabilities are added over time.