Документация
Всё, что нужно для работы с ключом xcherry: от первого запроса до подключения в приложения. Один ключ — разные нейросети: ChatGPT, DeepSeek, Gemini, Grok, Qwen и другие. API совместим с OpenAI.
Начало работы
Ключ xcherry работает через стандартный OpenAI-совместимый API, поэтому подходит любому клиенту с поддержкой OpenAI. Если ключа ещё нет, получение займёт пару минут.
Аутентификация
Каждый запрос подписывается заголовком Authorization с твоим ключом. Ключ лежит в личном кабинете — никому не показывай его целиком.
Примеры
Один endpoint — разные модели. Подставь свой ключ вместо тестового.
-H "Authorization: Bearer sk-xc-ТВОЙ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-pro","messages":[{"role":"user","content":"Привет!"}]}'
client = OpenAI(
api_key="sk-xc-ТВОЙ_КЛЮЧ",
base_url="https://xcherry.xyz/v1"
)
r = client.chat.completions.create(
model="gemini-3.1-pro",
messages=[{"role": "user", "content": "Привет!"}]
)
print(r.choices[0].message.content)
const client = new OpenAI({
apiKey: "sk-xc-ТВОЙ_КЛЮЧ",
baseURL: "https://xcherry.xyz/v1",
});
const r = await client.chat.completions.create({
model: "gemini-3.8-flash",
messages: [{ role: "user", content: "Привет!" }],
});
console.log(r.choices[0].message.content);
$ch = curl_init("https://xcherry.xyz/v1/chat/completions");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer sk-xc-ТВОЙ_КЛЮЧ",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"model" => "deepseek-v4-flash",
"messages" => [["role" => "user", "content" => "Привет!"]],
]),
]);
$r = json_decode(curl_exec($ch), true);
echo $r["choices"][0]["message"]["content"];
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
func main() {
body, _ := json.Marshal(map[string]any{
"model": "kimi-k3",
"messages": []map[string]string{{
"role": "user", "content": "Привет!",
}},
})
req, _ := http.NewRequest("POST",
"https://xcherry.xyz/v1/chat/completions",
bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer sk-xc-ТВОЙ_КЛЮЧ")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
var r map[string]any
json.NewDecoder(resp.Body).Decode(&r)
fmt.Println(r)
}
Приложения
Не хочешь код — вставь ключ в готовое приложение. Подойдёт любое, где можно указать свой адрес OpenAI-совместимого API: настройки везде одни и те же. А если не хочется ничего настраивать — есть веб-чат прямо на сайте.
Чаты
Общение с нейросетью в привычном окне чата.
Настройки → Провайдер модели → добавь своего, тип «OpenAI API Compatible». API Host — https://xcherry.xyz/v1, ниже ключ и имя модели.
Настройки → Провайдеры моделей → Добавить, тип OpenAI. Вставь ключ и адрес https://xcherry.xyz/v1, затем добавь модели из списка.
Настройки → Языковая модель → OpenAI. Поле API Key — твой ключ, API Proxy Address — https://xcherry.xyz/v1.
Панель администратора → Настройки → Подключения → OpenAI API. Добавь адрес https://xcherry.xyz/v1 и ключ — модели подтянутся сами.
Добавь OpenAI-совместимого провайдера, вставь ключ и Base URL: https://xcherry.xyz/v1.
Провайдер OpenAI, поле API Key — твой ключ, Base URL — https://xcherry.xyz/v1.
API Connections → Chat Completion → источник «Custom (OpenAI-compatible)». Custom Endpoint — https://xcherry.xyz/v1, ниже ключ.
Код
Ассистенты в редакторе и терминале.Settings → Models → включи OpenAI API Key, вставь ключ и Override OpenAI Base URL: https://xcherry.xyz/v1. Имя модели добавь вручную.
API Provider → «OpenAI Compatible». Base URL — https://xcherry.xyz/v1, затем API Key и Model ID.
В настройках провайдера выбери «OpenAI Compatible», укажи Base URL https://xcherry.xyz/v1, ключ и имя модели.
Провайдер «OpenAI Compatible»: Base URL https://xcherry.xyz/v1, API Key и Model ID.
Settings → LLM Providers → добавь OpenAI-совместимого провайдера с API URL https://xcherry.xyz/v1, ключом и списком моделей.
В opencode.json добавь провайдера @ai-sdk/openai-compatible с baseURL https://xcherry.xyz/v1 и нужными моделями.
В config.yaml добавь модель с provider: openai, apiBase https://xcherry.xyz/v1 и своим apiKey.
Задай переменные OPENAI_API_BASE и OPENAI_API_KEY, запускай с --model openai/deepseek-v4-pro.
Автоматизация
Сценарии, боты и пайплайны без своего сервера.Создай учётные данные OpenAI: API Key — твой ключ, Base URL — https://xcherry.xyz/v1. Дальше используй обычные узлы OpenAI.
Settings → Model Provider → «OpenAI-API-compatible». Укажи имя модели, ключ и API endpoint URL https://xcherry.xyz/v1.
Модели
Один ключ открывает разные нейросети. Модели сгруппированы по компаниям. Оплата по факту: цена указана за 1M токенов. Если у модели две цены через косую черту — первая за ввод, вторая за ответ. Актуальное состояние каждой модели — на странице «Модели». Полный список отдаёт стандартный GET /v1/models.
Создатели ChatGPT. Luna — лёгкая и самая дешёвая в каталоге, Sol — основная на каждый день, Astra — старшая, для самых сложных задач. GPT-5.6 Sol — модель предыдущего поколения.
Лаборатория, которая сделала сильные модели очень дешёвыми. Хорошо пишет код и рассуждает — разумный выбор по умолчанию.
Модели Gemini разрабатывает Google DeepMind. Flash — быстрая на каждый день, Pro — старшая, для сложных задач и длинных документов.
Компания Илона Маска. Grok — её флагманская линейка моделей.
Компания, выросшая из Университета Цинхуа. Линейка GLM: Flash — быстрая и дешёвая, 5.2 — сбалансированная и понимает картинки, 5.3 — старшая, для кода и рассуждений.
Создатели Kimi — моделей, известных работой с длинными текстами и кодом.
Облачное подразделение Alibaba развивает семейство Qwen. Flash — быстрая, работает с текстом и картинками; Max — старшая, для сложных задач.
Производитель электроники со своей линейкой языковых моделей MiMo. Flash — быстрая на каждый день, Pro — старшая модель линейки.
Ошибки
Стандартные ответы API: тело ошибки — JSON с полем error.message.
Поддержка
Что-то не работает или нужно больше токенов — просто напиши.
Поддержка в кабинете
Поможем с подключением, балансом и любыми ошибками. Отвечаем быстро.