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

Создайте ключ в личном кабинете и установите SDK:

pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="ts-ВАШ_КЛЮЧ",
    base_url="https://tripplestar.space/v1"
)

response = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "Привет!"}]
)
print(response.choices[0].message.content)

Авторизация

Передавайте ключ в заголовке каждого запроса.

Authorization: Bearer ts-ВАШ_КЛЮЧ

POST /v1/chat/completions

Создаёт ответ модели. Поддерживаются обычные и потоковые ответы.

curl https://tripplestar.space/v1/chat/completions \
  -H "Authorization: Bearer ts-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role":"user","content":"Привет!"}],
    "stream": false
  }'

POST /v1/responses

Агентный API с semantic SSE, function/custom tools, reasoning и локальными shell/apply_patch вызовами.

response = client.responses.create(
    model="gpt-5.6-sol",
    input="Проверь проект и предложи исправление",
    tools=[{"type": "shell", "environment": {"type": "local"}}],
    store=False
)

Локальные инструменты агента

Tripplestar сохраняет структуру tool call, но никогда не исполняет shell-команды и не создаёт удалённую рабочую директорию. Клиент валидирует вызов, выполняет его в локальном sandbox и возвращает output с тем же call_id.

{
  "type": "shell_call_output",
  "call_id": "call_...",
  "output": "Process exited with code 0"
}

Streaming SSE

Укажите stream=true и читайте события до завершающего сообщения. Клиент должен быть готов к разрыву сети и не повторять неоднозначный mutation без того же Idempotency-Key.

with client.responses.stream(
    model="gpt-5.6-sol",
    input="Проверь соединение"
) as stream:
    for event in stream:
        print(event.type)

GET /v1/models

Возвращает список доступных моделей.

curl https://tripplestar.space/v1/models \
  -H "Authorization: Bearer ts-ВАШ_КЛЮЧ"

Лимиты и идемпотентность

Tripplestar ограничивает частоту, параллелизм и периодическое использование токенов. Ответы 429 могут содержать Retry-After, а заголовки quota показывают границу текущего UTC bucket.

Для запросов, которые нельзя безопасно продублировать, передавайте уникальный Idempotency-Key. Повтор с тем же телом возвращает сохранённый результат; повтор с другим телом завершается конфликтом.

Idempotency-Key: 9ad8f5d0-...
X-Usage-Quota-Remaining: 120000
X-Usage-Quota-Reset: 2026-08-15T22:00:00Z

Баланс и ошибки

Каждый запрос резервирует prompt и запрошенный либо настроенный сервером output limit. Если остаток меньше, output limit автоматически уменьшается. После успешного ответа списывается реальный usage, неиспользованный резерв возвращается.

402 insufficient_quota означает, что баланс не покрывает prompt и минимум один output token. Заголовки X-Balance-Available, X-Balance-Reserved и X-Request-Cost показывают денежный баланс, активный резерв и окончательную стоимость запроса в USD.

429 quota_exceeded означает, что периодическая token quota исчерпана. Границы текущего fixed UTC bucket передаются в X-Usage-Quota-Limit, X-Usage-Quota-Remaining и X-Usage-Quota-Reset.

Другие коды: 400 — ошибка запроса, 401 — неверный ключ, 403 — аккаунт или модель недоступны, 409 — конфликт Idempotency-Key, 429 — rate/concurrency limit, 502 — upstream недоступен.