Video 4/4 · Using your own API key (BYOK) in the "Ask AI" action in TimeTonic

Use your own API key in IA automations in Timetonic.
In this last video, we look together at how to use your own API key to run your automation scenarios.
Already have an OpenAI or Mistral.ai account?
You can then connect your own API keys directly from your provider.
Result, the calls from your IA automation scenarios are billed directly by your provider and do not use Timetonic's IA credits.
The default mode in the configuration of an automation action using IA works by using Timetonic credits.
This option is available in all license plans on Timetonic.
The user can choose between OpenAI or Mistral AI.
Let's look at the example of a use case that extracts information from an expense note, where the configuration uses the BIOC Personal API Key option.
We are in the IA template that extracts expense notes, which is already pre-configured, which you can also install in your spaces.
We go to Automation, the preconfigured automation scenario.
And by default, actions that ask the IA are configured on IA sources that use credits.
Here, we activate the toggle "Use my own API key".
Two providers are available, Chadjipiti and Mistral.ai.
The API key you enter must match the provider you have chosen.
An OpenAI key works only with ChatGPT and a Mistral key only with Mistral AI.
For the example, we will choose Chajipiti.
API key.
These are not interchangeable keys.
We then see that it is displayed hidden for security reasons.
And we will choose a model that accepts attachments, for example the 4.1 GPT or the 4.0, which will allow us to analyze an image of an expense note and automatically extract the information in our automation.
We always give a role to the IA.
Here, in the question, a prompt that gives the information of what the AI will receive, the task that is entrusted to it, and the expected output result that it must give us.
Under a JSON format, we ask it to extract the description, TTC, the total excluding text, the date and time, and the categorization, with rules to structure the output format.
Here, we insert the trap field-joint and response format, we choose the JSON format for the fields.
This is the step that connects the AI's response to the field of your table.
In the prompt, we asked the AI to return these data in a specific format, with specific keys.
description, date and time, all text included or excluding text.
It is exactly these same keys that you must enter in the JSON property name fields, character by character, without any difference.
A simple rule to remember, we always write in lower case, without space, with an underscore to separate words.
This is a standard used in development and is what the AI naturally produces when you ask it in the prompt.
To be even more precise, if the key in the prompt date and time is written with underscore but you do not put the underscore, then the mapping JSON for this table date and time will not work.
The AI returned exactly what you asked for, Timetonic looks for exactly what you wrote, and both must be identical.
Once the keys are correctly entered, you select in the field to your table that should receive the value and that has previously created the match.
For example, date and time goes in the date and time field of your table. Finally, you validate your automation configuration.
In this scenario, there are two conditional branches that handle two different formats, the image format of the expense notes and the branch that receives a PDF format.
The PDF format requires an additional automation action, here, which is handled by Mistral AI, which requires to insert its own API key, in which you indicate the field foot-joint where the PDF format arrives and the field in which you ask the AI to extract the JSON format that it will generate from the data extracted on this PDF. You validate, and finally a second and last action which will therefore handle the JSON format in order to insert it directly into the respective fields of your table.
For this, in the same way, you indicate the role alias, you structure a prompt in the question to tell it what it receives, you insert the variable of the field in which the previous automation action inserted the JSON text format, then the expected output format in the same way as the previous action for the image, and the structuring rules.
The choice in response format, always with the JSON option for fields, you validate, you save, and you can test the addition of a trap joint that will well extract the data on this invoice.
We do get the requested data, date and time, format, all text included, TTC and categorization.
If we go to the automation logs, in this case on the triggered branch, you have the model information here, and unlike a model using IA credits, no information on consumption since the consumption depends only on the direct supplier for which you have selected the source in your automation configuration.
A small security detail, Timetonic does not store your API key. If you decide to revert to a source using IA credits, simply disable the toggle and switch back to a source model either public or private.
If you reactivate the model of your API key, your own API key remains registered.
In the case where you want to edit it, it erases, you will have to reinsert it. When choosing the source, whether it is ChatGPT or Mistral.ai, you will notice that the models adapt according to the selection of your supplier.
To estimate your costs, see the price list of your external provider.
Using the BIOC source, your own API key, is relevant.
If you already have an active supplier account for other projects, very high and advantageous at scale However, if you are starting, TimeTonic IA credits are the simplest solution, everything is managed for you.
There you are, you have reached the end of this series of four tutorials on IA automation credits. You now know what an IA credit is in Timetonic, how to configure Mandalia's automation action and select the source and their model, manage your consumption and connect your own API key.
Timetonic has thought about making IA automations accessible to everyone, without technical expertise without complex configuration.
To get started quickly, use the IA automation templates directly available and ready to use in Timetonic.