freepik

# Freepik API Skill

Generate images, videos, icons, audio, edit images, and search stock content using the Freepik API.

Built by the [ShellBot](https://getshell.ai) team.

## Arguments

- **Command:** `$0` (generate | video | edit | icon | audio | stock | status | utility)
- **Arg 1:** `$1` (model name, operation type, or task-id)
- **Arg 2+:** `$2`, `$3`, etc. (additional parameters)
- **All args:** `$ARGUMENTS`

## Session Output

Save generated files to session folder:
```bash
mkdir -p ~/.freepik/sessions/${CLAUDE_SESSION_ID}
```

Downloaded images/videos/audio go to: `~/.freepik/sessions/${CLAUDE_SESSION_ID}/`

---

## Authentication

All requests require the `FREEPIK_API_KEY` environment variable.

**Header:** `x-freepik-api-key: $FREEPIK_API_KEY`

**Base URL:** `https://api.freepik.com`

If requests fail with 401/403, tell the user:
```
Get an API key from https://www.freepik.com/developers/dashboard/api-key
Then: export FREEPIK_API_KEY="your-key-here"
```

---

## Async Task Pattern

Most AI endpoints are asynchronous. Follow this pattern:

**Step 1: Submit task**
```bash
RESPONSE=$(curl -s -X POST "https://api.freepik.com/v1/ai/<endpoint>" \
  -H "x-freepik-api-key: $FREEPIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '<JSON_PAYLOAD>')
TASK_ID=$(echo "$RESPONSE" | jq -r '.task_id // .data.task_id // .id')
echo "Task ID: $TASK_ID"
```

**Step 2: Poll for completion**
```bash
while true; do
  RESULT=$(curl -s "https://api.freepik.com/v1/ai/<endpoint>/$TASK_ID" \
    -H "x-freepik-api-key: $FREEPIK_API_KEY")
  STATUS=$(echo "$RESULT" | jq -r '.data.status // .status')
  echo "Status: $STATUS"
  if [ "$STATUS" = "COMPLETED" ]; then break; fi
  if [ "$STATUS" = "FAILED" ]; then echo "Task failed"; echo "$RESULT" | jq; break; fi
  sleep 3
done
```

**Step 3: Extract result URL**
```bash
mkdir -p ~/.freepik/sessions/${CLAUDE_SESSION_ID}
echo "$RESULT" | jq -r '.data.generated[0] // .data.result.url // .data.image.url // empty'
```

Present the result...

# freepik-skill

![ShellBot Cover](shellbot-cover.png)

An [OpenClaw](https://openclaw.ai) skill for the [Freepik API](https://www.freepik.com/api) — image generation, video generation, image editing, icon generation, audio, stock content, and AI utilities.

Built and maintained by the [ShellBot](https://getshell.ai) team for use with OpenClaw hosted instances.

> **Free credits:** Register at [freepik.com](https://www.freepik.com/) and get **$5 USD in free API credits** to start generating right away — no credit card required.

## Installation

### From ClawHub (recommended)

```bash
clawhub install freepik
```

### Manual

```bash
git clone https://github.com/SqaaSSL/freepik-openclaw-skill ~/.openclaw/skills/freepik
```

## Setup

1. Get an API key from [Freepik Developers Dashboard](https://www.freepik.com/developers/dashboard)

2. Add to your shell config (`~/.zshrc` or `~/.bashrc`):
   ```bash
   export FREEPIK_API_KEY="your-key-here"
   ```

3. Reload your shell:
   ```bash
   source ~/.zshrc
   ```

## Architecture

### How the Skill Works

```mermaid
flowchart LR
    User([User]) -->|natural language\nor /freepik command| Agent[OpenClaw Agent]
    Agent -->|reads| Skill[SKILL.md]
    Skill -->|instructs| Agent
    Agent -->|curl POST| API[Freepik API]
    API -->|task_id| Agent
    Agent -->|poll GET| API
    API -->|result URL| Agent
    Agent -->|curl download| Files[Local Files]
    Files -->|~/.freepik/sessions/| User
```

### Async Task Lifecycle

```mermaid
sequenceDiagram
    participant A as OpenClaw Agent
    participant F as Freepik API

    A->>F: POST /v1/ai/{endpoint} (prompt, params)
    F-->>A: { task_id: "abc-123" }

    loop Poll every 3s
        A->>F: GET /v1/ai/{endpoint}/abc-123
        F-->>A: { status: "IN_PROGRESS" }
    end

    A->>F: GET /v1/ai/{endpoint}/abc-123
    F-->>A: { status: "COMPLETED", result: { url: "..." } }

    A->>A: Download & save to session folder
```

## Usage

### Commands

| Command | Description |
|---------...