API documentation

https://peekaai.com/api/v1

Authorization: Bearer pk_live_xxxxxxxxxxxxxxxx

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1744632060

curl -X POST https://peekaai.com/api/v1/videos \
  -H "Authorization: Bearer pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "prompt": "A cinematic shot of a mountain sunrise, 4K, golden hour",
    "duration": 5,
    "ratio": "16:9",
    "model": "standard"
  }'

curl -X POST https://peekaai.com/api/v1/videos \
  -H "Authorization: Bearer pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Camera slowly zooms in",
    "image_urls": [
      "https://example.com/photo1.jpg",
      "https://example.com/photo2.jpg"
    ],
    "subject_consent": "self",
    "duration": 5,
    "ratio": "16:9"
  }'

const response = await fetch('https://peekaai.com/api/v1/videos', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.PEEKA_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'A cinematic shot of a mountain sunrise',
    duration: 5,
    ratio: '16:9',
  }),
});
const { id, poll_url } = await response.json();

import requests

resp = requests.post(
    'https://peekaai.com/api/v1/videos',
    headers={
        'Authorization': f'Bearer {PEEKA_API_KEY}',
        'Content-Type': 'application/json',
    },
    json={
        'prompt': 'A cinematic shot of a mountain sunrise',
        'duration': 5,
        'ratio': '16:9',
    },
)
data = resp.json()
print(data['id'], data['poll_url'])

{
  "id": 42,
  "status": "pending",
  "credits_used": 9,
  "duration": 5,
  "ratio": "16:9",
  "model": "standard",
  "prompt": "A cinematic shot of a mountain sunrise",
  "estimated_time_seconds": 30,
  "created_at": "2026-04-14T12:00:00Z",
  "poll_url": "https://peekaai.com/api/v1/videos/42"
}

curl https://peekaai.com/api/v1/videos/42 \
  -H "Authorization: Bearer pk_live_YOUR_KEY"

{
  "id": 42,
  "status": "done",
  "prompt": "A cinematic shot of a mountain sunrise",
  "video_url": "https://peekaai.com/api/v1/media/42.mp4?exp=1790000000&sig=…",
  "poster_url": "https://peekaai.com/api/v1/media/42.jpg?exp=1790000000&sig=…",
  "share_page_url": null,
  "credits_used": 9,
  "refunded": false,
  "model": "standard",
  "duration": 5,
  "ratio": "16:9",
  "progress": null,
  "error": null,
  "error_code": null,
  "created_at": "2026-04-14T12:00:00Z",
  "completed_at": "2026-04-14T12:01:28Z",
  "poll_url": "https://peekaai.com/api/v1/videos/42"
}

async function waitForVideo(apiKey, videoId) {
  const url = `https://peekaai.com/api/v1/videos/${videoId}`;
  const headers = { 'Authorization': `Bearer ${apiKey}` };

  while (true) {
    const res = await fetch(url, { headers });
    const data = await res.json();

    if (data.status === 'done') return data.video_url;
    if (data.status === 'error') throw new Error(data.error || 'Generation failed');

    // poll every 5 seconds
    await new Promise(r => setTimeout(r, 5000));
  }
}

curl -X POST https://peekaai.com/api/v1/assets \
  -H "Authorization: Bearer pk_live_YOUR_KEY" \
  -F "file=@/path/to/photo.jpg"

{
  "id": 1234,
  "asset_uri": "asset://asset-20260517123045-a8b3",
  "public_url": "https://peekaai.com/uploads/42/1715938245_a1b2c3d4.jpg",
  "name": "photo.jpg",
  "file_size": 184320,
  "mime_type": "image/jpeg",
  "trust_level": "trusted",
  "deduped": false,
  "created_at": "2026-05-17T12:30:45Z"
}

curl -X POST https://peekaai.com/api/v1/videos \
  -H "Authorization: Bearer pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Smile and wave at camera",
    "asset_ids": [1234],
    "duration": 5
  }'

curl -X POST https://peekaai.com/api/v1/videos \
  -H "Authorization: Bearer pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene lake at dawn",
    "duration": 5,
    "callback_url": "https://your-app.com/peeka/webhook"
  }'

