HIGGSFIELD × X402

Higgsfield video.
Pay per request.

Access Seedance 2.5 text-to-video through an API built for developers and agents. Live Higgsfield upstream pricing plus a fixed 10% service markup, rounded up to micro-USDC. No subscription.

x402 v2 · USDC Base in production · Base Sepolia for development

THE REQUEST PATH

From prompt to paid request.

  1. 01
    Estimate

    The request is validated and an upstream estimate is cached for 60 seconds.

  2. 02
    Challenge

    An x402 v2 402 response specifies the calculated exact-payment USDC amount.

  3. 03
    Settle

    Your wallet signs the payment authorization; the facilitator settles it on Base before any upstream work starts.

  4. 04
    Submit

    The job goes to Higgsfield once per Idempotency-Key. A rejected submission is recorded for refund review.

PRICE FORMULA

Upstream cost
× 1.10

No subscription. Each live quote includes a fixed 10% service markup. See the rounding policy.

NETWORK

Base
USDC

Test USDC on Base Sepolia locally; Base mainnet USDC in production.

AGENT X402 API

A standard 402 retry, no proprietary checkout.

cURL
curl -X POST https://prompt402.com/api/v1/generations \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: generate-$(uuidgen)" \
  -d '{"operation":"bytedance/seedance-2.5/text-to-video","prompt":"Slow dolly through a sunlit greenhouse"}'

# The first response is 402 with exact live USDC requirements.
# Sign and retry with an x402 client; then poll the returned URL.
TypeScript
import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";

const client = new x402Client();
// signer must implement ClientEvmSigner: address + signTypedData.
registerExactEvmScheme(client, { signer });
const paidFetch = wrapFetchWithPayment(fetch, client);

const response = await paidFetch("https://prompt402.com/api/v1/generations", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({ operation: "bytedance/seedance-2.5/text-to-video", prompt: "Sea fog rolls past a lighthouse" }),
});

Full request contract and response guide

Supply a wallet adapter implementing x402’s ClientEvmSigner (address and signTypedData). Wallet custody stays on the payer side; Prompt402 never takes custody of a client wallet or signing key.

New models, clear boundaries.

Higgsfield lists Seedance 2.5 in its official video catalog. Prompt402 supports its text-to-video operation and the existing Seedance 2.0 text-to-video contract. Other Higgsfield models and media modes are not automatically available through this proxy.

Last verified: . Model information checked against official Higgsfield API sources.

Questions before your first request

What is Prompt402?

Prompt402 is an independent Higgsfield API proxy for developers and AI agents. It exposes an asynchronous video generation API with x402 v2 exact payments in USDC. Request a live quote, authorize payment with your wallet, submit a supported request, and poll its status. No Prompt402 subscription is required.

How much does Prompt402 cost?

Each request uses the live Higgsfield upstream estimate plus a fixed 10% service markup, rounded up to micro-USDC. There is no subscription or fixed model price list. The upstream estimate is first rounded up to micro-USD. Check the x402 payment challenge for the exact payable amount.

Can I use Seedance 2.5 through Prompt402?

The Prompt402 request contract supports Seedance 2.5 text-to-video: 4–30 seconds, 480p or 720p, optional generated audio, and MP4 or MOV output. Seedance 2.0 text-to-video remains supported. Image, reference, video-edit, and video-extend operations are available upstream but are not supported by this proxy.

Can an agent send any Higgsfield model slug?

No. Prompt402 validates an explicit model allowlist before payment. Only the text-to-video operations documented in its OpenAPI schema are accepted. Use the model-specific settings in the API reference; an upstream catalog listing does not automatically add a model or mode to Prompt402.

When is payment taken, and what if submission fails?

Payment settles before the request is submitted to Higgsfield. A rejected submission is recorded for refund review, not automatically refunded. Keep your Idempotency-Key: replaying a completed submission returns the original job without a new charge. Avoid submitting a new paid request to recover an uncertain outcome.