Быстрый старт

Начните работу с Gonka SaaS за 5 минут. Это руководство поможет вам создать учётную запись, создать API ключ и сделать ваш первый API вызов.

Предварительные требования

  • Учётная запись Gonka SaaS (бесплатно)
  • cURL, Python или любой HTTP клиент
  • Приветственный бонус $3 (автоматически добавляется новым аккаунтам)

Шаг 1: Создание учётной записи

Зарегистрируйте новый аккаунт с вашим email:

curl -X POST https://api.aigonka.ru/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your@email.com",
    "password": "your-password"
  }'

Ответ:

{
  "user": {
    "id": "usr_abc123",
    "email": "your@email.com",
    "balance": 3.00,
    "role": "user"
  },
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "message": "Регистрация успешна. Добро пожаловать! Вы получили бонус $3."
}

Важно: Сохраните JWT token — он понадобится для создания API ключей.

Шаг 2: Создание API ключа

API ключи используются для аутентификации ваших API запросов:

curl -X POST https://api.aigonka.ru/api/keys \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{"name": "Мой первый ключ"}'

Ответ:

{
  "id": "key_xyz789",
  "name": "Мой первый ключ",
  "key": "gk-ваш_API_ключ_abc123def456ghi789jkl012mno345pqr678",
  "keyPrefix": "gk-ваш_API_ключ",
  "createdAt": "2024-01-15T10:30:00Z",
  "warning": "Сохраните этот ключ в надёжном месте. Он не будет показан снова."
}

⚠️ Предупреждение по безопасности: API ключ показывается только один раз. Сохраните его в надёжном месте немедленно.

Шаг 3: Ваш первый API вызов

curl -X POST https://api.aigonka.ru/v1/chat/completions \
  -H "Authorization: Bearer gk-ваш_API_ключ..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
    "messages": [{"role": "user", "content": "Привет, мир!"}]
  }'

Что дальше?

Руководство по аутентификации →