API de PageToVid

Autenticación

Crea una clave API en tu cuenta, y envíala como token Bearer. Mantenla en secreto — gasta tus créditos.

http
Authorization: Bearer cp_live_xxxxxxxxxxxxxxxx

URL base: https://pagetovid.com · 1 crédito = 1 vídeo renderizado.

Crear un vídeo

POST /api/v1/videos — devuelve de inmediato un id; el renderizado se ejecuta async.

curl
curl -X POST https://pagetovid.com/api/v1/videos \
  -H "Authorization: Bearer $PAGETOVID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://stripe.com",
    "goal": "ad",          // explainer | ad | demo | tutorial
    "aspect": "16:9",      // 16:9 | 9:16 | 1:1
    "language": "en",
    "targetSeconds": 35,
    "subtitles": true
  }'

Respuesta (202):

json
{
  "id": "cmq…",
  "status": "analyzing",
  "statusUrl": "https://pagetovid.com/api/v1/videos/cmq…"
}

Obtener un vídeo / consultar estado

GET /api/v1/videos/:id — consulta hasta status: "done".

json
{
  "id": "cmq…",
  "status": "done",          // analyzing | scripting | recording | voicing | rendering | done | error
  "progress": 100,
  "videoUrl":  "https://pagetovid.com/media/cmq…/video.mp4",
  "posterUrl": "https://pagetovid.com/media/cmq…/scene-2.png",
  "subtitleUrl": "https://pagetovid.com/media/cmq…/subtitles.vtt",
  "durationMs": 41000,
  "width": 1920, "height": 1080,
  "og": { "og:video": "…", "og:image": "…", "og:video:type": "video/mp4", … }
}

Automatízalo

Genera + espera, en cualquier lenguaje.

javascript
const KEY = process.env.PAGETOVID_API_KEY;
const create = await fetch("https://pagetovid.com/api/v1/videos", {
  method: "POST",
  headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://your-site.com", goal: "ad" }),
}).then((r) => r.json());

let v;
do {
  await new Promise((r) => setTimeout(r, 5000));
  v = await fetch(create.statusUrl, { headers: { Authorization: `Bearer ${KEY}` } }).then((r) => r.json());
} while (v.status !== "done" && v.status !== "error");

console.log(v.videoUrl, v.posterUrl, v.og);

python
import os, time, requests
KEY = os.environ["PAGETOVID_API_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

r = requests.post("https://pagetovid.com/api/v1/videos", headers=H, json={"url": "https://your-site.com", "goal": "ad"}).json()
while True:
    time.sleep(5)
    v = requests.get(r["statusUrl"], headers=H).json()
    if v["status"] in ("done", "error"):
        break
print(v["videoUrl"], v["posterUrl"], v["og"])

Errores y límites

• 401 — clave API no válida o ausente.
• 402 — sin créditos. Recarga en precios.
• 400 — entrada no válida (se requiere una url).
• El renderizado es async — tarda unos minutos; consulta la URL de estado.
• CORS está habilitado, así que puedes llamarlo directamente desde el navegador.