API Hubs и PiAPI
Альтернатива PiAPI
Сравните PiAPI и API Hubs по генерации изображений, предоплаченной оплате и получению результатов. В таблице — Nano Banana и два разрешения Nano Banana Pro.
Сравнение API Hubs и PiAPI
Когда выбрать API Hubs
Выбирайте API Hubs для поддерживаемых моделей PiAPI, если удобнее Bearer-авторизация и плоское тело запроса без отдельных model и task_type.
Когда стоит остаться на PiAPI
У PiAPI есть типы задач и сценарии подключения собственных аккаунтов без прямого аналога у нас. Переносите поддерживаемые модели отдельно: совпадение названия не гарантирует наличие всех типов задач.
Документация API PiAPIПрокрутите таблицу по горизонтали, чтобы увидеть все столбцы.
| Деталь интеграции | PiAPI | API Hubs |
|---|---|---|
| Запрос | POST /api/v1/task | POST /api/v1/generation/create |
| Авторизация | X-API-Key | Authorization: Bearer |
| Идентификатор модели | model: gemini / task_type: gemini-2.5-flash-image | nano-banana |
Сравнивается модель из примера ниже, а не все эндпоинты провайдера. Одинаковые названия моделей не гарантируют одинаковые параметры, модерацию или результат.
Сравнение цен: PiAPI и API Hubs
Выбранные общие модели с одинаковыми единицами тарификации. Наши цены берутся из текущего каталога; цены конкурента приведены с датами проверки и ссылками на источники.
| Модель | API Hubs | PiAPI | Разница нашей цены |
|---|---|---|---|
| Nano Bananaза изображение · по тексту | API Hubs0.015 coins | PiAPI$0.03 | На 50% ниже |
| Nano Banana Pro1K · за изображение · по тексту | API Hubs0.04 coins | PiAPI$0.105 | На 61.9% ниже |
| Nano Banana Pro4K · за изображение · по тексту | API Hubs0.05 coins | PiAPI$0.18 | На 72.2% ниже |
Одно изображение по текстовому запросу без референсов. Указаны публичные базовые тарифы; подписки, скидки за объём, другие разрешения и редактирование могут менять итоговую цену.
Наш баланс выражен в монетах: 1 монета = 1 USD. Цены конкурента указаны в USD.
Стоимость рабочего объёма
Nano Banana
1 000 изображений с настройками выше
- API Hubs
- 15 coins
- PiAPI
- $30
Nano Banana Pro · 1K
1 000 изображений с настройками выше
- API Hubs
- 40 coins
- PiAPI
- $105
Примеры рассчитаны по строкам выше, без скидок за объём, подписок и дополнительных платных опций. Они не обещают одинаковую скорость или одинаковые результаты.
Миграция с PiAPI
Замените X-API-Key на Authorization: Bearer, а model, task_type и input — на публичный id модели и документированные параметры верхнего уровня. Вместо task_id используйте taskId и адаптируйте обработку статусов и вебхуков.
1
Зарегистрируйтесь, пополните предоплаченный баланс и создайте API-ключ.
2
Отправьте POST /api/v1/generation/create с публичным id модели и параметрами из документации. Одна задача создаёт один результат.
3
Получите taskId из ответа. Опрашивайте GET /api/v1/task/status/TASK_ID или передайте webhook при создании задачи.
PiAPI
curl --fail-with-body 'https://api.piapi.ai/api/v1/task' \-H "X-API-Key: $PIAPI_API_KEY" \-H 'Content-Type: application/json' \-d '{"model": "gemini","task_type": "gemini-2.5-flash-image","input": {"prompt": "A ceramic mug on a wooden table, soft morning light","aspect_ratio": "1:1"}}'
API Hubs
curl --fail-with-body 'https://api.apihubs.ru/api/v1/generation/create' \-H "Authorization: Bearer $API_KEY" \-H 'Content-Type: application/json' \-d '{"model": "nano-banana","prompt": "A ceramic mug on a wooden table, soft morning light"}'
Полный пример: создать задачу и получить файл
Запускайте на сервере с Node 22+ или Bun и переменной API_KEY. Пример создаёт одну платную задачу и опрашивает её без повторного создания. Готовые ссылки временные: сохраните файл в своё хранилище.
import { writeFile } from "node:fs/promises";const baseURL = "https://api.apihubs.ru/api/v1";const apiKey = process.env.API_KEY;if (!apiKey) throw new Error("Set API_KEY on the server");async function request(path, options = {}) {const response = await fetch(baseURL + path, {...options,headers: {Authorization: `Bearer ${apiKey}`,"Content-Type": "application/json",},signal: AbortSignal.timeout(30_000),});if (!response.ok) throw new Error(await response.text());return response.json();}const { taskId } = await request("/generation/create", {method: "POST",body: JSON.stringify({"model": "nano-banana","prompt": "A ceramic mug on a wooden table, soft morning light"}),});if (!taskId) throw new Error("Missing taskId");const deadline = Date.now() + 10 * 60_000;let fileUrl;while (Date.now() < deadline) {const { data } = await request(`/task/status/${encodeURIComponent(taskId)}`);if (data.status === "finished") {fileUrl = data.files?.[0]?.fileUrl;if (!fileUrl) throw new Error("Task finished without a file");break;}if (data.status === "failed" || data.status === "expired") {throw new Error(data.errorMessage || data.status);}await new Promise((resolve) => setTimeout(resolve, 2000));}if (!fileUrl) throw new Error(`Still processing: save taskId ${taskId} and resume polling`);const file = await fetch(fileUrl, { signal: AbortSignal.timeout(60_000) });if (!file.ok) throw new Error(`Download failed: ${file.status}`);const mime = file.headers.get("content-type")?.split(";")[0];const extension = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp" }[mime] || "bin";await writeFile(`generated-image.${extension}`, new Uint8Array(await file.arrayBuffer()));
Храните API-ключи на сервере. Перед переносом рабочей нагрузки проверьте один запрос: параметры, обработку статусов и полученный результат.
Частые вопросы
Как перейти с PiAPI?
Замените X-API-Key на Authorization: Bearer, а model, task_type и input — на публичный id модели и документированные параметры верхнего уровня. Вместо task_id используйте taskId и адаптируйте обработку статусов и вебхуков.
API Hubs всегда дешевле PiAPI?
Нет. Сравните конкретную модель, настройки и единицу тарификации в таблице. Цены могут меняться в обе стороны; перед переносом рабочей нагрузки проверьте оба каталога.
Можно ли перенести любой сценарий с PiAPI?
У PiAPI есть типы задач и сценарии подключения собственных аккаунтов без прямого аналога у нас. Переносите поддерживаемые модели отдельно: совпадение названия не гарантирует наличие всех типов задач.
Что происходит с ошибками и незавершёнными запросами?
Медиазадачи повторяются по настроенным маршрутам; резерв используется, когда он доступен. При окончательной ошибке генерации списание возвращается. Задачу в обработке нужно опрашивать, а не создавать заново. Истечение ссылки на файл не означает ошибку генерации.
Как пополнить баланс?
Доступные способы оплаты, валюта и минимальная сумма пополнения указаны в личном кабинете до оплаты. Подписки нет: использование моделей оплачивается с предоплаченного баланса.
Выполните первый запрос в API Hubs
Выберите модель, проверьте параметры и цену, затем создайте API-ключ в личном кабинете. Начните с одного запроса перед переносом нагрузки.