Glif

Create or continue a durable Glif project from natural language. Glif's server-side agent chooses models, tools, and multi-step media workflows. Optional `intelligence` picks the agent: lite, smart, or genius. Without a tier, new projects use your preferred model and existing ones keep theirs. A request that iterates on, refines, animates, or otherwise references anything Glif previously made in this conversation needs the `project_id` from that earlier result — omitting it starts a blank project with no memory of prior media, so omitting `project_id` suits genuinely new, unrelated work. Glif handles batches itself: a series (multiple characters, scenes, variations) works best as one call describing the whole series, kept in one project. Returns immediately with a `jobId`. Generation often finishes within a minute but can take longer. `get_job_status` waits up to 15 seconds by default, which suits clients without code execution, sleep or another polling mechanism. Its optional `wait_seconds` value (0 to 30) overrides that; 0 returns at once. The completed call returns the generated media URLs, with the same media in `structuredContent`. `view_media` applies after completion, not to `working` polls — called once with `project_id`, it renders the final gallery in UI-capable hosts. In clients with inline rendering, pasted media URLs are redundant; a raw URL is useful only when the client lacks inline rendering or the user asks for one (a sandboxed agent may need its CSP / allowed-domains settings adjusted to load it).

compose_project

Check a Glif project job started by `compose_project`, using its `job_id`. Wait up to 15 seconds for new saved public text, generated media or a status change. Pass the previous `progressCursor` as `progress_cursor` to wait for a change instead of receiving the same output immediately. Without a cursor, already available text or media returns promptly. The optional `wait_seconds` value (0 to 30) overrides the wait; 0 returns at once. Working responses include saved public messages and media links, not token streaming. When nothing changed since the passed `progress_cursor`, the text says so and repeats no output. Finished responses return the full result. Keep checking while working, then report the completed result or failure. For input_required, ask for the required input instead. End early only for an explicit background request. Do not assume this chat will receive automatic updates. Job status records expire ~30 minutes after the job finishes. Saved results remain available through `get_project` when a client cannot keep polling. Do not call `compose_project` again while this job is working. The same project refuses it, and a new project starts a separate billable job that does not speed up this one.

get_job_status

Read project state, active job, recent messages, and generated media for a Glif project.

get_project

Reads one of the authenticated user's personal Glif skills, including its instructions. Does not expose global Glif skills. To run a skill, name it in a `compose_project` prompt, e.g. "use my `alien-vistas` skill". Activation loads the instructions automatically, so copying them into the prompt is redundant.

get_user_skill

List recent Glif projects owned by the authenticated user.

list_projects

Lists the authenticated user's personal Glif skills as names and descriptions. Does not expose global Glif skills. To run one, name it in a `compose_project` prompt rather than fetching and copying its instructions.

list_user_skills

Default intelligence for new projects when no intelligence is supplied. This is your existing Glif account preference, shared with the Glif website. Existing projects keep their chosen model unless explicitly changed. Changing this setting does not start generation or spend credits.

read_settings

Select existing images from an owned Glif project using a thumbnail form. Returns authorized image asset IDs, not a generation job. Selection never spends credits. Unsupported hosts receive an image list instead. A later reviewed compose_project request is separate.

select_project_images

Update only submitted settings. Default intelligence for new projects when no intelligence is supplied. This is your existing Glif account preference, shared with the Glif website. Existing projects keep their chosen model unless explicitly changed. Changing this setting does not start generation or spend credits.

update_settings

Upload an image, video, or audio file for `compose_project`. Inline uploads return an `assetId` for `compose_project.asset_ids`; signed uploads return a file URL for `compose_project.attachments`. Documents use the signed local-file mode. Supported inputs: - `file` accepts an image, video, or audio attachment resolved by the host app. Supported hosts, including ChatGPT, can populate this field with a short-lived download URL. - `url` accepts a public image, video, or audio URL. Remote documents are not yet supported. - `filename` and/or `kind`, without `url` or `base64`, returns a signed curl PUT command as `command` in the result, with a `<YOUR_FILE_PATH>` placeholder, and an upfront stable file URL for a local file, including a document. This mode needs local shell and network access; Glif verifies the uploaded bytes and creates the owned asset server-side. - `base64` with `filename` accepts a small local image, video, or audio file when no shell is available. Glif rejects decoded files above 1 MiB, and host tool-call limits may be lower.

upload_file