Verify credentials for every configured account by minting a fresh JWT each.

Plan info, all credit balances, and the has_unlim flag.

Concurrent-slot tier (how many jobs can run at once: 4/8/12/16).

Credit cost table per model / resolution / mode — WITHOUT spending credits.

Reads GET /job-sets/costs. Use this before generating on credits (unlimited jobs cost 0). e.g. seedance_2_0 720p ~4.5 credits/second; an 8s clip ~36 credits. Check unlimited_status first — if a model is unlimited-active for you, it's free.

Which models are currently unlimited-active for the account.

Reads /workspaces/unlim-activations, /subscriptions/bundle/all-unlim/status, and /user (has_unlim). An empty activations list means no active unlimited right now — generation would then cost credits (see estimate_cost).

Snapshot of in-flight jobs across all accounts in the pool.

List generation models. Optionally filter by category: image / video / audio.

Canonical (width, height) in pixels for an aspect ratio + resolution (1k/2k/4k).

Generate a single image, unlimited, across the account pool.

model uses the API path form: v1 models use dashes (nano-banana-2, nano-banana-pro); v2 models use underscores + api_version="v2" (seedream_v5_pro, seedream_v5_lite, flux_2, gpt_image_2, soul_2, kling_omni_image). Unlimited-eligible on a typical plan: nano_banana_2, nano_banana_pro, gpt_image_2, seedream_v5_pro, seedream_v4_5, soul_2, seedream_v5_lite, flux_2, kling_omni_image. Local input_files are auto-uploaded. See list_models and account_info for what's unlimited on your plan.

Queue many prompts, running up to max_concurrent in parallel.

With wait=False (default) this fires all jobs and returns their ids — poll progress with queue_status / list_jobs. With wait=True it blocks until every job finishes.

Multi-shot storyboard with character/style continuity.

Uses Higgsfield's dedicated multi-shot endpoint (nano-banana-2-shots). Each entry in shots is one shot's prompt; an optional reference image is shared across every shot for continuity.

Generate ONE video via the v2 API, with automatic resolution fallback.

Defaults target viral 9:16 clips. Unlimited is capped per model (Seedance/Wan/Gemini render unlimited at 720p), so resolution_fallback walks 1080p -> 720p -> 480p when the server denies unlimited. To make MANY videos in parallel across your accounts, use generate_video_batch (one generate_video call = one account = sequential).

Unlimited-eligible: seedance_2_0, seedance_2_0_mini, wan2_7, gemini_omni, kling3_0. Local input_files are uploaded as the start_image (image-to-video).

Generate MANY videos in PARALLEL, spread across all accounts in the pool.

This is how you use multiple accounts at once: N prompts fan out concurrently and the pool routes each to the least-busy account (with 429 failover). With wait=True (default) it returns when all are done; wait=False fires them and returns job ids to poll with queue_status. For image-to-video per prompt, pass input_files_per_prompt=[["a.jpg"], ["b.jpg"], ...] aligned to prompts.

List TTS preset voices (id, name, gender, preview mp3) for generate_audio.

Reads GET /reference-elements/voices. Pick a voice id and pass it to generate_audio as voice_id. Turkish voiceover: choose a voice and write the prompt in Turkish — ElevenLabs is multilingual.

Text-to-speech (unlimited) via the v2 text2speech_v2 model.

Verified contract: params {prompt, model:"elevenlabs", voice_id, voice_type:"preset"}. Get a voice_id from list_voices. Works with Turkish (and other languages) text.

Escape hatch: call any model with a custom params dict, across the account pool.

Use for face-swap, character-swap, upscale, inpaint, or any model whose exact schema you already know (see docs/MODEL_SCHEMAS.md). params is passed through verbatim (with use_unlim added). api_version selects the endpoint: v1 (/jobs/{model}) or v2 (/jobs/v2/{model}, newer models incl. most video). Local input_files are uploaded and merged into params['input_images'].

Poll a single job across the account pool (local registry, then remote API).

Block until a job finishes; optionally download its results.

Cancel an in-progress job (DELETE /jobs/{id}).

List all jobs across every account in the pool (this session).

Re-fetch a completed job's results and save them to disk.

Server-side recent generation history (your account's /jobs/accessible).

List all your workspaces.

Active workspace info (id, name, type, role).

Workspace credit balance.

Members of the active workspace.

Credit-usage chart for the active workspace.

Paginated media library (images + videos). Optional kind filter: image/video.

Upload a local image/video for use as input on subsequent generations.

Check status of media items by id.

Bulk-download media by id. Resolves each id to a URL and saves it to disk.

List your assets.

List your favourited assets.

Add an asset to your favourites.

Remove an asset from your favourites.