Quick Start

Get up and running with the Zebracat API in minutes. By the end of this guide, you'll have generated your first AI video from a text idea.

Step 1 — Create an API Key

Before making any requests, you need an API key.

POST https://api.zebracat.ai/api_keys

You'll get back a response like this:

{
  "id": 1,
  "api_key": "zc_live_xxxxxxxxxxxx",
  "name": "My First Key",
  "is_active": true
}

⚠️ Save your api_key now. The full key is only shown once at creation.

From here on, pass it in every request as a header:

X-API-KEY: zc_live_xxxxxxxxxxxx

Turn any text idea into a video in one call.

POST https://api.zebracat.ai/v1/video/idea

You'll receive a task_id immediately:

{
  "task_id": "task_abc123",
  "status": "pending"
}

💡 Video generation runs asynchronously. Use the task_id in the next step to track progress.

GET https://api.zebracat.ai/v1/video/status?task_id=task_abc123

Poll every 10–30 seconds until status is completed:

{
  "task_id": "task_abc123",
  "status": "completed",
  "video_url": "https://cdn.zebracat.ai/videos/your-video.mp4"
}

Possible status values:

🎙 Script to Video — Use your own script instead of an idea

🌐 Blog/URL to Video — Turn any webpage into a video

🔔 Webhooks — Get notified automatically when your video is ready instead of polling

🎨 Visual Styles — Customize the look of your video