Руководство по нативному OpenAI Responses API

​

Почему Responses

• Лучшее рассуждение: та же reasoning-модель показывает примерно на 3% более высокий результат на SWE-bench через Responses (состояние рассуждения сохраняется между ходами)
• Дешевле входящие данные: использование кэша на 40%–80% выше, чем в Chat Completions (по внутренним тестам OpenAI), что напрямую снижает ваш счет за входные данные
• Больше инструментов: встроенные инструменты, такие как web_search и code_interpreter, доступны только в Responses

​

Быстрый старт

curl https://api.apiyi.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.4",
    "input": "Introduce yourself in one sentence",
    "instructions": "You are a concise assistant"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"
)

response = client.responses.create(
    model="gpt-5.4",
    input="Introduce yourself in one sentence",
    instructions="You are a concise assistant"
)

print(response.output_text)  # SDK helper that concatenates all text output

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.apiyi.com/v1'
});

const response = await openai.responses.create({
  model: 'gpt-5.4',
  input: 'Introduce yourself in one sentence',
  instructions: 'You are a concise assistant'
});

console.log(response.output_text);

​

Параметры запроса

​

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

{
  "id": "resp_abc123",
  "object": "response",
  "status": "completed",
  "model": "gpt-5.4-2026-03-05",
  "output": [
    { "type": "reasoning", "summary": [] },
    {
      "type": "message",
      "role": "assistant",
      "content": [{ "type": "output_text", "text": "Hi! I'm an AI assistant." }]
    }
  ],
  "usage": {
    "input_tokens": 24,
    "input_tokens_details": { "cached_tokens": 0 },
    "output_tokens": 58,
    "output_tokens_details": { "reasoning_tokens": 40 },
    "total_tokens": 82
  }
}

• input_tokens_details.cached_tokens: ввод, который попал в кэш (тарифицируется по 0.1×)
• output_tokens_details.reasoning_tokens: расход на рассуждение (тарифицируется по ставке вывода; настраивается с помощью reasoning.effort)

​

Многоходовой режим: ведите историю самостоятельно

resp = client.responses.create(
    model="gpt-5.4",
    input=[
        {"role": "user", "content": "My name is Alice. Please remember it."},
        {"role": "assistant", "content": "Got it, your name is Alice."},
        {"role": "user", "content": "What's my name?"},
    ],
)
print(resp.output_text)  # Answers "Alice"

​

Управление рассуждением и выводом

​

Выбор reasoning.effort

response = client.responses.create(
    model="gpt-5.5",
    input="Prove that the square root of 2 is irrational",
    reasoning={"effort": "xhigh"}
)

​

text.verbosity

response = client.responses.create(
    model="gpt-5.4",
    input="Explain closures",
    text={"verbosity": "low"}  # short version
)

​

Потоковая передача

stream = client.responses.create(
    model="gpt-5.4",
    input="Write a short poem about autumn",
    stream=True
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)
    elif event.type == "response.completed":
        print("\n\nUsage:", event.response.usage)

​

Встроенные инструменты

response = client.responses.create(
    model="gpt-5.4",
    input="What are today's major AI news stories?",
    tools=[{"type": "web_search"}]
)
print(response.output_text)

​

Pro-модели и фоновый режим

# Submit a background task
response = client.responses.create(
    model="gpt-5.4-pro",
    input="Do a deep review of this architecture proposal: ...",
    background=True
)

# Poll for the result
import time
while response.status in ("queued", "in_progress"):
    time.sleep(10)
    response = client.responses.retrieve(response.id)

print(response.output_text)

​

Поддерживаемые модели и цены

​

Сопоставление из Chat Completions

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {"role": "system", "content": "You are a concise assistant"},
        {"role": "user", "content": "Hello"}
    ]
)
content = response.choices[0].message.content

response = client.responses.create(
    model="gpt-5.4",
    input="Hello",
    instructions="You are a concise assistant"
)
content = response.output_text

​

Статус поддержки клиентов

• chat/completions — де-факто отраслевой стандарт: сторонние шлюзы, локальные среды инференса (Ollama / vLLM / LM Studio) и вендоры, не относящиеся к OpenAI, все реализуют его, поэтому один обработчик покрывает сотни провайдеров — тогда как /v1/responses по-прежнему по сути является диалектом, почти исключительно OpenAI
• Responses — это не просто замена URL: семантическая потоковая передача событий (а не конкатенация delta), вывод на основе items и передача состояния reasoning принципиально отличаются от chat/completions — клиентам приходится переписывать весь цикл агента
• Проблема курицы и яйца: клиенты не реализуют это, потому что большинство кастомных эндпоинтов (шлюзов) не обслуживают responses, а шлюзы не спешат по той же причине. APIYI уже предоставляет /v1/responses (эта страница), так что на стороне шлюза нет блокирующего фактора

​

Устранение неполадок

​

Связанные ссылки

• Эта группа: Compatible Mode · Cache Billing · Function Calling
• Получение / управление token: https://api.apiyi.com/token
• Руководство по миграции OpenAI: developers.openai.com/api/docs/guides/migrate-to-responses