Быстрый старт 4-4 AI: подключение к единому AI API за 5 минут

Руководство · 2026-11-20 · 8 мин чтения

Это руководство проведёт вас от нуля до полного подключения к 4-4 AI: получить ключ → настроить Base URL → запустить первый потоковый вывод. Везде используется интерфейс, совместимый с OpenAI — любой существующий код, фреймворк или инструмент с поддержкой кастомной Base URL (openai SDK, LangChain, Cursor и т.д.) не требует изменения логики кода, меняется только конфигурация.

Подготовка

  1. Зайдите на www.4-4.vip, зарегистрируйте аккаунт и войдите в консоль;
  2. Пополните баланс в консоли или активируйте код карты;
  3. На странице «Токены» создайте новый ключ API (формата sk-...) и сохраните его надёжно — полностью он показывается только один раз, при создании.
Совет по безопасности: ключ API равен балансу аккаунта. Не коммитьте его в Git-репозитории и фронтенд-код. Лучше управляйте через переменные окружения.

Ключевые понятия: Base URL и ключ

4-4 AI предоставляет протокол интерфейса, полностью совместимый с OpenAI. Запомнить нужно лишь две настройки:

ПараметрЗначение
Base URLhttps://www.4-4.vip/v1
API KeyКлюч sk-..., созданный на странице токенов консоли
Параметр modelУкажите имя модели по необходимости, напр. deepseek-chat, glm-4 и т.д. (ориентир — список моделей в консоли)

Смена модели = изменить только параметр model; смена поставщика = изменить только Base URL. В этом главная ценность единого шлюза: развязка бизнес-кода и поставщика моделей.

Способ 1: cURL (быстрее всего проверить связность)

curl https://www.4-4.vip/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $44AI_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "Introduce yourself in one sentence"}
    ]
  }'

Если в ответном JSON есть choices[0].message.content — вся цепочка работает.

Способ 2: Python (официальный SDK openai)

pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["44AI_API_KEY"],          # your 4-4 AI key
    base_url="https://www.4-4.vip/v1"            # key: point to the 4-4 AI gateway
)

# regular call
resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Write a quicksort in Python"}]
)
print(resp.choices[0].message.content)

# streaming output
stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Tell me a nerdy joke"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta
    if delta and delta.content:
        print(delta.content, end="", flush=True)

Способ 3: Node.js

npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.N44_API_KEY,
  baseURL: "https://www.4-4.vip/v1",
});

const completion = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "Write a debounce function in TypeScript" }],
});
console.log(completion.choices[0].message.content);

Подключение популярных фреймворков и инструментов

Частые вопросы (FAQ)

Ошибка 401 Invalid API Key?

Проверьте по порядку: ① не попали ли в ключ пробелы или переносы строк при копировании; ② не отключён ли/не удалён ли ключ в списке токенов консоли; ③ не исчерпан ли баланс аккаунта; ④ имеет ли заголовок Authorization формат Bearer sk-... (после Bearer нужен пробел).

Ошибка 429, слишком много запросов?

Шлюз ограничивает частоту по токену. Снизьте параллелизм, увеличьте задержки повторов (рекомендуется экспоненциальная задержка + джиттер) или поднимите лимит токена в консоли.

Потоковый вывод обрывается на середине?

Для длинных ответов лучше включить повтор по таймауту в SDK; если трафик идёт через корпоративный прокси, проверьте, не буферизирует ли он SSE-поток (text/event-stream).

Какие модели поддерживаются?

Ориентир — актуальный список на странице «Модели» консоли. 4-4 AI агрегирует GLM, DeepSeek, Qwen и другие ведущие модели: один ключ, один интерфейс — и модель меняется.

Похожие статьи

Собственный one-api / new-api против управляемого AI-шлюза: затраты, эксплуатация и безопасность Честная система принятия решений для команд, выбирающих между «построить или купить»: скрытые расходы на экспл Подключение Cursor / Claude Code / Cherry Studio к собственному AI-шлюзу Настройка кастомной Base URL для популярных инструментов кодинга и чата, плюс шпаргалка по ошибкам 401 / 404 /
Готовы подключиться?

Один ключ для GLM, DeepSeek, Qwen и других ведущих моделей: единый биллинг и наглядная статистика использования.

Модели и тарифы Попробовать бесплатно