По-русски

What the API can do

Anything you do in the studio by hand, an agent can do with a key. Create one in the studio: «⋮» → API → Create key. The key’s rights cut the list itself: a read-only key never even sees the writing tools.

The list below is printed from the studio registry — it cannot fall behind it.

claude mcp add --transport http vini https://vinistudio.app/mcp \
  --header "Authorization: Bearer $VINI_API_KEY"
ToolWhat it doesPrice
reads
describe_studioThe studio catalogue: which nodes exist, what each one is for, their inputs, outputs and parameters.
model_adviceHow the models actually differ, when to pick which, and what we verified ourselves.
list_skillsStudio and user techniques: what each one does, which nodes it fits and which model it was written for.
read_project_graphWhat is on the project canvas right now: nodes (card title, parameters, result status) and the wires between them.
read_run_historyRun history of the project: which nodes ran, when, with what outcome and at what price.
traceThe causal chain behind a result: why this node or this material came out the way it did.
describe_sceneContents of a scene container: what is inside it, what carries it and who changed it along the way.
list_my_elementsThe user's element library (characters, objects, locations) — id, name, role, start of the description.
describe_elementThe full description of ONE library element by id, when the list shows it truncated.
list_my_promptsThe user's saved prompts (id + title).
list_my_designsThe user's design systems (id + title).
list_generatorsBuilt-in generators — a ready-made setup for a node: model, format and prompt in one piece.
billing_statusHow much money is on the account right now, and whether it is being metered at all.
billing_historyWhere the money went: total for a period, broken down by kind of work, model, project and day.
list_projectsProjects on this account: name, when they were last edited, and the address that opens them.
list_artifactsFinished materials — frames, clips, audio.
get_artifactOne material and a link to download it.
list_jobsGeneration jobs: what is running right now and how the recent ones ended.
get_jobThe state of a single job by its job_id.
price_quoteWhat a run will cost — before it happens.
builds
create_projectCreate a new empty studio project and get its address.
apply_graph_opsBuild or change the project graph: add nodes, set their fields, connect them with wires.
assemble_videoStitch clips into one video.
edit_videoTrim a video at the ends.
extract_audioTake the audio track out of a video.
import_clipFetch a video by link so you can work with it.
generates
generate_textWrite text with a model — a short piece to a brief.metered
generate_imageDraw a frame from a description and references.metered
generate_musicCompose a music bed from a description of the mood.metered
generate_voiceRead text aloud in the chosen voice.metered
clone_voiceMake a voice from a recording, to narrate with it later.metered
isolate_audioPull clean sound without speech out of a track — noise, music, ambience.metered
dub_videoRe-voice a finished clip in another language.metered
upscale_imageEnlarge a frame without losing sharpness.metered
write_scriptBreak an idea into scenes: what happens, what is in frame, who speaks.metered
write_scene_promptsTurn a scene into ready briefs for the frame and for the clip.metered
rewrite_sceneRewrite one scene without touching the others.metered
direct_sceneBreak a scene down as a director would: camera movement, action, rhythm.metered
make_subtitlesMake subtitles for a clip from its audio.metered
normalize_subtitlesTidy subtitles: line breaks, timings, punctuation.metered
decorate_videoDress a clip up — captions, plates, accents over the picture.metered
generate_videoShoot a clip.metered
lipsync_videoMatch speech to the character's lips in a finished clip.metered

Machine-readable version for your agent — /mcp/llms.txt, no authentication required.
Not there yet: running a whole project with one call, and managing keys with a key — keys are created in the browser only.