Cinema Studio 4.0 — API reference

import { config, higgsfield } from "@higgsfield/client/v2";config({ credentials: process.env.HF_CREDENTIALS,});const result = await higgsfield.subscribe( "higgsfield/cinema-studio/4.0", { input: { "prompt": "A knight in silver armor and a blue tunic stabs a horned monster in the leg. The monster kicks him away and chases him downhill. It knocks him into a deep pit, then swings its fist down into it.", "duration": 5, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true }, withPolling: true, },);console.log(result);

1. Calling the API

Use the Higgsfield client to call Cinema Studio 4.0 from your application.

Install

Choose the installation method for your selected client. cURL does not require a client package.

npm install @higgsfield-ai/client

Setup

Create a client and submit input to the model endpoint.

import { HiggsfieldClient } from '@higgsfield-ai/client'

const client = new HiggsfieldClient({
  apiKey: process.env.HIGGSFIELD_API_KEY,
})

2. Authentication

API Key

Pass your API key through the client configuration or the authorization header.

Authorization: Bearer $HIGGSFIELD_API_KEY

Keep API keys on the server and never expose them in browser code.

3. Queue

Model requests run asynchronously. Submit a request, then fetch it until it reaches a terminal state.

Submit

const request = await client.submit('higgsfield/cinema-studio/4.0', {
  prompt: 'A cinematic portrait in soft natural light',
})

Fetch

const result = await client.requests.get(request.id)