feat(higgsfield): add Higgsfield integration by myxamediyar · Pull Request #9749 · simstudioai/sim

myxamediyar · 2026-11-06T19:51:39Z

Summary

Adds a Higgsfield block for image and video generation and Soul ID character management.

Operations:

Generate SOUL Image: typed fields for prompt, aspect ratio, resolution, batch size, style, Soul ID character, seed, and prompt enhancement
Generate (Any Model): any Higgsfield model endpoint ID plus that model's JSON input, so the 84 catalog models work without per-model fields
Get Request Status / Cancel Request / Delete Request
Create / Get / List / Delete Character (Soul ID)

Generation is asynchronous. Both generate operations poll Get Request Status until the request finishes (bounded by the default execution timeout). A Wait for Result switch returns the request ID immediately for long video jobs. Webhook URL, idempotency key, and data retention are available in advanced mode.

Auth is a saved token service account. The user pastes KEY_ID:KEY_SECRET, which tools send as Authorization: Key …. The key is verified at connect time by listing one page of Soul ID characters, because Higgsfield has no identity endpoint.

Not included: the Soul style list (its response shape is undocumented, so style is an ID field), SOUL V2 and SOUL Cinema generation (endpoints not confirmed), and a webhook trigger.

Product update (if relevant)

Teams can generate product videos, ad creatives, and consistent character images from Higgsfield models inside a workflow or agent run. Requires a Higgsfield API key from console.higgsfield.ai. Output URLs expire after seven days by default.

Type of Change

New feature

Testing

bun run lint, bun run type-check (apps/sim), canvas sentence check, block registry check, check:docs, check:integration-catalog, check:deployment-config, and icon checks pass
Vitest: blocks, tools, credentials, oauth, and serializer suites (198 files, 2,136 tests) pass
Live API run with a real key, calling the tool code directly: credential validation (valid key accepted, bad key rejected with 401), SOUL image generation with polling to completion, generic generate without waiting, cancel of a queued request, status after cancel, delete of a finished request, list characters, and 404 on an unknown character
Not live-tested: Create Character (training uses credits) and video models. The block has not been exercised in the running app yet.
check:audits locally reports one check:unused-exports failure: an unresolved @/.content/registry import in apps/docs, caused by the generated docs folder missing in a fresh worktree

Reviewers: the polling loop in tools/higgsfield/utils.ts and the credential descriptor and validator.

Checklist

Code follows project style guidelines
Self-reviewed my changes
Tests added/updated and passing
No new warnings introduced
I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

🤖 Generated with Claude Code

vercel · 2026-11-06T19:51:44Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Nov 6, 2026 9:08pm UTC

cubic-dev-ai

All reported issues were addressed across 35 files

_{Reply with feedback, questions, or to request a fix.

Turn on auto-fix | Re-trigger cubic}

greptile-apps · 2026-11-06T20:16:21Z

Confidence Score: 5/5

[Medium impact] The PR appears safe to merge; no new actionable issues were found.

Summary

Adds Higgsfield image and video generation, request management, and Soul ID character tools.

Higgsfield workflows can generate media and manage generation requests.
Workflows can create and manage reusable Soul ID characters.
Users can connect Higgsfield with a saved service-account key.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[Workflow or agent] --> B[Resolve saved Higgsfield account]
  B --> C[Submit generation]
  C --> D{Wait for result?}
  D -->|No| E[Return request ID]
  D -->|Yes| F[Poll request status]
  F --> G{Finished?}
  G -->|No, within time limit| F
  G -->|Completed| H[Return media URLs]
  G -->|Failed or time limit reached| I[Return error and request details]

_{Reviews (6) · Last reviewed commit: "chore(higgsfield): regenerate integratio..." · Reviewed by Greptile}

myxamediyar · 2026-11-06T20:24:22Z

@greptile

myxamediyar · 2026-11-06T20:24:23Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-11-06T20:24:29Z

@cubic-dev-ai review this PR

@myxamediyar I have started the AI code review. It will take a few minutes to complete.

cubic-dev-ai

All reported issues were addressed across 35 files

_{Reply with feedback, questions, or to request a fix.

Turn on auto-fix | Re-trigger cubic}

myxamediyar · 2026-11-06T20:33:36Z

@greptile

myxamediyar · 2026-11-06T20:33:38Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-11-06T20:33:45Z

@cubic-dev-ai review this PR

@myxamediyar I have started the AI code review. It will take a few minutes to complete.

cubic-dev-ai

All reported issues were addressed across 35 files

_{Reply with feedback, questions, or to request a fix.

Turn on auto-fix | Re-trigger cubic}

myxamediyar · 2026-11-06T20:40:17Z

@greptile

myxamediyar · 2026-11-06T20:40:18Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-11-06T20:40:23Z

@cubic-dev-ai review this PR

@myxamediyar I have started the AI code review. It will take a few minutes to complete.

cubic-dev-ai

No issues found across 35 files

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

_{Turn on auto-fix | Re-trigger cubic}

myxamediyar · 2026-11-06T20:52:54Z

@greptile

myxamediyar · 2026-11-06T20:52:55Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-11-06T20:53:01Z

@cubic-dev-ai review this PR

@myxamediyar I have started the AI code review. It will take a few minutes to complete.

cubic-dev-ai

No issues found across 35 files

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

_{You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.

Turn on auto-fix | Re-trigger cubic}

Add a Higgsfield block for image and video generation: - Generate with any model endpoint, or a typed SOUL image operation - Get status, cancel, and delete generation requests - Create, get, list, and delete Soul ID characters Generation waits for completion by polling request status, with an option to return the request ID immediately. Credentials are a saved token service account (KEY_ID:KEY_SECRET), verified by listing the account's characters. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

