Saldo de la API y reembolsos

La API de PopNow tiene su propio saldo en USD, separado de los créditos de la web. Las llamadas con clave de API, las conexiones MCP con clave de API y las ejecuciones de Playground gastan USD de la API. MCP conectado mediante OAuth sigue gastando créditos de la web. El mismo modelo con los mismos ajustes tiene el mismo precio en la API y en la web; los saldos no se pueden transferir ni usar uno en lugar del otro.

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 API billing antes de enviar solicitudes de pago, incluidas las pruebas en Playground.
• Fondos separados. Los paquetes de créditos, los créditos extra y las recompensas de la web no pagan las llamadas a la API. Los fondos de la API no pagan las generaciones de la web ni las llamadas MCP con OAuth.
• Cotiza antes de ejecutar. jobs/quote devuelve expectedChargeUsd y maxChargeUsd como cadenas decimales en USD sin iniciar una tarea.
• Lee 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, salvo los cargos por rechazo de contenido específicos de cada modelo.

De dónde salen los fondos de la API

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

Los créditos extra de los paquetes, las recompensas por invitación y otros créditos concedidos en la web no aumentan el saldo de la API. Los tamaños de los paquetes, los plazos de reembolso y las reglas de caducidad de la web no son condiciones de los fondos de la API.

Qué saldo se usa

La credencial y la interfaz determinan qué saldo paga:

Añadir fondos a un saldo no repone el otro. Si una solicitud de la API no puede cubrir su retención, añade fondos a la API en lugar de comprar créditos de la web.

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 a créditos enteros. Playground en las páginas de API gasta el mismo saldo de la API en USD.

Pregunta el importe exacto antes de ejecutar nada:

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

Para consultar un pago de fondos de la API o un reembolso, abre API billing 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; las generaciones de la web y las llamadas MCP con OAuth gastan créditos de la web. Los saldos siguen separados.

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

No. Las tareas fallidas y caducadas liberan sus retenciones automáticamente, salvo los cargos por rechazo de contenido específicos de cada modelo. Consulta el costUsd liquidado de la tarea para saber el importe final en USD.

¿Puedo obtener un reembolso de un pago de fondos de la API?

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

¿Los fondos de la API siguen las reglas de caducidad de los créditos de la web?

Las reglas de caducidad de los paquetes y las recompensas de la web no definen las condiciones de la API. Consulta API billing o pregunta a soporte por tus fondos de la API.

¿Puedo financiar la API con créditos de la web?

No. Añade fondos a la API a través de API billing. Los créditos de la web no pueden financiar la API, los fondos de la API no se pueden usar para generar en la web y los saldos no se pueden transferir.

Relacionado