Skip to content
NEW SELECTThe new Itzi Select plans are here
Itzi
Open app
All connection guides

Connect Marinara Engine to Itzi

Create an Itzi connection, pick a model and assign it to your chat.

Create your Itzi key

Open the Itzi API dashboard and sign in. Under API keys, enter a name for this app and click Create. Copy the secret immediately: it is shown only once. Keep a separate key for each app and paste it only into its API key field.

Choose a model your account can access. Requests use your Itzi balance or subscription according to the key settings. The example keys in these screenshots do not work.

Open API dashboard

Connection details

Base URL

https://itzi.app/v1

Use the custom OpenAI-compatible provider and keep /v1 in the base URL.

API key
Your full Itzi key, starting with itzi_sk_.
Model
An exact model ID from your API dashboard or /v1/models.

Set up the connection

  1. Create a custom connection

    Open Connections from the panel navigation, then click New (the plus icon). Name the connection Itzi and choose Custom (OAI-Compatible) as the provider. Click Create to open the Connection Editor.

    Marinara Engine Create Connection dialog with Itzi as the name and Custom (OAI-Compatible) selected.
    Marinara Engine 2.4.4. Choose the custom provider when creating the connection. Open the image to view it at full size.

  2. Set the URL and API key

    Set Base URL to the address in Connection details and paste your Itzi key into API Key. Select the provider before pasting the key: changing the provider clears the key field.

    Marinara Engine Connection Editor showing the Itzi base URL and API key fields.
    Marinara Engine 2.4.4. Connection fields before fetching models with a real Itzi key. Open the image to view it at full size.

  3. Load the models and save

    Open the Model selector and click Fetch Models from API, then choose an Itzi model. You can also enter its exact ID manually and click Done. Click Save and check that the editor shows Saved. Use the Itzi API dashboard to check which models your key can access.

  4. Test and assign the connection

    In Connection Tests, use Test Connection, then Send Test Message. The test message uses your Itzi balance or subscription allowance. Open Chat Settings and select Itzi under Connection. When creating a new chat, choose Itzi in the setup dialog.

If something does not work

A saved connection still needs to be selected

Saving Itzi does not switch every existing chat. Check the Connection setting for the chat you are using. Game Mode labels the dropdown GM / Party Model.

Extra agents make extra requests

Start with one chat request before enabling background agents. Concurrent requests share your Itzi limits. Embedding features need a separate compatible service; Itzi does not expose an embeddings endpoint.

Invalid key or 401

Copy the entire Itzi key without spaces. If it was revoked or lost, create a replacement in the API dashboard. An upstream provider key cannot replace an Itzi key.

Payment or access error

Check your balance, subscription allowance and the API key's subscription settings. A model shown in the public catalog may require access your key does not have.

Model not found or an empty model list

Refresh the model list using your key. Copy the exact ID from the API dashboard, then confirm the endpoint and key were saved before model discovery.

Too many requests or 429

Wait before retrying and reduce parallel requests. Chat messages and background agents share your limits. Check the error message for a rate, concurrency or subscription limit.

Long chats fail or responses are empty

Test a short conversation first. Lower the client's context and output limits, including character, lorebook and system prompts in that budget. Check Itzi Status if a short request also fails.

Check Itzi Status