# Dolphin LLM: instructions for AI agents

You are setting up the Dolphin LLM API for the person you work for (the account owner). Dolphin LLM is an
OpenAI-compatible chat API for one uncensored model. Follow these steps in order and report the result of each.

Rules:
- The account belongs to the person. Use their email address; ask for it if you do not have it.
- Generate a strong password (16+ random characters), give it to the person, and do not store it anywhere else.
- Never pay, enter card details or send crypto unless the person explicitly told you to in this conversation.
  Your job is to prepare the payment and hand them the link.
- Do not create several accounts. One account per person; the free trial is one per person.

## 1. Create the account

```
POST https://dolphinllm.com/agent/signup.php
Content-Type: application/json

{"email": "<owner's email>", "password": "<generated password>", "accept_terms": true}
```

Set `accept_terms` to true only after telling the person that the account follows https://dolphinllm.com/terms/ and https://dolphinllm.com/privacy/.
A `201` answer contains `api_key` (shown only once: keep it), `base_url`, `model` and `balance_usd` ($0.50 of trial credit, valid 7 days).
Errors are JSON `{"ok": false, "error": {"type", "message"}}`: `account_exists` (409: the owner signs in at https://dolphinllm.com/login.php),
`signup_limit` (429), `weak_password`, `invalid_email`, `disposable_email`, `terms_not_accepted` (400).

## 2. Test the key

```
POST https://dolphinllm.com/v1/chat/completions
Authorization: Bearer <api_key>
Content-Type: application/json

{"model": "uncensored", "messages": [{"role": "user", "content": "Reply with one short sentence: are you working?"}], "max_tokens": 40}
```

Show the person the answer and the `usage` block. Cost: input tokens × $0.15 / 1M + output tokens × $0.50 / 1M.
The remaining balance is in the `X-Balance-USD` response header. Trial keys allow 60 requests a minute and 2 at once.

## 3. Prepare the top-up

```
GET https://dolphinllm.com/agent/topup.php?pack=p20
Authorization: Bearer <api_key>
```

Packs: `p20` $20 → $20.00 credit, `p50` $50 → $52.50 credit, `p100` $100 → $110.00 credit, `p200` $200 → $230.00 credit, `p500` $500 → $575.00 credit. The smallest is `p20`.
The answer has `payment.card_url` (a Stripe Checkout page for this account) and/or `payment.crypto_url` (a USDT/USDC invoice).
Show the person the price and the links and let them pay. After payment the balance updates within a minute:
`GET https://dolphinllm.com/agent/topup.php` (without `?pack`) returns `balance_usd`. The first top-up lifts the limits to 300 requests a minute and 8 at once.

## 4. Report

Tell the person: the account email, the password you generated, where the key is stored, the test answer and its cost,
and the payment link with its price (or that it was paid, if they asked you to pay and did).

## Using the API afterwards

Any OpenAI SDK works: base URL `https://dolphinllm.com/v1`, API key, model `uncensored`. Streaming, tools and JSON mode are supported.
Full reference: https://dolphinllm.com/docs/