- Split training image URLs on line breaks only so URLs containing commas stay intact - Limit the Soul ID skill to v1 characters, the version Generate SOUL Image accepts - Let the canvas noun name the object in Get and Delete Character sentences - Mark outputs that can be null as nullable Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Use parseOptionalNumberInput so whitespace-only values are treated as empty instead of 0, and enforce the documented integer and range limits. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

A hidden numeric field from another operation no longer blocks the selected one when its value is invalid. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Declare the List Characters output as an array, and reject a SOUL batch size other than 1 or 4 before submitting. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

myxamediyar · 2026-11-06T21:03:23Z

@greptile

myxamediyar · 2026-11-06T21:03:24Z

@cubic-dev-ai review this PR

cubic-dev-ai · 2026-11-06T21:03:31Z

@cubic-dev-ai review this PR

@myxamediyar I have started the AI code review. It will take a few minutes to complete.

cubic-dev-ai

No issues found across 35 files

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

_{You've manually re-run cubic several times on this PR. Each manual re-review checks the full PR again and counts toward your usage quota. To preserve your usage limits, we recommend letting cubic automatically review new commits.

Turn on auto-fix | Re-trigger cubic}

vercel Bot deployed to Preview November 6, 2026 19:57

View deployment

myxamediyar marked this pull request as ready for review November 6, 2026 20:11

cubic-dev-ai Bot reviewed Nov 6, 2026

View reviewed changes

greptile-apps Bot reviewed Nov 6, 2026

View reviewed changes

Comment thread apps/sim/tools/higgsfield/create_character.ts Resolved

Comment thread apps/sim/blocks/blocks/higgsfield.ts Resolved

vercel Bot temporarily deployed to Preview November 6, 2026 20:23 Inactive

cubic-dev-ai Bot reviewed Nov 6, 2026

View reviewed changes

Comment thread apps/sim/blocks/blocks/higgsfield.ts Resolved

myxamediyar force-pushed the feat/higgsfield-integration branch from f188111 to 977ff7e Compare November 6, 2026 20:33

greptile-apps Bot reviewed Nov 6, 2026

View reviewed changes

Comment thread apps/sim/blocks/blocks/higgsfield.ts Resolved

vercel Bot deployed to Preview November 6, 2026 20:38

View deployment

cubic-dev-ai Bot reviewed Nov 6, 2026

View reviewed changes

Comment thread apps/sim/blocks/blocks/higgsfield.ts Resolved

Comment thread apps/sim/blocks/blocks/higgsfield.ts Resolved

vercel Bot temporarily deployed to Preview November 6, 2026 20:40 Inactive

cubic-dev-ai Bot reviewed Nov 6, 2026

View reviewed changes

myxamediyar force-pushed the feat/higgsfield-integration branch from dafa790 to 77e9489 Compare November 6, 2026 20:52

cubic-dev-ai Bot reviewed Nov 6, 2026

View reviewed changes

myxamediyar and others added 2 commits November 6, 2026 12:58

myxamediyar and others added 4 commits November 6, 2026 12:58

fix(higgsfield): parse numeric block inputs with the shared parser

a42427a

Use parseOptionalNumberInput so whitespace-only values are treated as empty instead of 0, and enforce the documented integer and range limits. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

fix(higgsfield): parse numeric inputs only for the selected operation

0a854dd

A hidden numeric field from another operation no longer blocks the selected one when its value is invalid. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

fix(higgsfield): type character list output and limit SOUL batch size

f449bca

Declare the List Characters output as an array, and reject a SOUL batch size other than 1 or 4 before submitting. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

chore(higgsfield): regenerate integration metadata after rebase

6a6fd27

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

vercel Bot deployed to Preview November 6, 2026 20:58

View deployment

myxamediyar force-pushed the feat/higgsfield-integration branch from 77e9489 to 6a6fd27 Compare November 6, 2026 21:03

cubic-dev-ai Bot reviewed Nov 6, 2026

View reviewed changes

vercel Bot deployed to Preview November 6, 2026 21:08

View deployment

myxamediyar assigned waleedlatif1 Nov 6, 2026

Conversation

myxamediyar commented Nov 6, 2026

Summary

Product update (if relevant)

Type of Change

Testing

Checklist

Uh oh!

vercel Bot commented Nov 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

greptile-apps Bot commented Nov 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Confidence Score: 5/5

Summary

Diagram

Uh oh!

Uh oh!

Uh oh!

myxamediyar commented Nov 6, 2026

Uh oh!

myxamediyar commented Nov 6, 2026

Uh oh!

cubic-dev-ai Bot commented Nov 6, 2026

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

myxamediyar commented Nov 6, 2026

Uh oh!

myxamediyar commented Nov 6, 2026

Uh oh!

cubic-dev-ai Bot commented Nov 6, 2026

Uh oh!

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

myxamediyar commented Nov 6, 2026

Uh oh!

myxamediyar commented Nov 6, 2026

Uh oh!

cubic-dev-ai Bot commented Nov 6, 2026

Uh oh!

cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

myxamediyar commented Nov 6, 2026

Uh oh!

myxamediyar commented Nov 6, 2026

Uh oh!

cubic-dev-ai Bot commented Nov 6, 2026

Uh oh!

cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

myxamediyar commented Nov 6, 2026

Uh oh!

myxamediyar commented Nov 6, 2026

Uh oh!

cubic-dev-ai Bot commented Nov 6, 2026

Uh oh!

cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

This branch was successfully deployed

vercel Bot commented Nov 6, 2026 •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading

greptile-apps Bot commented Nov 6, 2026 •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading