Миграция · проверено 2 августа 2026 г. · 10 минут
OpenAI-compatible API: миграция за 10 минут
Если приложение уже использует официальный OpenAI SDK, базовая миграция состоит из двух изменений: новый API-ключ и baseURL https://api.celestriagate.com/v1. Модель и расширенные параметры нужно проверить отдельно — совместимость не означает поддержку каждого endpoint без исключений.
Шаг 1. Замените ключ и base URL
Не меняйте одновременно prompt, модель и сетевой слой. Сначала добейтесь одинакового ответа на одном контрольном запросе, затем переносите дополнительные функции.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.CELESTRIA_API_KEY,
baseURL: "https://api.celestriagate.com/v1",
});
const response = await client.responses.create({
model: "gpt-5.6-terra",
input: "Проверка миграции",
});
console.log(response.output_text);Шаг 2. Выберите модель по роли
Не заменяйте все старые модели на GPT-5.6 Sol. Для флагманских сложных задач начните с Sol, для balanced/mini-нагрузки — с Terra, для дешёвых массовых операций — с Luna. Текущий список идентификаторов возвращает GET /models.
Сохраните прежний reasoning effort как baseline. У GPT-5.6 значение по умолчанию может изменить задержку и расход, поэтому для чувствительных маршрутов задайте его явно и прогоните eval-набор.
Шаг 3. Проверьте границы совместимости
Неизвестное поле не следует считать поддержанным только потому, что SDK его принимает. Зафиксируйте запросы для streaming, function tools, structured outputs и vision отдельно.
| Возможность | Маршрут Celestria | Что проверить |
|---|---|---|
| Responses | POST /responses | input, stream, tools, text.format |
| Chat | POST /chat/completions | messages, tools, response_format |
| Модели | GET /models | ID, цена, capabilities |
| Изображения | POST /images/generations | модель и поддерживаемые параметры |
| Продолжение | previous_response_id | store и срок жизни состояния |
Шаг 4. Включайте через безопасный rollout
- Добавьте CELESTRIA_BASE_URL и CELESTRIA_API_KEY через секреты окружения.
- Проверьте 20–50 реальных запросов и сравните схему ответа.
- Собирайте latency, токены, стоимость, долю 4xx/5xx и повторов.
- Оставьте feature flag для возврата к старому маршруту.
- После стабилизации удалите старый ключ и обновите runbook.
Частые вопросы
Достаточно ли изменить baseURL?
Для простого текстового запроса обычно да, вместе с заменой ключа. Для tools, изображений, background-режима и редких параметров нужна отдельная проверка совместимости.
Можно ли оставить официальный пакет openai?
Да. OpenAI-совместимый endpoint рассчитан на официальный SDK и совместимые клиенты; укажите собственные apiKey и baseURL.
Как быстро откатиться?
Держите base URL и ключ в конфигурации, а переключение — за feature flag. Не зашивайте endpoint в бизнес-логику.