gemmeinDocs
gemmein.comDashboard
dashboard

AI

The AI page holds your provider keys, the AI tools you price in credits, the model aliases they run on, and a log of every run and call. Creating a tool takes five questions. Runs and calls are grouped by tool, so you can see what each person's AI use cost.

Steps

Overview

  1. Open AI under Build. Tools, Provider keys and Aliases each have a card, with a row per item and a link to add one.

    Open AI under Build. Tools, Provider keys and Aliases each have a card, with a row per item and a link to add one.

Provider keys

  1. Provider keys lists the keys Gemmein holds for your app, when each was last used, and how many tools use it.

    Provider keys lists the keys Gemmein holds for your app, when each was last used, and how many tools use it.

  2. Choose Add a provider key to paste one. It is stored for your app and never shown again.

    Choose Add a provider key to paste one. It is stored for your app and never shown again.

Tools

  1. Open a tool to see the code your app uses to call it, how it runs, what it has done and what it depends on.

    Open a tool to see the code your app uses to call it, how it runs, what it has done and what it depends on.

  2. Choose Change this tool on that page to edit the tool's fields, the same fields your gemmein/ai/tools file holds.

  3. Choose Create a tool, describe what it does and pick the answer type. Your description becomes the tool's name everywhere, and the call your app makes.

    Choose Create a tool, describe what it does and pick the answer type. Your description becomes the tool's name everywhere, and the call your app makes.

  4. Who runs it lists only the providers whose key can do that step. You can pick one that has no key yet: it says so, and you add the key on the next step.

    Who runs it lists only the providers whose key can do that step. You can pick one that has no key yet: it says so, and you add the key on the next step.

  5. Choose the model: one of your key's own, an alias that moves every tool on it together when you repoint it, or another model name pasted in.

    Choose the model: one of your key's own, an alias that moves every tool on it together when you repoint it, or another model name pasted in.

  6. Say what the model should do. These instructions are sent with every call and never shown to the people using your app.

    Say what the model should do. These instructions are sent with every call and never shown to the people using your app.

  7. Price it in credits, per call or per thousand tokens. A per-token price is held when the call starts and settled at what the provider used.

    Price it in credits, per call or per thousand tokens. A per-token price is held when the call starts and settled at what the provider used.

  8. The last question is a review: what your app sends, what it gets back, and the code your app uses to call the tool. Create saves it to the same place as the tool form.

    The last question is a review: what your app sends, what it gets back, and the code your app uses to call the tool. Create saves it to the same place as the tool form.

Aliases

  1. Aliases lists the names your tools run on in place of a model, and how many tools use each one.

    Aliases lists the names your tools run on in place of a model, and how many tools use each one.

  2. Open an alias and choose Repoint it to move every tool that uses it to another model in one change.

    Open an alias and choose Repoint it to move every tool that uses it to another model in one change.

Runs

  1. Open Runs to see every job a tool started, newest first, with how it ended and what it held and used. Until a tool has run, it shows No runs yet.

    Open Runs to see every job a tool started, newest first, with how it ended and what it held and used. Until a tool has run, it shows No runs yet.

AI calls

  1. Open AI calls to see every call your app made, by tool, with what each tool answered, refused and cost.

    Open AI calls to see every call your app made, by tool, with what each tool answered, refused and cost.

  2. Open a call to read what was asked and what came back, for a tool set to keep them.

    Open a call to read what was asked and what came back, for a tool set to keep them.

Errors

  • name must be 1-40 lowercase letters, numbers or hyphens, starting with a letter or number

    Your app sends this name to call the tool.

  • Credits are a whole number from 1 to 10,000.

    A tool priced in credits spends whole credits from a person's balance on every call. A tool with no charge is set to Included with a plan, and only people on the plans you pick can use it.

  • a tool runs on a pinned model OR an alias, not both — clear one

    A tool runs on one model or one alias, so repointing an alias always moves every tool on it.

  • a generate or transcribe tool runs on replicate, fal, assemblyai, elevenlabs, runway or external (your own pipeline at a URL you name — it submits itself, no relay involved); a chat tool on openai, anthropic, google

    Generate and transcribe tools run as jobs and chat tools answer straight away, so each kind uses providers built for it.

  • a metered generate or transcribe tool needs bounds.maxUnits — the ceiling one run may bill (its price is reserved when the run starts); a per-run tool (unit call) needs none

    A metered run holds the price of its ceiling before it starts, so the tool needs one.

  • bounds.deadlineMinutes must be a whole number from 1 to 1,440 — how long a run on your own pipeline may take before it expires (60 when unset); a Gemmein-executed tool has no say in it

    The deadline applies only to runs on your pipeline. Runs on other providers keep their own time limits.

  • "fast" is what alt-text, listing-copy run on — point them elsewhere first

    An alias can't be deleted while tools run on it, so no tool is left without a model.

  • no replicate key is set for this app — paste one on the AI page (app.gemmein.com/live/ai)

    You can save a tool before its key. Its runs start once the key is stored, and its row shows what it is waiting for.

What an AI tool is, and how your app calls one: AI tools.

Was this page helpful?

Last updated