Обзор API

Основной способ подключения к DDTokens — совместимые с OpenAI методы. В существующем проекте на OpenAI SDK обычно достаточно заменить API-ключ и base_url.

Основные параметры

Параметр	Значение
Base URL	https://apiddt.com/v1
Аутентификация	Authorization: Bearer <DDDT_API_KEY>
Протокол по умолчанию	OpenAI Chat Completions

Пример запроса

curl "https://apiddt.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DDDT_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "user", "content": "Hello!" }
    ]
  }'

Структура ответа

Успешный ответ обычно содержит:

• id: идентификатор запроса или ответа.
• model: модель, фактически обработавшую запрос.
• choices: результат модели.
• usage: количество входных, выходных и всех токенов.

Разные модели и вышестоящие провайдеры могут возвращать дополнительные поля. В рабочей среде полагайтесь только на действительно необходимые стабильные поля.

Границы совместимости

DDTokens прежде всего предоставляет совместимый с OpenAI доступ. Параметры моделей, вызовы инструментов, мультимодальные возможности, потоковые ответы и форматы ошибок могут различаться у разных провайдеров.

Для стабильной работы:

• Зафиксируйте идентификатор модели.
• До запуска проверьте совместимость параметров реальными запросами.
• Записывайте в приложении идентификатор запроса, модель, стоимость и длительность.
• Настройте повторные попытки для подходящих ошибок.