API

Authentication

API key authentication for Chipp API

|View as Markdown
1 min read
ℹ️

API access is available on every plan, including Free. You only need a Builder API key for your app.

Getting Your API Key

  1. Log into build.chipp.ai
  2. Navigate to your application
  3. Click Launch in the sidebar, then the Access tab
  4. Scroll to the Builder API Keys section
  5. Click + New Key, optionally give it a name, and click Create Key
  6. Copy the key (it begins with chipp_). It is only shown once

Tip: The Launch > Share tab’s “API Access” card shows a ready-to-use curl example with your app’s model name pre-filled. Click its copy button to get a working request, then paste in your key.

Using Your API Key

Include your API key in the Authorization header:

bash
Authorization: Bearer YOUR_API_KEY

Example

bash
curl https://build.chipp.ai/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "myapp-123",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Required Headers

HeaderValue
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Error Responses

Authentication Errors (401)

json
{
  "error": "Missing API key"
}

No Authorization header provided.

json
{
  "error": "Invalid API key"
}

The API key is incorrect, expired, or revoked. A key for a different application returns 404 (Unknown model), not 401.