Quickstart: Developers

Get started with Gloo AI Studio. This walks you through what to expect when you create an account as well as how you can make your first API call.

Step 1: Create Your Account & Organization

Start by creating your account at Gloo AI Studio. Once your email is verified, the onboarding wizard will guide you through setting up your organization:

Create your Organization: Give your team a name to manage projects and collaboration.
Invite your Team: (Optional) Add email addresses to invite collaborators immediately, or skip this step.

As the account creator, you are the Organization Admin. You can invite team members, create Publishers, and manage your organization at any time from the Studio sidebar. See the Admin Quickstart for a full walkthrough.

Step 2: Set Up Billing & Spend Limits

Adding a payment method is required to activate Studio on a Pay-As-You-Go plan. This unlocks API access and is a prerequisite for using the Studio Playground.

Add a Payment Method: Enter your credit card details to activate your account. You are only charged for what you use.
Set a Spend Limit: You can define a weekly spending limit (e.g., $50/week) to control costs. If you don’t set a limit, your standard ceiling is $100/week. Support can raise it on request.

Want more details? See our comprehensive guides: - Billing & Plans - Plan comparison, upgrades, and payment management - API Usage - Monitor your consumption and costs

Once your payment method is added, continue below to generate API credentials. After your credentials are created, you can either call the API directly or open the Studio Playground to chat with models in the browser — both routes use the same credentials and count against your spend limit.

Step 3: Create Your API Key

The Gloo AI API uses API keys for authentication. A single API key is all you need to make API calls. Here’s how to get your API key:

Navigate to API Keys in the Studio Dashboard.
Click Create New Key. Enter a name for the key and click Create.
Copy the API key immediately. It is shown only once; after that, Studio displays only the obfuscated value (e.g., sk_...3456).

Treat your API key like a password. Store it in a secure location, such as a secrets manager or environment variable. Do not commit it to source control.

Step 4: Set Your API Key

Set GLOO_API_KEY to the key you copied in Step 3. For example, in your shell:

export GLOO_API_KEY="sk_your_api_key_here"

Or add it to a .env file in your project:

GLOO_API_KEY="sk_your_api_key_here"

Step 5: Make An API Call

Make a call to the Responses API, the recommended endpoint for OpenAI-compatible, multimodal integrations. Send your API key directly in the Authorization header as a bearer token.

import os
import requests

response = requests.post(
"https://platform.ai.gloo.com/ai/v2/guarded/responses",
headers={
"Content-Type": "application/json",
"Authorization": f"Bearer {os.getenv('GLOO_API_KEY')}"
},
json={
"model": "gloo-openai-gpt-5-mini",
"instructions": "You are a human-flourishing assistant.",
"input": [
{"role": "user", "content": "How do I discover my purpose?"}
]
}
)

# Find the assistant message in the typed output array (a reasoning item

# may precede it on reasoning-capable models).

output = response.json()["output"]
message = next(item for item in output if item["type"] == "message")
print(message["content"][0]["text"])

curl https://platform.ai.gloo.com/ai/v2/guarded/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GLOO_API_KEY" \
  -d '{
    "model": "gloo-openai-gpt-5-mini",
    "instructions": "You are a human-flourishing assistant.",
    "input": [
      {
        "role": "user",
        "content": "How do I discover my purpose?"
      }
    ]
  }'

The response should look like this:

{
  "id": "resp_1768500882-56HaBYeuAb4pLpv8PXqh",
  "object": "response",
  "created_at": 1768500882,
  "model": "gloo-openai-gpt-5-mini",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "What a profound and meaningful question! ..."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 1115,
    "output_tokens": 459,
    "total_tokens": 1574
  }
}

Prefer routing, values-aligned (tradition) responses, or grounded/RAG completions? Use Completions V2 — it’s fully supported and backwards-compatible.

Next Steps

Libraries & SDKs

Use the OpenAI Python or Node.js SDK with Gloo AI directly with your API key.

Supported Models

Explore all available models and their capabilities.

GlooCode

Use your credentials with GlooCode — an AI coding agent that plans, builds, and tests from your terminal.

Get Started

Responses & Completions

Content

Organization & Billing

GlooCode

Learn More

External

Legacy

Quickstart: Developers

Step 1: Create Your Account & Organization

Step 2: Set Up Billing & Spend Limits

Step 3: Create Your API Key

Step 4: Set Your API Key

Step 5: Make An API Call

Next Steps

Libraries & SDKs

Supported Models

GlooCode

​Step 1: Create Your Account & Organization

​Step 2: Set Up Billing & Spend Limits

​Step 3: Create Your API Key

​Step 4: Set Your API Key

​Step 5: Make An API Call

​Next Steps

Libraries & SDKs

Supported Models

GlooCode

Step 1: Create Your Account & Organization

Step 2: Set Up Billing & Spend Limits

Step 3: Create Your API Key

Step 4: Set Your API Key

Step 5: Make An API Call

Next Steps