Баланс API и возвраты

У API PopNow собственный баланс в USD, отдельный от кредитов сайта. Вызовы с API-ключом, подключения MCP с API-ключом и Playground расходуют USD API. MCP через OAuth по-прежнему расходует кредиты сайта. Для одной модели с одинаковыми настройками API и сайт используют одну и ту же цену; переводить средства между балансами или использовать один вместо другого нельзя.

Здесь описаны пополнение API, цены и снятие резервов. Резервы отдельных задач, котировки и лимиты разобраны в разделе Оплата API.

Баланс API за минуту

• Начальный баланс — $0. Пополните его в разделе Оплата API до платных запросов, включая тесты в Playground.
• Отдельное пополнение. Пакеты, бонусные кредиты и награды сайта не оплачивают вызовы API. Средства API не оплачивают генерации сайта и вызовы OAuth MCP.
• Котировка до запуска. jobs/quote возвращает expectedChargeUsd и maxChargeUsd как десятичные строки в USD, не создавая задачу.
• Читайте окончательную сумму. costUsd задачи — окончательное списание в USD, когда settled равен true. Неудачные и просроченные задачи автоматически освобождают резерв, кроме возможной платы за отказ по содержанию, указанной для конкретной модели.

Откуда берутся средства API

Управляйте пополнением API и платежами в разделе Оплата API, используя доступные там сейчас варианты оплаты. Ключи создаются и управляются отдельно в разделе API-ключи.

Бонусы пакетов, награды за приглашения и другие начисления кредитов сайта не пополняют баланс API. Размеры пакетов, сроки возврата и сгорания кредитов сайта не являются условиями пополнения API.

Какой баланс расходуется

Баланс оплаты зависит от учётных данных и места вызова:

Пополнение одного баланса не пополняет другой. Если средств для резерва запроса API не хватает, пополните API, а не покупайте кредиты сайта.

Как считается стоимость генерации

У каждой модели свой прайс-лист, заданный для каждой опции: за изображение, за секунду видео или аудио, за песню или за 1 000 символов озвучки. Цена зависит от того, что вы заказываете: разрешения, длительности, уровня качества и — для некоторых моделей — количества референсных файлов.

Примеры цен API в USD:

На странице Модели есть ссылки на справочные страницы моделей. Используйте актуальную котировку для своих настроек и сохраняйте десятичную точность USD (до девяти знаков после точки); не округляйте списания API до целых кредитов. Playground на страницах API расходует тот же баланс API в USD.

Узнайте точную сумму до запуска:

curl -X POST "https://api.popnow.ai/api/v1/jobs/quote" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "minimax/h3/image-to-video", "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5}}'

import os, requests

quote = requests.post(
    "https://api.popnow.ai/api/v1/jobs/quote",
    headers={"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"},
    json={
        "model": "minimax/h3/image-to-video",
        "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5},
    },
    timeout=30,
).json()["data"]
print(quote["maxChargeUsd"], "USD at most,", quote["expectedChargeUsd"], "USD estimated")

const res = await fetch('https://api.popnow.ai/api/v1/jobs/quote', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.POPNOW_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    model: 'minimax/h3/image-to-video',
    input: { image_url: 'https://media.popnow.ai/movie/lighthouse.webp', prompt: 'The waves roll in slowly', duration_seconds: 5 },
  }),
});
const { data } = await res.json();
console.log(`${data.maxChargeUsd} USD at most, ${data.expectedChargeUsd} USD estimated`);

Что происходит, когда задача не удалась

Когда задача принята, её максимальная возможная цена в USD откладывается с баланса API как резерв. Когда она завершается:

Снятие резерва восстанавливает доступные средства API; это не возврат платежа в банк или на карту. Читайте costUsd вместе с settled в записи задачи, чтобы узнать окончательную сумму в USD. См. Оплата API.

Возврат платежей API

По вопросам пополнения API или возврата платежа откройте раздел Оплата API или обратитесь в поддержку. Укажите номер платежа или ID задачи, но никогда не отправляйте API-ключ.

Ошибки, с которыми вы можете столкнуться

Все коды перечислены на странице Ошибки.

Вызовы API стоят дороже, чем генерация на сайте?

Нет. Одна модель с одинаковыми настройками стоит одинаково. Вызовы API оплачиваются в USD с баланса API; генерации сайта и OAuth MCP расходуют кредиты сайта. Балансы остаются раздельными.

Нужно ли просить снять резерв задачи?

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

Можно ли вернуть платёж пополнения API?

Чтобы узнать, возможен ли возврат, и получить помощь с платежом API, откройте раздел Оплата API или обратитесь в поддержку.

Действуют ли для средств API сроки сгорания кредитов сайта?

Правила сгорания пакетов кредитов и наград сайта не определяют условия API. Проверьте раздел Оплата API или спросите поддержку о своих средствах API.

Можно ли пополнить API кредитами сайта?

Нет. Пополняйте API через раздел Оплата API. Кредиты сайта не пополняют API, средства API не оплачивают генерации сайта, а переводы между балансами невозможны.

Связанное