Saldo da API e reembolsos

A API da PopNow tem seu próprio saldo em USD, separado dos créditos do site. Chamadas com chave de API, conexões MCP com chave de API e execuções do Playground gastam USD da API. O MCP conectado por OAuth continua gastando créditos do site. O mesmo modelo com as mesmas configurações tem o mesmo preço na API e no site; os saldos não podem ser transferidos nem usados um no lugar do outro.

Esta página explica os fundos da API, os preços e a liberação de reservas. Para reservas, cotações e limites por tarefa, veja Cobrança da API.

O saldo da API em um minuto

• Começa em $0. Adicione fundos em API billing antes de enviar requisições pagas, incluindo testes no Playground.
• Fundos separados. Pacotes de créditos, créditos bônus e recompensas do site não pagam chamadas da API. Fundos da API não pagam gerações no site nem chamadas MCP com OAuth.
• Cote antes de executar. jobs/quote retorna expectedChargeUsd e maxChargeUsd como strings decimais em USD sem iniciar uma tarefa.
• Leia o valor liquidado. O costUsd de uma tarefa é a cobrança final em USD quando settled é true. Tarefas que falham ou expiram liberam suas reservas automaticamente, salvo cobranças por recusa de conteúdo específicas de cada modelo.

De onde vêm os fundos da API

Gerencie fundos da API e registros de pagamento em API billing, com as opções de pagamento habilitadas ali. Crie e gerencie as chaves separadamente em API keys.

Bônus de pacotes, recompensas por convite e outros créditos concedidos no site não aumentam o saldo da API. Tamanhos de pacotes, prazos de reembolso e regras de validade do site não são condições dos fundos da API.

Qual saldo é usado

A credencial e a interface determinam qual saldo paga:

Adicionar fundos a um saldo não repõe o outro. Se uma requisição da API não puder cobrir sua reserva, adicione fundos à API em vez de comprar créditos do site.

Como uma geração é precificada

Cada modelo tem sua própria tabela de preços por opção: por imagem, por segundo de vídeo ou áudio, por música ou a cada 1.000 caracteres de voz. Resolução, duração, qualidade e arquivos de referência podem mudar o preço.

Alguns exemplos de preços da API em USD:

Modelos traz links para as páginas de referência dos modelos. Use a cotação ao vivo para suas configurações e preserve a precisão decimal em USD (até nove casas decimais); não arredonde cobranças da API para créditos inteiros. O Playground nas páginas de API gasta o mesmo saldo da API em USD.

Pergunte o valor exato antes de executar qualquer coisa:

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`);

O que acontece quando uma tarefa falha

Quando uma tarefa é aceita, seu maior preço possível em USD é separado do saldo da API como reserva. Quando ela termina:

Liberar a reserva de uma tarefa restaura os fundos disponíveis da API; não é um reembolso de um pagamento ao banco ou cartão. Leia costUsd com settled no registro da tarefa para saber o valor final em USD. Veja Cobrança da API.

Reembolsos de pagamentos da API

Para tirar dúvidas sobre um pagamento de fundos da API ou um reembolso, abra API billing ou fale com o suporte. Inclua a referência do pagamento ou o ID da tarefa correspondente, mas nunca sua chave de API.

Erros que você pode encontrar

Todos os códigos estão em Erros.

As chamadas da API custam mais que gerar no site?

Não. O mesmo modelo com as mesmas configurações tem o mesmo preço. Chamadas da API são cobradas em USD do saldo da API; gerações no site e chamadas MCP com OAuth gastam créditos do site. Os saldos continuam separados.

Preciso pedir a liberação da reserva de uma tarefa?

Não. Tarefas que falham ou expiram liberam suas reservas automaticamente, salvo cobranças por recusa de conteúdo específicas de cada modelo. Confira o costUsd liquidado da tarefa para saber o valor final em USD.

Posso receber reembolso de um pagamento de fundos da API?

Para saber os requisitos de reembolso e obter ajuda com um pagamento da API, abra API billing ou fale com o suporte.

Os fundos da API seguem as regras de validade dos créditos do site?

As regras de validade de pacotes e recompensas do site não definem as condições da API. Consulte API billing ou pergunte ao suporte sobre seus fundos da API.

Posso financiar a API com créditos do site?

Não. Adicione fundos à API por API billing. Créditos do site não financiam a API, fundos da API não podem ser usados para gerar no site e os saldos não podem ser transferidos.

Relacionado