Разработчикам · API v1

Один API.
Все модели.

Изображения, видео, аудио и 3D за одним API, с тем же балансом, что и студия. Создайте ключ в настройках и установите CLI через npm.

Получить API-ключБыстрый старт
Установка CLI
npm i -g ineveo
Моделей
699
Эндпоинтов
9
Минимальное пополнение
3 €
01 · Примеры

Один вызов, любой результат

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

1# 1. Generate an image2curl -X POST https://ineveo.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $INEVEO_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://ineveo.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $INEVEO_API_KEY"17 18# 3. Download the file19curl https://ineveo.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $INEVEO_API_KEY" \21  -o result.jpeg
Пример рендераluma/uni-v1/text-to-image
[02] Быстрый старт

Первый рендер за три шага

  1. 01Создайте API-ключВойдите по email, откройте Настройки, API-ключи и создайте ключ. Пополнение от 3 € в разделе Оплата.export INEVEO_API_KEY="YOUR_API_KEY"
  2. 02Установите CLIОдна команда: npm i -g ineveo. Ключ утилита читает из INEVEO_API_KEY.npm i -g ineveo
  3. 03Сделайте первый рендерВыберите ID модели в каталоге и отправьте промпт. Добавьте --dry-run, чтобы узнать цену, ничего не потратив.ineveo run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
[03] CLI

Рендер из терминала

Запускайте любую модель из shell, CI или кодинг-агента. Цена каждого рендера известна до старта и списывается с того же баланса.

Скрипты и CIКаждое поле модели доступно как флаг; локальный файл загружается автоматически.
JSON в stdoutОдин JSON-документ на запуск, прогресс и ошибки в stderr, ненулевой код выхода при сбое.
Кодинг-агентыФайл навыка учит агента сначала проверять цену и ограничивать её.
Полное руководство по CLI →
КомандаЧто делает
ineveo models --type videoВсе видеомодели с начальной ценой
ineveo run <model> -hПоля модели, загруженные в реальном времени: тип, значение по умолчанию, допустимые значения
ineveo run <model> -p "<prompt>" -o ./out/Рендер с сохранением результата в папку
ineveo run <model> -p "..." --dry-runТочная цена, ничего не тратится
ineveo run <model> -p "..." --max-price 0.50Отказ от запуска, если цена выше
ineveo run <model> -p "..." --json -o ./out/Один результат в JSON, готовый для следующего шага
ineveo skill installНаучите кодинг-агента пользоваться CLI
[04] Основы API

Готов к продакшену

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

Bearer-токен в заголовке Authorization. Ключи создаются в Настройках, любой можно отозвать в любой момент.

Authorization: Bearer YOUR_API_KEY

Фоновые рендеры

Запуск рендера сразу отвечает статусом queued. Опрашивайте рендер, пока он не завершится успехом, ошибкой или возвратом.

{ "status": "queued" }

Сначала цена

Узнайте точную цену для своих параметров, ничего не запуская. Все суммы указаны в евроцентах.

POST /api/v1/api/catalog/quote

Безопасные повторы

Передайте заголовок Idempotency-Key, и повторный запрос никогда не спишет деньги дважды.

Idempotency-Key: render-042

Лимиты

У каждого ключа есть лимит в минуту и необязательный дневной потолок. Сверх лимита API отвечает 429.

429 Too Many Requests

Ошибки и возвраты

Ошибки в JSON с кодом и сообщением. Неудачный рендер автоматически возвращается на баланс.

{ "status": "refunded" }
[05] Справочник

Эндпоинты

Базовый URL https://ineveo.com/api/v1

Полный справочник API →
GET/api/catalog/meВаш ключ и баланс
GET/api/catalog/modelsВсе модели
GET/api/catalog/models/detail?id=MODEL_IDОдна модель и её поля
POST/api/catalog/quoteЦена для конкретных входных данных
POST/api/catalog/generationsЗапустить генерацию
GET/api/catalog/generationsВаши последние генерации
GET/api/catalog/generations/IDСтатус одной генерации
GET/api/catalog/generations/ID/contentФайл результата
DELETE/api/catalog/generations/IDУдалить генерацию

Пополните на 3 € и запускайтесь сегодня

Создайте API-ключ в настройках и вызывайте любую модель. CLI доступен в npm. Неудачные рендеры возвращаются.

Получить API-ключСмотреть цены