polloaiofficial/pollo-skills / skills/pollo-ai-video-generator
pollo-ai-video-generator
UnverifiedGenerate 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.5 KB |
| agents/openai.yaml | config | 310 B |
| references/brands/bytedance.md | markdown | 6.7 KB |
| references/brands/google.md | markdown | 9.1 KB |
| references/brands/hunyuan.md | markdown | 1.2 KB |
| references/brands/kling-ai.md | markdown | 13.4 KB |
| references/brands/luma.md | markdown | 4.2 KB |
| references/brands/minimax.md | markdown | 4.4 KB |
| references/brands/pika.md | markdown | 2.8 KB |
| references/brands/pixverse.md | markdown | 10.8 KB |
| references/brands/pollo.md | markdown | 4.2 KB |
| references/brands/runway.md | markdown | 1.8 KB |
| references/brands/sora.md | markdown | 2.4 KB |
| references/brands/vidu.md | markdown | 8.1 KB |
| references/brands/wanx.md | markdown | 7.4 KB |
| references/common.md | markdown | 3.1 KB |
| references/models-index.md | markdown | 4.8 KB |
| scripts/poll_task.py | script | 5.7 KB |
| scripts/pollo_api.py | script | 3.8 KB |
| scripts/pollo_config.py | script | 3.0 KB |
| scripts/pollo_setup.py | script | 4.1 KB |
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"
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |