Saldo da API e reembolsos

A API da PopNow tem seu próprio saldo em USD. Chamadas com chave de API, o MCP para desenvolvedores e execuções do Playground nas páginas da API usam esse saldo. Um modelo custa o mesmo na API e no popnow.ai com as mesmas configurações.

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 cobrança da API antes de enviar requisições pagas, incluindo testes no Playground.
• Fundos próprios. Somente os fundos adicionados em Cobrança da API entram nesse saldo, e apenas a API os utiliza.
• Cote antes de executar. jobs/quote retorna expectedChargeUsd e maxChargeUsd como strings decimais em USD sem iniciar uma tarefa.
• Confira 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.

Adicionar fundos à API e consultar pagamentos

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

O que usa o saldo da API

Se uma requisição da API não puder cobrir sua reserva, adicione fundos em Cobrança da API.

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. Consulte a cotação atual para suas configurações e preserve a precisão decimal em USD (até nove casas decimais); não arredonde cobranças da API. O Playground nas páginas de API usa o mesmo saldo da API em USD.

Consulte o valor exato antes de iniciar a geração:

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

Se tiver dúvidas sobre um pagamento para adicionar fundos à API ou sobre seu reembolso, abra cobrança da API 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.

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

Não. Tarefas que falham ou expiram liberam suas reservas automaticamente. Confira o costUsd liquidado da tarefa para saber o valor final em USD.

Posso receber o reembolso de uma recarga da API?

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

Relacionado