Cloud API — модели по ключу

Платформенный API-ключ Пуска даёт доступ к каталогу моделей через OpenAI-совместимый шлюз: те же модели, что у агентов, без VPN и иностранных карт.

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

1. Создайте ключ в кабинете: Аккаунт → API-ключи. Ключ вида sk_live_… показывается один раз — сохраните его.
2. Запросите модель — как в OpenAI SDK, но base_url наш:

curl https://gateway.pusk.ai/v1/chat/completions \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pusk/openai/gpt-4.1-mini",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Python (официальный SDK OpenAI):

from openai import OpenAI

client = OpenAI(base_url="https://gateway.pusk.ai/v1", api_key="sk_live_…")
resp = client.chat.completions.create(
    model="pusk/openai/gpt-4.1-mini",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

Список моделей

Доступные модели и цены — GET /v1/models с тем же ключом (или в каталоге):

curl https://gateway.pusk.ai/v1/models -H "Authorization: Bearer sk_live_…"

Имена моделей начинаются с pusk/ — например pusk/openai/gpt-4.1-mini или pusk/deepseek-ai/DeepSeek-V4-Flash. Модель pusk-llm в публичном API недоступна: она предназначена только агентам на машинах хостинга.

Оплата и лимиты

• Тарификация по токенам — как в каталоге (цена за 1M входных/выходных токенов уже с нашей наценкой; GET /v1/models отдаёт её в копейках). Расход списывается с баланса кошелька автоматически — как у агентов на машинах.
• Лимиты на ключ: 60 запросов/мин, 250k токенов/мин и дневной потолок расхода — защита от runaway-агента. При превышении придёт 429; лимиты можно поменять по запросу в поддержку.
• Стриминг ("stream": true), tools/function calling и vision работают — шлюз прозрачный для OpenAI-совместимых клиентов.

Инфраструктура по тому же ключу

Тем же ключом можно управлять машинами через REST GET/POST /v1/instances и POST /v1/instances/{id}/actions — список машин, заявка на агента, запуск/стоп/рестарт сервисов (hermes/openclaw/chromium). Один ключ — и модели, и инфраструктура.