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

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

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

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

• Начальный баланс — $0. Пополните его в разделе Оплата API до платных запросов, включая тесты в Playground.
• Собственное пополнение. В этот баланс зачисляются только средства API, добавленные через «Оплата API», и тратятся они только на API.
• Расчёт стоимости до запуска. 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.

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

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

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

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

Связанное