# Send Fliz AI Video Generator to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "fliz-ai-video-generator",
    "name": "Fliz AI Video Generator",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/jb-fliz/fliz-ai-video-generator",
    "canonicalUrl": "https://clawhub.ai/jb-fliz/fliz-ai-video-generator",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/fliz-ai-video-generator",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fliz-ai-video-generator",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "LICENSE.txt",
      "assets/examples/python_client.py",
      "assets/examples/nodejs_client.js",
      "assets/examples/webhook_handler.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/fliz-ai-video-generator"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/fliz-ai-video-generator",
    "downloadUrl": "https://openagent3.xyz/downloads/fliz-ai-video-generator",
    "agentUrl": "https://openagent3.xyz/skills/fliz-ai-video-generator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fliz-ai-video-generator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fliz-ai-video-generator/agent.md"
  }
}
```
## Documentation

### Fliz API Integration Skill

Transform text content into AI-generated videos programmatically.

### Quick Reference

ItemValueBase URLhttps://app.fliz.aiAuthBearer Token (JWT)Get Tokenhttps://app.fliz.ai/api-keysAPI Docshttps://app.fliz.ai/api-docsFormatJSON

### Authentication

All requests require Bearer token authentication:

curl -X GET "https://app.fliz.ai/api/rest/voices" \\
  -H "Authorization: Bearer YOUR_API_KEY" \\
  -H "Content-Type: application/json"

Test connection by calling GET /api/rest/voices - returns 200 if token is valid.

### 1. Create Video

POST /api/rest/video

Minimal request:

{
  "fliz_video_create_input": {
    "name": "Video Title",
    "description": "Full content text to transform into video",
    "format": "size_16_9",
    "lang": "en"
  }
}

Response:

{
  "fliz_video_create": {
    "video_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
  }
}

CRITICAL: The description field must contain the FULL TEXT content. Fliz does NOT extract content from URLs - upstream systems must fetch/process content first.

### 2. Get Video Status

GET /api/rest/videos/{id}

Poll this endpoint to track video generation progress. Check the step field:

StepStatuspending → scrapping → script → image_* → speech → video_renderingProcessingcomplete✅ Ready - url field contains MP4failed / failed_unrecoverable❌ Error - check error fielduser_action⚠️ Requires manual intervention

### 3. List Videos

GET /api/rest/videos?limit=20&offset=0

### 4. Translate Video

POST /api/rest/videos/{from_video_id}/translate?new_lang=fr

Creates a new video in the target language.

### 5. Duplicate Video

POST /api/rest/videos/{from_video_id}/duplicate

### 6. List Voices / Musics

GET /api/rest/voices
GET /api/rest/musics

### Required Fields

name (string): Video title
description (string): Full text content
format (enum): size_16_9 | size_9_16 | square
lang (string): ISO 639-1 code (en, fr, es, de, pt, etc.)

### Optional Customization

FieldDescriptionDefaultcategoryarticle | product | adarticlescript_styleNarrative styleautoimage_styleVisual stylehyperrealisticcaption_styleSubtitle styleanimated_backgroundcaption_positionbottom | centerbottomcaption_fontFont familypoppinscaption_colorHex color (#FFFFFF)whitecaption_uppercaseBooleanfalsevoice_idCustom voice IDautois_male_voiceBooleanautomusic_idMusic track IDautomusic_urlCustom music URLnullmusic_volume0-10015watermark_urlImage URLnullsite_urlCTA URLnullsite_nameCTA textnullwebhook_urlCallback URLnullis_automaticAuto-processtruevideo_animation_modefull_video | hook_onlyfull_videoimage_urlsArray of URLsnull

Note: For product and ad categories, image_urls is required (3-10 images).

For complete enum values, see references/enums-values.md.

### Webhooks

Configure webhook_url to receive notifications when video is ready or fails:

{
  "event": "video.complete",
  "video_id": "a1b2c3d4-...",
  "step": "complete",
  "url": "https://cdn.fliz.ai/videos/xxx.mp4"
}

### Error Handling

HTTP CodeMeaningAction200SuccessContinue400Bad RequestCheck params401UnauthorizedInvalid/expired token404Not FoundInvalid video ID429Rate LimitedRetry with backoff500Server ErrorRetry later

### Polling Pattern (Recommended)

1. POST /api/rest/video → get video_id
2. Loop: GET /api/rest/videos/{id}
   - If step == "complete": done, get url
   - If step contains "failed": error
   - Else: wait 10-30s, retry

### Webhook Pattern

1. POST /api/rest/video with webhook_url
2. Process webhook callback when received

### Code Examples

See assets/examples/ for ready-to-use implementations:

python_client.py - Full Python wrapper
nodejs_client.js - Node.js implementation
curl_examples.sh - cURL commands
webhook_handler.py - Flask webhook server

### Scripts

ScriptUsagescripts/test_connection.pyValidate API keyscripts/create_video.pyCreate video from text filescripts/poll_status.pyMonitor video generationscripts/list_resources.pyFetch voices/musics

Run with: python scripts/<script>.py --api-key YOUR_KEY

### Common Issues

"Invalid API response": Verify JSON structure matches documentation exactly.

Video stuck in processing: Check step field - some steps like user_action require manual intervention in Fliz dashboard.

No URL extraction: The API requires direct text input. Build content extraction into your integration.

### References

API Reference - Complete endpoint documentation
Enum Values - All valid parameter values
Integration Examples - Ready-to-use code
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jb-fliz
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/fliz-ai-video-generator)
- [Send to Agent page](https://openagent3.xyz/skills/fliz-ai-video-generator/agent)
- [JSON manifest](https://openagent3.xyz/skills/fliz-ai-video-generator/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/fliz-ai-video-generator/agent.md)
- [Download page](https://openagent3.xyz/downloads/fliz-ai-video-generator)