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

6io API даёт доступ к моделям ИИ по одному ключу и с одним балансом в кредитах. Чат-модели работают как у OpenAI: в программе или SDK достаточно поменять адрес и ключ. Картинки, видео и звук делаются задачами: вы отправляете задачу, потом забираете результат.

«Sixio» в этой документации — название самого API. Ключи начинаются с sixio_sk_, номер запроса приходит в заголовке X-Sixio-Request-Id, а одна из групп моделей называется sixio. Это наш собственный сервис, а не сторонний.

#Какие бывают модели

Название модели состоит из группы и имени: группа/имя. Группа определяет, что умеет модель и куда её отправлять.

Куда отправлять и где смотреть параметры модели:

• op и vn — POST /v1/chat/completions. Параметры описаны в документации поставщика: OpenRouter, Venice. Как мы с ними работаем: модели OpenRouter, модели Venice.
• fal — POST /native/fal/queue/<id модели>. Параметры — на странице модели на fal.ai, вкладка API. Подробнее: модели fal.
• sixio — POST /native/sixio/tasks. Параметры — в GET /native/sixio/models и в консоли. Подробнее: модели Sixio.

Префикс обязателен. Модель без него или с неизвестным префиксом отвечает 404 model_not_found.

Тела запросов к моделям op, vn и fal уходят поставщику как есть. Поэтому здесь описано только то, что добавляем мы: цены, баланс, ошибки, лимиты и повторы. Что значат параметры конкретной модели, смотрите в документации поставщика по ссылкам из таблицы.

#Поток и очередь

У моделей два способа работы.

• Поток. Ответ приходит в том же соединении: целиком или по частям, по мере генерации ("stream": true). Так работает чат op и vn.
• Очередь. Запрос сразу возвращает номер req_…, а результат вы забираете по нему, когда он готов: запросом GET или уведомлением на ваш адрес (вебхуки). Так работают fal, sixio и фоновые задания (чат через очередь). Картинки и видео делаются от секунд до минут, поэтому держать соединение открытым незачем.

В каталогах и в консоли у каждой модели есть пометка mode: stream или queue. Состояния в очереди называются одинаково: queued (ждёт), running (идёт), succeeded (готово), failed (не выполнено), unknown (исход проверяется, деньги пока не закрыты). Исключение — fal: его SDK понимают только слова fal (IN_QUEUE, IN_PROGRESS, COMPLETED), поэтому там они остались.

#Как начать

1. Откройте консоль и войдите аккаунтом 6io или создайте его. Аккаунт общий с 6io: те же почта, пароль и кредиты.
2. Пополните API-баланс. На вкладке «Обзор» введите, сколько кредитов сайта перевести. API-баланс — тоже кредиты, но отдельный кошелёк: один кредит сайта даёт один кредит API.
3. На вкладке «Ключи» нажмите «Создать ключ». Ключ показывается один раз, сохраните его сразу. Ключей можно создать несколько, у каждого свой срок действия или без срока.
4. Укажите в программе адрес https://api.6io.io/v1 и этот ключ.

#Первый запрос

curl https://api.6io.io/v1/chat/completions \
  -H "Authorization: Bearer sixio_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "op/openai/gpt-4o-mini",
    "messages": [{"role": "user", "content": "Привет!"}],
    "max_tokens": 100
  }'

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

from openai import OpenAI

client = OpenAI(base_url="https://api.6io.io/v1", api_key="sixio_sk_...")
reply = client.chat.completions.create(
    model="op/openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Привет!"}],
    max_tokens=100,
)
print(reply.choices[0].message.content)

Node.js (npm install openai):

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.6io.io/v1", apiKey: "sixio_sk_..." });
const reply = await client.chat.completions.create({
  model: "op/openai/gpt-4o-mini",
  messages: [{ role: "user", content: "Привет!" }],
  max_tokens: 100,
});
console.log(reply.choices[0].message.content);

Ответ приходит в формате OpenAI. В нём model — то название, которое вы отправили, а в заголовке X-Sixio-Request-Id — номер запроса, строка вида req_8fK2xQ1mZpVwT9sJdL4nAg. По номеру можно посмотреть, сколько он стоил.

#Сколько это стоило

Баланс:

curl https://api.6io.io/v1/balance -H "Authorization: Bearer sixio_sk_..."

{
  "currency": "credits",
  "balance": "9.986728000000",
  "reserved": "0.000000000000",
  "available": "9.986728000000"
}

Один запрос по его номеру:

curl https://api.6io.io/v1/requests/req_8fK2xQ1mZpVwT9sJdL4nAg -H "Authorization: Bearer sixio_sk_..."

{
  "id": "req_8fK2xQ1mZpVwT9sJdL4nAg",
  "object": "request",
  "model": "op/openai/gpt-4o-mini",
  "status": "succeeded",
  "billing_status": "settled",
  "reserved": "0.500000000000",
  "charged_credits": "0.013272000000",
  "created_at": "2026-10-26T12:00:01Z",
  "finished_at": "2026-10-26T12:00:03Z"
}

В консоли то же видно глазами: вкладка «Запросы» — история с состоянием и суммой, «Расходы» — траты по дням и моделям, «Модели» — цены. Вкладка «Песочница» отправляет настоящий платный запрос из браузера с вашим ключом.

#Что дальше

• Чат: запрос, потоковый ответ, цены, бесплатные модели.
• Модели OpenRouter и модели Venice: провайдеры и цены, сортировка, плагины, особенности.
• Модели fal и модели Sixio: картинки, видео и звук задачами.
• Фоновые задания: долгий чат без открытого соединения.
• Уведомления: узнать о конце запроса, не опрашивая статус.
• Баланс и цены: как считается цена и что такое резерв.
• Повторы и сбои: как не заплатить дважды.
• Ошибки и лимиты: таблица кодов.

Пользуясь API, вы принимаете условия использования: сервис предоставляется «как есть», за содержание запросов и использование ответов отвечаете вы.