{
  "event": "video.completed",
  "id": 42,
  "status": "done",
  "prompt": "A serene lake at dawn",
  "video_url": "https://peekaai.com/api/video-stream/42",
  "error": null,
  "credits_used": 9,
  "duration": 5,
  "model": "standard",
  "created_at": "2026-05-17T12:30:00Z",
  "completed_at": "2026-05-17T12:30:28Z",
  "delivered_at": "2026-05-17T12:30:29Z"
}

import crypto from 'crypto';
import express from 'express';

const app = express();

// Webhook signing secret returned by POST /api/api-keys (shown once)
const WEBHOOK_SECRET = process.env.PEEKA_WEBHOOK_SECRET;

// IMPORTANT: pass raw body to HMAC. Use express.raw() not express.json().
app.post('/peeka/webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = req.header('X-Peeka-Signature') || '';
  const expected = 'sha256=' + crypto.createHmac('sha256', WEBHOOK_SECRET)
    .update(req.body)
    .digest('hex');
  if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected))) {
    return res.status(401).send('bad signature');
  }
  const payload = JSON.parse(req.body.toString());
  console.log(payload.event, payload.id, payload.video_url);
  res.status(200).send('ok'); // return 2xx to ack; non-2xx triggers retry
});

import hmac, hashlib
from flask import Flask, request

app = Flask(__name__)
WEBHOOK_SECRET = os.environ['PEEKA_WEBHOOK_SECRET']

@app.post('/peeka/webhook')
def webhook():
    sig = request.headers.get('X-Peeka-Signature', '')
    expected = 'sha256=' + hmac.new(
        WEBHOOK_SECRET.encode(),
        request.get_data(),
        hashlib.sha256,
    ).hexdigest()
    if not hmac.compare_digest(sig, expected):
        return 'bad signature', 401
    payload = request.get_json()
    print(payload['event'], payload['id'], payload['video_url'])
    return 'ok', 200  # return 2xx to ack

curl -X POST https://peekaai.com/api/v1/videos/42/retry \
  -H "Authorization: Bearer pk_live_YOUR_KEY"

{
  "id": 73,
  "status": "pending",
  "retry_of_task_id": 42,
  "credits_used": 9,
  "free_retry": false,
  "prompt": "A serene lake at dawn",
  "model": "standard",
  "duration": 5,
  "ratio": "9:16",
  "callback_url": "https://your-app.com/peeka/webhook",
  "callback_enabled": true,
  "estimated_time_seconds": 70,
  "created_at": "2026-05-17T13:00:00Z",
  "poll_url": "https://peekaai.com/api/v1/videos/73"
}

curl -X POST https://peekaai.com/api/v1/videos/batch \
  -H "Authorization: Bearer pk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "defaults": {
      "model": "standard",
      "duration": 5,
      "ratio": "9:16",
      "asset_ids": [1234],
      "callback_url": "https://your-app.com/peeka/webhook"
    },
    "items": [
      { "prompt": "Scene 1: she walks into the cafe" },
      { "prompt": "Scene 2: she orders coffee, smiling" },
      { "prompt": "Scene 3: she sits by the window, looking out" }
    ]
  }'

{
  "batch_id": "batch_1715958000123_a1b2c3d4",
  "total_credits_used": 27,
  "items_count": 3,
  "items": [
    {
      "index": 0, "ok": true, "id": 100, "status": "pending",
      "credits_used": 9, "prompt": "Scene 1: she walks into the cafe",
      "model": "standard", "duration": 5, "ratio": "9:16",
      "asset_source": "asset_ids", "asset_ids_used": [1234],
      "callback_enabled": true, "estimated_time_seconds": 70,
      "poll_url": "https://peekaai.com/api/v1/videos/100"
    },
    { "index": 1, "ok": true, "id": 101, "...": "..." },
    { "index": 2, "ok": true, "id": 102, "...": "..." }
  ],
  "created_at": "2026-05-17T13:00:00Z"
}