# HiggsField API (Seedance 2.5) (`mrbuslov/higgsfield-apify-proxy`) Actor

Generate HiggsField (ByteDance) Seedance 2.5 videos from Apify, n8n, Make or your own code, paid with the Higgsfield subscription you already have. Text to video, image, audio and video references, video edit and video extension, 480p to 1080p, 4 to 30 seconds.

- **URL**: https://apify.com/mrbuslov/higgsfield-apify-proxy.md
- **Developed by:** [Dmitry Buslov](https://apify.com/mrbuslov) (community)
- **Categories:** AI, Videos, Automation
- **Stats:** 2 total users, 1 monthly users, 16.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$4.00 / 1,000 higgsfield credit useds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Seedance 2.5 Video Generator (your Higgsfield account)

Make ByteDance **Seedance 2.5** videos from Apify, paid with the **Higgsfield subscription you already have**.

Higgsfield does not sell API access to Seedance 2.5. This Actor works through a sign-in to your own Higgsfield account, so your videos are made with your Higgsfield credits and you can use them in schedules, integrations and other Actors.

### What you can make

| Mode | You give | You get |
|---|---|---|
| Text to video | a prompt | a video |
| With references | a prompt + start/end image, reference images, videos or audio | a video that follows them |
| Edit a video | a prompt + one video | the edited video |
| Extend a video | a prompt + a video + forward/backward | a longer video |

- Resolution 480p, 720p or 1080p, with sound or without it.
- Length from 4 to 30 seconds.
- Aspect ratio 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 or auto.

### Start in three steps

1. **Connect once.** Run the Actor with **What to do → Connect my Higgsfield account**. The log shows a link to a short page that walks you through it with pictures. It takes about three minutes.
2. **Generate.** Run the Actor with a prompt, plus files if you want them.
3. **Get the video.** The dataset has a permanent video link. Tick *Also save the video file* to get a copy in the run's storage too.

You need a Higgsfield plan that includes Seedance 2.5. The free plan does not.

### Price

You pay two separate things:

- **Higgsfield credits**, charged on your Higgsfield account as usual. Seedance 2.5 costs 3 credits per second at 480p, 6.5 at 720p and 9 at 1080p.
- **This Actor's fee: $4 per 1,000 credits the video used.** It is charged only when the video is delivered, and rounded up to a whole credit. Failed or timed-out videos cost you nothing here.

Total per second of 720p video, fee included, compared with the fal.ai price of $0.473:

| Your Higgsfield plan | Total per second |
|---|---|
| Ultra, yearly | about $0.22 |
| Ultra, monthly | about $0.30 |
| Plus, yearly | about $0.28 |
| Plus, monthly | about $0.35 |
| Starter | about $0.51, more than fal.ai |

The plan prices are Higgsfield's public list prices from September 2026. Your price per credit may differ.

### Other things you can do

- **Show account and credits** shows your plan and balance.
- **Disconnect my Higgsfield account** deletes your sign-in on our side and cancels it at Higgsfield.

### Before you connect: the risks

- This is **not an official Higgsfield product**.
- Higgsfield may change or block this way of access at any time, and your account could be affected. **You use it at your own risk.**
- We store your Higgsfield sign-in **encrypted** and use it only for the actions you start from this Actor.
- Finished videos are stored by Higgsfield at **public links**: anyone who has the link can open the video.

### Output

Each run adds one row to the dataset:

```json
{
  "kind": "generation",
  "status": "succeeded",
  "video_url": "https://....cloudfront.net/.../hf_..._<job>.mp4",
  "thumbnail_url": "https://cdn.higgsfield.ai/..._thumbnail.webp",
  "stored_video_key": "video-<id>",
  "credits": 26,
  "charged_usd": 0.104
}
```

When something goes wrong, the row has `status: "error"` or `status: "failed"`, an `error_code`, and a message that tells you what to do. Full list: https://higgsfield-apify-proxy.webdaddy.agency/docs

### Help

Write to hi@webdaddy.agency and a person will answer.

Made by [WebDaddy Agency](https://webdaddy.agency). Not affiliated with Higgsfield, ByteDance or Apify.

# Actor input Schema

## `action` (type: `string`):

Start with <b>Connect my Higgsfield account</b> once. The run log then shows a link to a short step-by-step page.

## `prompt` (type: `string`):

What should happen in the video.

## `mode` (type: `string`):

Text to video takes a prompt only. Reference mode needs at least one file below. Video edit needs exactly one video. Video extension needs a video and a direction.

## `resolution` (type: `string`):

Higgsfield credits per second: 480p = 3, 720p = 6.5, 1080p = 9.

## `aspect_ratio` (type: `string`):

Shape of the video. 16:9 is landscape, 9:16 is vertical for phones.

## `duration` (type: `integer`):

Whole seconds, 4 to 30.

## `generate_audio` (type: `boolean`):

Let Seedance add sound and speech to the video.

## `bitrate_mode` (type: `string`):

'high' gives a larger, sharper file at the same credit price.

## `extension_mode` (type: `string`):

Only for 'Extend a video'.

## `start_image_url` (type: `string`):

Reference mode only. Public link to a PNG, JPG or WEBP.

## `end_image_url` (type: `string`):

Reference mode only.

## `image_reference_urls` (type: `array`):

Public links. Up to 30 images in total, start and end image included.

## `video_reference_urls` (type: `array`):

Public links to MP4, MOV or WEBM.

## `audio_reference_urls` (type: `array`):

Public links to MP3, WAV, M4A, AAC or OGG.

## `save_video_to_storage` (type: `boolean`):

The Higgsfield link is permanent, but a copy in Apify storage is handy for downstream Actors.

## `max_wait_minutes` (type: `integer`):

A video usually takes 3 to 9 minutes.

## Actor input object example

```json
{
  "action": "generate",
  "prompt": "Slow drone shot over a mountain valley at sunrise, mist between the trees",
  "mode": "t2v",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "bitrate_mode": "standard",
  "save_video_to_storage": false,
  "max_wait_minutes": 45
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `files` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "prompt": "Slow drone shot over a mountain valley at sunrise, mist between the trees"
};

// Run the Actor and wait for it to finish
const run = await client.actor("mrbuslov/higgsfield-apify-proxy").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "prompt": "Slow drone shot over a mountain valley at sunrise, mist between the trees" }

# Run the Actor and wait for it to finish
run = client.actor("mrbuslov/higgsfield-apify-proxy").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "prompt": "Slow drone shot over a mountain valley at sunrise, mist between the trees"
}' |
apify call mrbuslov/higgsfield-apify-proxy --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,mrbuslov/higgsfield-apify-proxy"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/VA3aRBbysrOwLkyfI/builds/C3lsvMwpGkebAL9gP/openapi.json