Saldo de la API y reembolsos

La API de PopNow tiene su propio saldo en USD. Lo usan las llamadas con clave de API, el MCP para desarrolladores y las ejecuciones de Playground en las páginas de la API. Un modelo cuesta lo mismo en la API y en popnow.ai con los mismos ajustes.

Esta página explica los fondos de la API, los precios y la liberación de retenciones. Para las retenciones, cotizaciones y topes por tarea, consulta Facturación de la API.

El saldo de la API en un minuto

• Empieza en $0. Añade fondos en facturación de la API antes de enviar solicitudes con coste, incluidas las pruebas en Playground.
• Financiación propia. Solo los fondos añadidos en Facturación de la API entran en este saldo, y solo la API los gasta.
• Cotiza antes de ejecutar. jobs/quote devuelve expectedChargeUsd y maxChargeUsd como cadenas decimales en USD sin iniciar una tarea.
• Comprueba el importe liquidado. El costUsd de una tarea es su cargo final en USD cuando settled es true. Las tareas fallidas o caducadas liberan sus retenciones automáticamente.

Añadir fondos a la API y consultar los pagos

Gestiona los fondos de la API y los registros de pago en facturación de la API, con las opciones de pago habilitadas allí. Crea y gestiona las claves por separado en claves de API.

Qué usa el saldo de la API

Si una solicitud de la API no puede cubrir su retención, añade fondos en Facturación de la API.

Cómo se calcula el precio de una generación

Cada modelo tiene su propia lista de precios por opción: por imagen, por segundo de video o audio, por canción o por cada 1000 caracteres de voz. La resolución, la duración, la calidad y los archivos de referencia pueden cambiar el precio.

Algunos ejemplos de precios de la API en USD:

Modelos enlaza a las páginas de referencia de los modelos. Usa la cotización en vivo para tus ajustes y conserva la precisión decimal en USD (hasta nueve decimales); no redondees los cargos de la API. Playground en las páginas de API gasta el mismo saldo de la API en USD.

Consulta el importe exacto antes de iniciar la generación:

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

Qué pasa cuando falla una tarea

Cuando se acepta una tarea, su precio máximo posible en USD se aparta de tu saldo de la API como retención. Cuando termina:

Liberar la retención de una tarea restaura los fondos disponibles de la API; no es un reembolso de un pago a tu banco o tarjeta. Lee costUsd junto con settled en el registro de la tarea para saber el importe final en USD. Consulta Facturación de la API.

Reembolsos de pagos de la API

Si tienes dudas sobre un pago para añadir fondos a la API o sobre su reembolso, abre facturación de la API o contacta con soporte. Incluye la referencia del pago o el ID de la tarea correspondiente, pero nunca tu clave de API.

Errores que puedes encontrar

Todos los códigos están en Errores.

¿Las llamadas a la API cuestan más que generar en la web?

No. El mismo modelo con los mismos ajustes tiene el mismo precio. Las llamadas a la API se cobran en USD del saldo de la API.

¿Tengo que pedir que se libere la retención de una tarea?

No. Las tareas fallidas y caducadas liberan sus retenciones automáticamente. Consulta el costUsd liquidado de la tarea para saber el importe final en USD.

¿Puedo solicitar el reembolso de una recarga de la API?

Para conocer los requisitos de reembolso y recibir ayuda con un pago de la API, abre facturación de la API o contacta con soporte.

Relacionado