Dinkin Logo
DINKIN

Dinkin API

OpenAI-совместимый API и настройка Codex в VS Code

Один endpoint для чата, изображений и Codex workflow. API принимает ключи формата sk-dk и поддерживает KIE Codex-модели через native Responses API. Этот вариант подходит для расширения OpenAI Codex в VS Code лучше, чем DeRouter chat bridge.

Быстрые параметры

Base URL
https://dinkin.ru/api/openai/v1
Авторизация
Authorization: Bearer sk-dk-...
Codex config
~/.codex/config.toml

Какие модели проверены для Codex

Для Codex через Dinkin сейчас используйте KIE-модели ниже. Они идут через endpoint KIE /api/v1/responses и прошли проверку через Dinkin Responses API.

gpt-5.4-codexgpt-5.3-codexgpt-5-codex

Что важно для Codex extension

По документации OpenAI Codex IDE работает через расширение VS Code и читает общий Codex config. Поэтому удобнее подключать Dinkin через ~/.codex/config.toml, а не через разовые ручные настройки.

Важно: для custom provider Codex ждёт ключ именно в переменной окружения из env_key. Сохранённый через codex login --api-key ключ сам по себе не подставляется в Dinkin provider.

Материалы: Codex IDE, Config reference и KIE GPT Codex docs.

VS Code + Codex

Пошаговая настройка расширения OpenAI Codex

1. Установите расширение

В VS Code откройте Extensions и установите расширение Codex – OpenAI's coding agent.

2. Выпустите API-ключ Dinkin

В кабинете Dinkin создайте новый ключ. Если хотите, сразу ограничьте его только chat-моделями или только Codex id.

3. Добавьте ключ в переменные окружения
export DINKIN_API_KEY="sk-dk-..."

Переменная должна быть доступна до запуска VS Code. Если редактор уже открыт, после добавления переменной перезапустите окно VS Code или remote-сессию, чтобы расширение увидело ключ.

4. Откройте ~/.codex/config.toml
model = "gpt-5.4-codex"
model_provider = "dinkin"
model_reasoning_effort = "low"

[model_providers.dinkin]
name = "Dinkin API"
base_url = "https://dinkin.ru/api/openai/v1"
env_key = "DINKIN_API_KEY"
wire_api = "responses"

Начинайте с KIE gpt-5.4-codex и low reasoning: Codex отправляет большой системный prompt и набор tools, поэтому high/xhigh медленнее и дороже. Если нужен другой KIE Codex-вариант, смените поле model на любой из поддерживаемых id выше.

5. Проверьте CLI и перезапустите VS Code
codex doctor
codex exec "Ответь ровно одним словом: OK"

В doctor должно быть model gpt-5.4-codex · dinkin и не должно быть ошибки auth env var is missing. После этого сделайте Reload Window в VS Code и откройте панель Codex.

Проверка API перед подключением

Сначала удобно убедиться, что ключ видит модели.

curl https://dinkin.ru/api/openai/v1/models \
  -H "Authorization: Bearer $DINKIN_API_KEY"

Проверка Responses API

Codex опирается на современный Responses wire format, поэтому в конфиге указан wire_api = "responses".

curl https://dinkin.ru/api/openai/v1/responses \
  -H "Authorization: Bearer $DINKIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-codex",
    "input": "Reply with only: ok"
  }'

Этот smoke-тест проверяет Dinkin Responses bridge и native KIE Codex endpoint. В рабочей проверке Dinkin вернул OK.

Для KIE Codex используйте Responses API

KIE GPT Codex по документации работает через Responses API. Поэтому для VS Code Codex оставляйте wire_api = "responses" и не переключайте конфиг на chat completions.

Важно про KIE и Codex tools

Проверка Dinkin API показывает, что /models, короткий /responses smoke и полный Codex CLI запрос проходят через KIE.

KIE docs предупреждают: web search и function tools нельзя смешивать в одном запросе. Dinkin для Codex оставляет function tools и не отправляет web search, когда function tools уже есть.

Для диагностики сначала проверьте auth/config в codex doctor, затем запустите codex exec. Если VS Code не видит ключ, оставьте model_reasoning_effort = "low" и проверьте переменную окружения.

Если Codex в VS Code не видит provider

Проверьте, что переменная DINKIN_API_KEY доступна в окружении, из которого запущен VS Code.

Проверьте точный base_url: https://dinkin.ru/api/openai/v1.

Оставьте wire_api = "responses".

Если видите 401 на api.openai.com, значит не указан model_provider = "dinkin" и ключ уходит не в Dinkin.

Если видите auth env var is missing, значит ключ есть в файле авторизации Codex, но не в переменной окружения для custom provider.

После правки ~/.codex/config.toml выполните Reload Window в VS Code.