ChatGPT

Add Cinara to ChatGPT as a custom GPT with Actions. The GPT reads Cinara's OpenAPI spec and calls the Cinara API with your key.

ChatGPT's own connectors expect you to sign in with OAuth, which Cinara doesn't offer yet. A custom GPT with an API key is the way to connect for now.

You need:

• A ChatGPT plan that lets you create GPTs.
• A Cinara API key. Create one on the API Keys page. See Before you start.

Create the GPT

1. In ChatGPT, open GPTs, then choose Create.

2. Open the Configure tab.

3. Fill in the Name (for example "Cinara"), a Description, and the Instructions. You can start from the suggested instructions below.

4. Under Actions, choose Create new action.

5. Choose Import from URL, paste this address and choose Import:

   https://api.cinara.ai/openapi.json

   Cinara's 20 actions are listed below the schema.

6. Next to Authentication, choose the settings icon, then:

   • Authentication Type: API Key
   • API Key: paste your Cinara key, without the word "Bearer"
   • Auth Type: Bearer

   Choose Save.

7. In Privacy policy, enter https://cinara.ai/legal/privacy. ChatGPT needs it before a GPT with actions can be shared.

8. Test it in the Preview panel, for example: "Make one 5-second doorbell sound effect." When ChatGPT asks to talk to api.cinara.ai, choose Allow (or Always allow).

9. Choose Create (or Update), then choose who can use the GPT.

Everyone who uses your GPT spends your credits

The key you paste is used for every conversation with the GPT, whoever starts it. Keep the GPT to Only me, unless you mean to pay for everyone who uses it. Give the GPT its own key, so you can revoke it without affecting anything else.

What the GPT can do

The spec gives the GPT 20 actions:

• Account and voices: your workspace and credit balance, Cinara's voices, speech models and languages, and your own voices.
• Speech: turn text into speech, and voice a conversation between speakers.
• Sound effects: start sound effects from a description, and check on them.
• Music: write lyrics, start a song or instrumental, and check on it.
• Images: list image models and credits, start creating or editing images, and check on them.
• Video: list video models and credits, start a video clip, and check on it.
• History and Drive: list History, get anything you made with fresh file links, list a Drive folder, and create a share link.

Uploading your own files isn't one of them. Image edits and animated videos can only start from images already made in Cinara. For Transcribe, Clean Audio, Dubbing and other features that start from your own file, use the Cinara app.

Suggested instructions

Paste this into Instructions and adjust it to taste:

You help me make speech, sound effects, music, images and video with Cinara.
- Make one take of a sound effect unless I ask for more.
- Before anything that costs a lot of credits (video, songs), tell me the estimated credits and ask me to confirm.
- Sound effects, music, images and video run in the background. After starting one, check it. If it's still running, tell me, and check again when I reply.
- When something is ready, give me the file links. Remind me that links expire after about 6 hours, that you can get fresh ones, and that every result is also in my Cinara Drive and History.
- When you create a share link, ask how long it should last.
- Never make content that names or copies well-known people.

Try it

• "Make one 20-second rain sound effect."
• "Read this paragraph in the Mentor voice: …"
• "Write a 30-second upbeat instrumental for a product demo."
• "Create an image of a cozy reading nook, warm light, 4:3."
• "How many credits do I have left?"

Good to know

• Results are links. Open a link to play or download the file. Links work without signing in and expire after about 6 hours. Ask for a fresh link, or find the file in Drive.
• Long jobs keep going. Songs and videos can take a few minutes, and keep running in Cinara between messages. Ask ChatGPT to check again, or open History.
• Sound effects. The API makes 4 takes of a sound effect unless it's told otherwise, and each take costs credits. The suggested instructions ask for one.
• Credits. Everything costs the same credits as in the app, from your workspace's balance. Results are listed in History under the key's name.
• Rate limit. Each key can make up to 120 requests a minute, and every check on a running job counts.

Update or remove

• After Cinara's spec changes: open the GPT, choose Configure, open the action, and choose Import from URL again.
• Change the key: create a new key, paste it under Authentication, and revoke the old key on the API Keys page.
• Remove Cinara: delete the action or the GPT, and revoke its key.

Troubleshooting

What you see	What to do
The import fails	Check the address is exactly https://api.cinara.ai/openapi.json, then try again.
Authentication errors or 401	Paste the key again without the word "Bearer", and check Auth Type is Bearer.
ChatGPT keeps asking for permission	Choose Always allow for api.cinara.ai.

For other error messages, see Troubleshooting.

Related

• Integrations overview
• API reference
• API Keys