---
title: "List effects"
method: GET
path: "/v1/effects"
tags: ["Effects"]
---

# List effects

`GET /v1/effects`

## Request

- Base URL: `https://apihub.co.il`
- URL: `https://apihub.co.il/v1/effects`
- Auth: HTTP bearer

Every effect of the library with its names (Hebrew and English), category, one line, inputs, timing, params (JSON schema with defaults and ranges), its real preview (video and poster) and its price per second of output. Order one with POST /v1/effects/{id}, or stack several in the `effects` array of /v1/studio/edit and /v1/studio/short. `coming` lists the effects of the next phase (drawn in a browser): no endpoint until they are switched on.

**Billing:** Read request — free · **Rate limit:** 120/min

## Query parameters

- `category` 'text' | 'transition' | 'camera' | 'look' | 'overlay' | 'layout' | 'audio' | 'speed': Only this category

## Headers

- `Idempotency-Key` string
- `X-Tag` string

## Response `200`

Completed

- object
  - `id` string: Execution id — stable across internal retries; use it with GET /v1/executions/{id}
  - `status` 'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
  - `operation` string
  - `tag` string, nullable: Your X-Tag, if sent
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable
  - `output` object: Operation result (see each operation). While a Studio render is processing: `stage` (queued · transcribing · downloading · preparing · cleaning_voice · mixing_audio · rendering · finishing), `phase` (the engine's: download · prepare · voice · audio · encode · qa · upload, or null), `progress` (a percent, 0–100) and `progress_fraction` (0–1), `eta_seconds` (seconds left, never below 0) and `estimate_seconds`
  - `error` string, nullable
  - `usage` object
    - `credits_charged` number, nullable
    - `credits_reserved` number
    - `estimated_credits` number
    - `cost_source` 'provider_reported' | 'calculated' | 'estimated' | 'null', nullable
    - `provider_usage` object, nullable: Normalised consumption, e.g. { VIDEO_SECOND: 22.4 }
  - `balance` object
    - `available` number
    - `reserved` number

## Other responses

- `400`: Invalid input
- `402`: Insufficient credits / project budget
- `404`: Resource not found (or not yours)
- `429`: Rate limited
- `503`: Service temporarily paused

---

[API](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai.md) · [All operations](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/revisions/a8caa42835ce?raw)