> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chipipay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get an AI response in 30 seconds. No SDK needed — just HTTP.

## 1. Get your API key

Go to [dashboard.chipipay.com](https://dashboard.chipipay.com), create an org, and copy your API key from the Credentials page.

## 2. Make your first call

```bash cURL theme={null}
curl -X POST https://api.chipipay.com/v1/ai/chat \
  -H "Authorization: Bearer sk_prod_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "What is Starknet?"}]
  }'
```

```typescript TypeScript theme={null}
const response = await fetch("https://api.chipipay.com/v1/ai/chat", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_prod_YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "What is Starknet?" }],
  }),
});

const data = await response.json();
console.log(data.text);
// → "Starknet is a Layer 2 scaling solution for Ethereum..."
console.log(data.cost.charged);
// → 0.00001 (USD)
```

```python Python theme={null}
import requests

response = requests.post(
    "https://api.chipipay.com/v1/ai/chat",
    headers={"Authorization": "Bearer sk_prod_YOUR_KEY"},
    json={
        "model": "gpt-4o-mini",
        "messages": [{"role": "user", "content": "What is Starknet?"}],
    },
)

data = response.json()
print(data["text"])
print(f"Cost: ${data['cost']['charged']}")
```

## 3. Stream a response

For chatbots and real-time UIs, use the streaming endpoint — same request body, token-by-token delivery via SSE:

```bash cURL theme={null}
curl -N -X POST https://api.chipipay.com/v1/ai/chat/stream \
  -H "Authorization: Bearer sk_prod_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "haiku", "messages": [{"role": "user", "content": "Tell me a joke"}]}'
```

```typescript TypeScript theme={null}
const response = await fetch("https://api.chipipay.com/v1/ai/chat/stream", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_prod_YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "haiku",
    messages: [{ role: "user", content: "Tell me a joke" }],
  }),
});

const reader = response.body!.getReader();
const decoder = new TextDecoder();
let buffer = "";

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  buffer += decoder.decode(value, { stream: true });
  const lines = buffer.split("\n");
  buffer = lines.pop() ?? "";

  for (const line of lines) {
    if (!line.startsWith("data: ")) continue;
    const data = JSON.parse(line.slice(6));

    if (data.done) {
      console.log("Cost:", data.cost.charged, "USD");
    } else {
      console.log(data.text); // append to your UI
    }
  }
}
```

## 4. Buy credits

AI calls debit from your org's credit balance. Buy a credit pack ($2 / $5 / $25 / $50 / \$100) at [dashboard.chipipay.com/configure/billing](https://dashboard.chipipay.com/configure/billing) by sending USDC.

\$5 gets you **\~50,000 calls** with `gpt-4o-mini` or **\~700 calls** with `haiku`.

## Auth

Two options — both work on all AI endpoints, no JWKS setup needed:

| Method | Header | Best for |
| - | - | - |
| Secret key | `Authorization: Bearer sk_prod_...` | Server-side (backend, agent) |
| Public key | `x-api-key: pk_prod_...` | Client-side (browser, mobile) |

> [!WARNING]
>
> Never put `sk_` keys in client-side code. Use `pk_` for browser/mobile apps.

## What you can build

| Use case | Endpoint | Cost |
| - | - | - |
| Chatbot / code assistant | [`POST /ai/chat`](/services/ai-api/chat-and-streaming) | Per token |
| Real-time streaming UI | [`POST /ai/chat/stream`](/services/ai-api/chat-and-streaming#streaming) | Per token |
| DeFi portfolio advisor | [`POST /ai/think`](/services/ai-api/defi-intelligence) | Per token |
| Swap execution | [`POST /ai/execute`](/services/ai-api/defi-intelligence#execute-a-swap) | \$0.002/call |
| Token prices for wallets | [`GET /ai/prices`](/services/ai-api/prices-and-data) | Free |
| Market signals for agents | [`GET /ai/signals`](/services/ai-api/prices-and-data#technical-signals) | Free up to 100/mo, then \$0.0005/call |

## Next

* [Chat & Streaming](/services/ai-api/chat-and-streaming) — full request/response reference
* [DeFi Intelligence](/services/ai-api/defi-intelligence) — portfolio advisor + swap execution
* [Prices & Data](/services/ai-api/prices-and-data) — 90 tokens, 11 chains, 60 currencies
* [Models & Pricing](/services/ai-api/models) — all models, providers, and rate limits


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.