Перейти к содержанию

Руководство по быстрому старту

Начните работу с ClaudeHub API за несколько минут.

Шаг 1: Получите API ключ

Получите API ключ через наш Telegram бот. Ваш ключ будет выглядеть так:

sk-hub-xxxxxxxxxxxxxxxx

Храните ключ в безопасности

Никогда не делитесь своим API ключом и не добавляйте его в систему контроля версий. Используйте переменные окружения для безопасного хранения.

Шаг 2: Выберите способ интеграции

ClaudeHub поддерживает несколько способов интеграции:

  • Прямые API запросы - Используйте HTTP запросы напрямую
  • Python SDK - Используйте библиотеки Anthropic или OpenAI для Python
  • Интеграция с IDE - Используйте с Cursor, Cline, Continue и др.

Шаг 3: Сделайте первый запрос

Установите SDK: 

pip install anthropic

Сделайте запрос: 

import anthropic
import os

client = anthropic.Anthropic(
    api_key=os.environ.get("CLAUDEHUB_API_KEY"),
    base_url="https://api.claudehub.fun/v1"
)

message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Объясни квантовые вычисления простыми словами"
        }
    ]
)

print(message.content[0].text)

Установите SDK: 

pip install openai

Сделайте запрос: 

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ.get("CLAUDEHUB_API_KEY"),
    base_url="https://api.claudehub.fun/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[
        {
            "role": "user",
            "content": "Объясни квантовые вычисления простыми словами"
        }
    ]
)

print(response.choices[0].message.content)

Установите SDK: 

npm install @anthropic-ai/sdk

Сделайте запрос: 

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.CLAUDEHUB_API_KEY,
  baseURL: 'https://api.claudehub.fun/v1',
});

const message = await client.messages.create({
  model: 'claude-sonnet-4-20250514',
  max_tokens: 1024,
  messages: [
    {
      role: 'user',
      content: 'Объясни квантовые вычисления простыми словами'
    }
  ],
});

console.log(message.content[0].text);


curl https://api.claudehub.fun/v1/messages \
  -H "x-api-key: $CLAUDEHUB_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "Объясни квантовые вычисления простыми словами"
      }
    ]
  }'

Шаг 4: Включите Streaming (опционально)

Для ответов в реальном времени включите streaming:

import anthropic

client = anthropic.Anthropic(
    api_key="sk-hub-YOUR_KEY",
    base_url="https://api.claudehub.fun/v1"
)

with client.messages.stream(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Напиши короткий рассказ"}
    ]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

from openai import OpenAI

client = OpenAI(
    api_key="sk-hub-YOUR_KEY",
    base_url="https://api.claudehub.fun/v1"
)

stream = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[
        {"role": "user", "content": "Напиши короткий рассказ"}
    ],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Шаг 5: Проверьте баланс

Проверьте баланс кредитов и использование:

curl https://api.claudehub.fun/v1/system/balance \
  -H "x-api-key: sk-hub-YOUR_KEY"

Ответ: 

{
  "balance": 1250.50,
  "currency": "credits"
}

Переменные окружения

Настройте переменные окружения для безопасности:

export CLAUDEHUB_API_KEY="sk-hub-YOUR_KEY"
export ANTHROPIC_API_KEY="sk-hub-YOUR_KEY"
export ANTHROPIC_BASE_URL="https://api.claudehub.fun/v1"

$env:CLAUDEHUB_API_KEY="sk-hub-YOUR_KEY"
$env:ANTHROPIC_API_KEY="sk-hub-YOUR_KEY"
$env:ANTHROPIC_BASE_URL="https://api.claudehub.fun/v1"

CLAUDEHUB_API_KEY=sk-hub-YOUR_KEY
ANTHROPIC_API_KEY=sk-hub-YOUR_KEY
ANTHROPIC_BASE_URL=https://api.claudehub.fun/v1

Лучшие практики

1. Обработка ошибок

Всегда реализуйте правильную обработку ошибок:

import anthropic

client = anthropic.Anthropic(
    api_key="sk-hub-YOUR_KEY",
    base_url="https://api.claudehub.fun/v1"
)

try:
    message = client.messages.create(
        model="claude-sonnet-4-20250514",
        max_tokens=1024,
        messages=[{"role": "user", "content": "Привет"}]
    )
    print(message.content[0].text)
except anthropic.APIError as e:
    print(f"Ошибка API: {e}")
except Exception as e:
    print(f"Неожиданная ошибка: {e}")

2. Ограничение токенов

Будьте внимательны к использованию, чтобы избежать лишних расходов:

  • Используйте подходящие лимиты max_tokens
  • Выбирайте правильную модель для задачи
  • Реализуйте кэширование для повторяющихся запросов

3. Выбор модели

Выбирайте правильную модель для вашей задачи:

  • Opus 4.6 - Сложные рассуждения, программирование, анализ
  • Sonnet 4 - Сбалансированная производительность (рекомендуется для большинства задач)
  • Haiku 3.5 - Быстрые ответы, простые запросы

Следующие шаги

Решение проблем

Ошибка аутентификации

Если вы получаете ошибку 401:

  • Проверьте правильность API ключа
  • Убедитесь, что используете заголовок x-api-key (не Authorization)
  • Проверьте, что ключ не истёк

Недостаточно кредитов

Если вы получаете ошибку 402:

  • Проверьте баланс: GET /v1/system/balance
  • Пополните кредиты через Telegram бот

Модель не найдена

Если вы получаете ошибку 404:

Нужна помощь?

  • 📖 Прочитайте Справочник API
  • 💬 Свяжитесь с поддержкой через Telegram
  • ❓ Проверьте FAQ