# Higgsfield AI Visual Effects

Higgsfield AI is an advanced visual effects model designed to create professional-grade cinematic content and stunning visuals. Built for filmmakers, content creators, and digital artists, it delivers high-quality realistic imagery with dramatic lighting, atmospheric effects, and precise detail rendering. Perfect for YouTube thumbnails, film production, advertising visuals, and creative projects that demand cinema-level quality with fast processing speeds.

## API Information

- **Model Slug:** higgsfield-ai-visual-effects
- **Branded URL:** https://www.eachlabs.ai/higgsfield/higgsfield/higgsfield-ai-visual-effects
- **Provider:** Higgsfield
- **Category:** Image to Video
- **Output Type:** video
- **Status:** active
- **Base Cost:** $0.125–$0.563 per execution, depending on model
- **Estimated Processing Time:** 80 seconds
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/higgsfield-ai-visual-effects

## Pricing

- **Charge Type:** dynamic
- **Estimate:** $0.125–$0.563 per execution, depending on model
- **Pricing Details:** dop-lite: $0.125
- **Pricing Details:** dop-preview: $0.563
- **Pricing Details:** dop-turbo: $0.406

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| prompt | string | Yes | - | - | Text description guiding the visual effects and motion applied to your image. Describe camera movements, environmental dynamics, lighting shifts, and scene motion. The more specific and detailed your prompt, the better the cinematic result. |
| image_url | string | Yes | - | - | URL of the input image to animate with visual effects. Supported formats: JPEG, PNG, WebP. High-resolution images recommended for best cinematic quality. |
| model | string | Yes | dop-turbo | dop-lite, dop-preview, dop-turbo | Quality tier for video generation. dop-lite: fastest rendering, ideal for quick concept previews and rough motion drafts. dop-turbo: balanced speed and quality with priority queue access, smooth and detailed output (default, recommended for most use cases). dop-preview: highest video quality with enhanced lighting realism and priority processing for professional-grade production. |
| motions | array | Yes | - | - | Array of motion presets to apply to the image. Each motion object contains an id (UUID of the motion preset from the Higgsfield motion library) and an optional strength (0 to 1, controls motion intensity, default 1). Over 100 presets available including camera movements, environmental effects, and scene dynamics. |
| seed | integer | Yes | - | 1–1000000 | Random seed for reproducible results (1 to 1,000,000). Use a fixed value to get consistent output across runs with identical inputs. |
| enhance_prompt | boolean | No | false | - | Auto-enhance your prompt into a richer, more detailed description. true: expands short prompts with cinematic detail for better video quality. false: uses your exact prompt as written (default). Recommended for short or simple prompts. |
| end_input_images | array | No | - | - | Optional end frame image URLs for guided transitions. When provided, the generated video transitions from the input image toward these end frame images, giving precise control over the final frame appearance. |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "higgsfield-ai-visual-effects",
  "input": {
    "image_url": "https://cdn-us.eachlabs.ai/defaults/896f6809f65d39e96e979dcce8f470804a1ef7734a4b868a22cbfd32c3f51ef7.jpeg",
    "model": "dop-turbo",
    "motions": [
      {
        "id": "0c5d9955-706e-4b21-b499-39f1b5e5ea0e",
        "strength": 1
      }
    ],
    "prompt": "camera zoom in to her eye fast",
    "seed": 500
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "string (URL of generated video)",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "Authorization: Bearer YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `Authorization` bearer token |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**higgsfield-ai-visual-effects — Image-to-Video AI Model**

Transform static images into professional cinematic videos with **higgsfield-ai-visual-effects**, the Higgsfield image-to-video model that excels in AI-crafted camera controls for dynamic motion. Developed by Higgsfield as part of the higgsfield family, this image-to-video AI model solves the challenge of adding realistic, filmmaker-grade movements like crash zooms, crane shots, and 360 orbits to any input image, delivering stunning visuals without complex editing software. Ideal for content creators seeking fast, high-quality video generation from images, it supports searches like "Higgsfield image-to-video" by providing precise control over cinematic effects that elevate YouTube thumbnails, ads, and film prototypes to cinema-level production.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `Authorization: Bearer YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.