Responses API

OpenAI-совместимый Responses API

Только без состояния

Этот API не сохраняет состояние - каждый запрос независим и никакое состояние разговора не сохраняется между запросами. Вы должны включать полную историю разговора в каждый запрос.

Responses API AITUNNEL предоставляет OpenAI-совместимый доступ к множественным AI моделям через унифицированный интерфейс, разработанный как замена для OpenAI Responses API. Этот API без состояния предлагает расширенные возможности, включая рассуждения, вызов инструментов и интеграцию веб-поиска, где каждый запрос независим и никакое состояние не сохраняется на сервере.

Базовый URL

https://api.aitunnel.ru/v1/responses

Аутентификация

Все запросы требуют аутентификации с использованием вашего API ключа AITUNNEL:

TypeScript

const response = await fetch('https://api.aitunnel.ru/v1/responses', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk-aitunnel-xxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'gpt-4o',
    input: 'Привет, мир!',
  }),
});

Python

import requests

response = requests.post(
    'https://api.aitunnel.ru/v1/responses',
    headers={
        'Authorization': 'Bearer sk-aitunnel-xxx',
        'Content-Type': 'application/json',
    },
    json={
        'model': 'gpt-4o',
        'input': 'Привет, мир!',
    }
)

cURL

curl -X POST https://api.aitunnel.ru/v1/responses \
  -H "Authorization: Bearer sk-aitunnel-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": "Привет, мир!"
  }'

Обработка ошибок

API возвращает структурированные ответы об ошибках:

{
  "error": {
    "code": "invalid_prompt",
    "message": "Отсутствует обязательный параметр: 'model'."
  },
  "metadata": null
}

Для комплексного руководства по обработке ошибок, смотрите Обработка ошибок.

Лимиты скорости

Применяются стандартные лимиты скорости AITUNNEL. Смотрите Лимиты API для подробностей.

Примеры использования

Простой запрос

import requests

response = requests.post(
    'https://api.aitunnel.ru/v1/responses',
    headers={
        'Authorization': 'Bearer sk-aitunnel-xxx',
        'Content-Type': 'application/json',
    },
    json={
        'model': 'gpt-4o',
        'input': 'Объясни квантовую физику простыми словами',
    }
)

data = response.json()
print(data['output'])

Запрос с системным промптом

response = requests.post(
    'https://api.aitunnel.ru/v1/responses',
    headers={
        'Authorization': 'Bearer sk-aitunnel-xxx',
        'Content-Type': 'application/json',
    },
    json={
        'model': 'gpt-4o',
        'input': 'Напиши короткое стихотворение о весне',
        'instructions': 'Ты поэт, который пишет в классическом стиле. Используй рифму и метр.',
    }
)

Различия от стандартного Chat API

Responses API отличается от стандартного /v1/chat/completions API:

1. Упрощенный интерфейс: Использует input вместо массива messages
2. Без состояния: Каждый запрос полностью независим
3. Встроенные возможности: Нативная поддержка рассуждений, инструментов и веб-поиска
4. Совместимость с OpenAI: Разработан как drop-in замена для OpenAI Responses API

Совет

Responses API идеально подходит для приложений, которым нужен простой интерфейс без управления состоянием разговора, но с доступом к продвинутым возможностям AI.