Skip to content

polloaiofficial/pollo-skills / skills/pollo-ai-video-generator

pollo-ai-video-generator

Unverified

Generate AI videos using the Pollo AI API. Supports 13 leading models (Kling, Sora, Runway, Veo, Pixverse, Hailuo, Vidu, Luma, Pika, Wan, Seedance, Hunyuan, Pollo) with 50+ versions. It also supports task polling, credit cost estimation, and credit balance checks. Use this skill whenever the user wants to generate an AI video from text or image, use any AI video model, check Pollo credits, or mentions Pollo AI, pollo.ai, or any of the supported model names. Even if the user just says "generate a video" or "make me a short clip" without mentioning Pollo, this skill should be used.

references/common.md

View on GitHub
# Common API Reference

## Authentication

All requests require the `X-API-KEY` header.

```
X-API-KEY: <your-api-key>
```

Get your API key at: https://pollo.ai/api-platform/keys

## Base URL

```
https://pollo.ai/api/platform
```

## Task Status

After creating a generation task, poll the status endpoint until completion.

### Query task generation status

- **Endpoint**: `GET /generation/{taskId}/status`

#### Response

- `taskId` (string) **(required)**
- `generations` (array[object]) **(required)**
  - `id` (string) **(required)**
  - `createdDate` (string)
  - `updatedDate` (string)
  - `status` (string) **(required)** — enum: `waiting`, `succeed`, `failed`, `processing`
  - `failMsg` (string) **(required)**
  - `url` (string) **(required)**
    All generated videos and images are stored for up to 14 days only; we cannot guarantee storage beyond that period.
  - `mediaType` (string) **(required)** — enum: `image`, `video`, `text`, `audio`

### Status Values

- `waiting` — task queued
- `processing` — generation in progress
- `succeed` — completed, video/image URL available
- `failed` — generation failed

### Polling Strategy

- Poll every 5-10 seconds
- Videos are stored for **2 weeks** — download promptly

## Credits

### get credit

- **Endpoint**: `POST /credit`

#### Request

- `taskType` (string) **(required)**
- `generationConfig` ()
- `templateId` (string)
- `templateCode` (string)
- `actualDuration` (number)
- `numOutputs` (number) — default: `1`
- `scale` (number)
- `imageUrl` (string)
- `videoUrl` (string)
- `addAudioAuto` (boolean)
- `audioPrompt` (string)
- `startClipTime` (number)
- `endClipTime` (number)

#### Response

- `cost` (number) **(required)**
- `singleCost` (number) **(required)**
- `discountCost` (number) **(required)**
- `discountSingleCost` (number) **(required)**

### get credit balance

- **Endpoint**: `GET /credit/balance`

#### Response

- `availableCredits` (number) **(required)**
- `totalCredits` (number) **(required)**

## File Upload

- **Endpoint**: `POST /file/sign`

#### Request

- `action` (string) **(required)**
- `filename` (string) **(required)**
- `type` (string) **(required)**
- `userId` (string)

## Webhooks

Instead of polling, you can configure a `webhookUrl` in the generation request.
The webhook will be called when the task completes.

### Signature Verification

Webhooks include an `X-Signature` header for HMAC-SHA-256 verification.
Get your Secret Key at: https://pollo.ai/api-platform/keys (Secret Key tab).

```python
import hmac, hashlib

signature = hmac.new(secret_key.encode(), request_body, hashlib.sha256).hexdigest()
# Compare with X-Signature header
```

### Retry Mechanism

Failed webhook deliveries are retried up to 10 times with exponential backoff.

## Response Wrapper

All successful API responses are wrapped in a standard envelope:

```json
{
  "code": "SUCCESS",
  "message": "success",
  "data": { ... }
}
```

Always extract the actual payload from the `data` field. The schemas documented below describe the contents of `data`, not the top-level response.

## Error Response Format

```json
{
  "code": "ERROR_CODE",
  "message": "error description"
}
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall