API Integration Guide

This guide walks you through everything you need to start using the Giggle API — from registration to your first request, in about 5 minutes.

Overview

Register / Log in → Top Up → Get API Key → Read the Docs → Start Calling

Step 1: Register / Log In

Visit giggle.pro and sign up or log in with your email or Google account.

Step 2: Top Up

After logging in, click your avatar in the bottom-left corner to open the menu, then click "Top Up" to add credits to your account.

Exchange rate: $1.00 = 100 Credits. See Pricing & Billing for details.

Step 3: Get Your API Key

Click "API Key" in the left navigation bar to open the API Key Management page. Click "+ New API Key" in the top-right corner to generate your key.

You can create up to 5 API Keys per account. Copy and store your key securely — it will not be shown again.

Security Notes:

Never share your API key in public repositories or client-side code

Store your API key securely in environment variables

Rotate your API key regularly for better security

Step 4: Read the Docs

Visit the API Documentation to explore request parameters and response formats. The following endpoints are currently available:

Endpoint	Method	Description
Image to video	POST	Generate video from an image
Text to video	POST	Generate video from a text prompt
Omni video	POST	Generate video from multi-modal references
Query Task	GET	Poll the status of a generation task

Step 5: Start Calling

Set your API Key in the x-auth request header and make your first call:

Success response:

{
  "code": 200,
  "msg": "success",
  "uuid": "87df77c8-12de-4bd6-91f1-3832c7bcecf9",
  "data": {
    "task_id": "your-task-id"
  }
}

Use the returned task_id to poll the Query Task endpoint for your result:

When the status field in the response is completed, the urls field will contain the downloadable video link(s).

Overview#

Step 1: Register / Log In#

Step 2: Top Up#

Step 3: Get Your API Key#