feat(higgsfield): add Higgsfield integration

apps/docs/components/icons.tsx

@@ -113,6 +113,19 @@ export function GaugeIcon(props: GaugeIconProps) {
   )
 }
 
+interface HiggsfieldIconProps extends SVGProps<SVGSVGElement> {}
+
+export function HiggsfieldIcon(props: HiggsfieldIconProps) {
+  return (
+    <svg {...props} viewBox='66 74 390 368' fill='none' xmlns='http://www.w3.org/2000/svg'>
+      <path
+        d='M419.055 253.911L418.753 250.505C415.893 217.823 395.28 156.334 338.099 156.334C295.668 156.334 263.614 199.548 235.326 237.647C212.754 268.158 193.196 294.333 171.676 294.333C165.956 293.715 158.585 290.771 154.073 284.112C150.009 278.069 148.957 270.326 151.062 261.032C154.37 246.318 173.332 232.688 193.343 218.129C204.325 210.386 215.613 202.176 223.438 194.278C246.011 171.82 257.446 155.557 257.446 129.383C257.446 103.21 243.453 90.196 231.716 84.62C208.242 73.471 173.785 79.976 151.817 99.494C148.508 102.593 145.195 105.532 142.185 108.32C120.065 128.611 105.17 142.397 71.012 131.861V174.298C116.304 194.899 154.375 155.557 168.821 137.437C179.954 125.512 191.691 118.541 200.421 118.541H200.874C204.787 118.696 208.095 120.246 210.506 123.034C214.419 127.683 215.924 133.104 215.169 139.142C213.513 151.845 200.723 166.71 177.249 182.974C149.712 202.025 103.669 233.931 100.055 274.046C97.346 302.857 111.792 331.664 134.364 342.813C187.028 368.523 219.082 324.227 253.085 277.452C279.117 241.364 303.795 207.136 338.103 207.136C368.949 207.136 380.385 233.465 380.385 250.039V253.294L377.375 253.911C302.591 267.542 261.812 339.718 261.812 373.016C261.812 406.317 289.198 434.817 322.903 434.817C362.328 434.817 411.079 400.122 418.905 302.546L419.207 298.986H450.354V253.915L419.055 253.911ZM378.276 303.936C372.259 362.326 343.215 389.588 325.611 389.588C317.636 389.588 306.504 382.771 306.504 370.073C306.504 355.826 327.117 312.612 373.462 299.758L378.879 298.364L378.276 303.936Z'
+        fill='currentColor'
+      />
+    </svg>
+  )
+}
+
 export function EnrichmentIcon(props: SVGProps<SVGSVGElement>) {
   return (
     <svg

apps/docs/components/ui/icon-mapping.ts

@@ -141,6 +141,7 @@ import {
   HarmonicIcon,
   HelpScoutIcon,
   HexIcon,
+  HiggsfieldIcon,
   HubspotIcon,
   HuggingFaceIcon,
   HumanInTheLoopIcon,
@@ -477,6 +478,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
   harmonic: HarmonicIcon,
   helpscout: HelpScoutIcon,
   hex: HexIcon,
+  higgsfield: HiggsfieldIcon,
   hubspot: HubspotIcon,
   huggingface: HuggingFaceIcon,
   human_in_the_loop: HumanInTheLoopIcon,

apps/docs/content/docs/integrations/higgsfield.mdx

@@ -0,0 +1,295 @@
+---
+title: Higgsfield
+description: Generate images and videos with Higgsfield models
+integration:
+  type: "higgsfield"
+  color: "#D1FE17"
+---
+
+import { ReferenceDetails } from "@/components/ui/reference-details"
+
+
+{/* MANUAL-CONTENT-START:intro */}
+[Higgsfield](https://higgsfield.ai) is an image and video generation platform with its own SOUL image models and hosted models from other providers, such as Kling, Seedance, Wan, and MiniMax.
+
+With the Higgsfield block, you can:
+
+- **Generate media with any model**: Send a model endpoint ID and that model's documented JSON input, then get back image, video, or audio URLs.
+- **Generate SOUL images**: Set aspect ratio, resolution, style, and a trained character without writing JSON.
+- **Train characters**: Create, check, list, and delete Soul ID characters from reference photo URLs to keep a person or mascot consistent across images.
+- **Manage requests**: Check the status of a request, cancel one that is still queued, or delete a finished request's data.
+
+Create an API key in the [Higgsfield Console](https://console.higgsfield.ai), then connect it as a saved Higgsfield account in Sim. Paste the key ID and secret joined by a colon: `KEY_ID:KEY_SECRET`.
+
+Generation runs in the background. By default the block waits for the result. Turn off **Wait for Result** to return the request ID right away, then use **Get Request Status** later. Output URLs expire after seven days by default, so copy media you need to keep. Which models you can use depends on your Higgsfield account; find endpoint IDs and their input fields in the [model catalog](https://docs.higgsfield.ai/docs/models).
+
+In Sim, the Higgsfield block lets your agents produce product videos, ad creatives, and on-brand character images from a brief or a table of products.
+{/* MANUAL-CONTENT-END */}
+
+## Use the block [#usage-instructions]
+
+Generate images and videos with any Higgsfield model, create SOUL images with styles and trained characters, train and manage Soul ID characters, and check, cancel, or delete generation requests.
+
+## Actions
+
+### Higgsfield Generate
+
+Submit a generation request to any Higgsfield image or video model endpoint with that model's documented JSON input, then wait for the output URLs.
+
+<ReferenceDetails>
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `model` | string | Yes | Model endpoint ID from the Higgsfield model catalog, e.g. kling-video/v2.5-turbo/pro/text-to-video |
+| `input` | json | Yes | JSON request body documented for the model endpoint, e.g. \{"prompt": "...", "duration": 5\} |
+| `waitForCompletion` | boolean | No | Wait until the request finishes and return its output URLs. When false, return the request ID immediately. |
+| `webhookUrl` | string | No | HTTPS endpoint that Higgsfield notifies when the request finishes |
+| `idempotencyKey` | string | No | Key that makes retries return the original request instead of creating a duplicate \(1–255 visible ASCII characters\) |
+| `expiresAfter` | number | No | Seconds to keep the request data after it finishes, from 3600 up to the account retention |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `requestId` | string | Higgsfield request ID |
+| `status` | string | Request status: queued, in_progress, completed, failed, nsfw, or canceled |
+| `error` | string | Failure reason, when provided |
+| `imageUrls` | array | Generated image URLs \(image models\) |
+| `videoUrl` | string | Generated video URL \(video models\) |
+| `audioUrl` | string | Generated audio URL \(audio output\) |
+| `audioUrls` | array | Generated audio URLs \(audio output\) |
+| `statusUrl` | string | URL for checking the request status |
+| `cancelUrl` | string | URL for canceling the queued request |
+| `expiresAt` | string | When the output files are deleted and their URLs stop working |
+
+</ReferenceDetails>
+
+### Higgsfield Generate SOUL Image
+
+Generate images with Higgsfield SOUL, optionally in a style or as a trained Soul ID character, then wait for the image URLs.
+
+<ReferenceDetails>
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `prompt` | string | Yes | Text description of the image |
+| `aspectRatio` | string | No | Aspect ratio: 9:16, 16:9, 4:3, 3:4, 1:1, 2:3, or 3:2 \(default 4:3\) |
+| `resolution` | string | No | Resolution: 720p or 1080p \(default 720p\) |
+| `batchSize` | number | No | Number of images: 1 or 4 \(default 1\) |
+| `styleId` | string | No | SOUL style UUID \(defaults to the general style\) |
+| `styleStrength` | number | No | Style strength from 0 to 1 \(default 1\) |
+| `characterId` | string | No | Completed Soul ID character reference ID \(model version v1\) owned by the account |
+| `characterStrength` | number | No | Character strength from 0 to 1; 0 uses the style's default \(default 1\) |
+| `imageReferenceUrl` | string | No | Public image URL that guides prompt enhancement |
+| `enhancePrompt` | boolean | No | Let Higgsfield enhance the prompt \(default false\) |
+| `seed` | number | No | Seed from 1 to 1000000 for repeatable results |
+| `waitForCompletion` | boolean | No | Wait until the request finishes and return its output URLs. When false, return the request ID immediately. |
+| `webhookUrl` | string | No | HTTPS endpoint that Higgsfield notifies when the request finishes |
+| `idempotencyKey` | string | No | Key that makes retries return the original request instead of creating a duplicate \(1–255 visible ASCII characters\) |
+| `expiresAfter` | number | No | Seconds to keep the request data after it finishes, from 3600 up to the account retention |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `requestId` | string | Higgsfield request ID |
+| `status` | string | Request status: queued, in_progress, completed, failed, nsfw, or canceled |
+| `error` | string | Failure reason, when provided |
+| `imageUrls` | array | Generated image URLs \(image models\) |
+| `videoUrl` | string | Generated video URL \(video models\) |
+| `audioUrl` | string | Generated audio URL \(audio output\) |
+| `audioUrls` | array | Generated audio URLs \(audio output\) |
+| `statusUrl` | string | URL for checking the request status |
+| `cancelUrl` | string | URL for canceling the queued request |
+| `expiresAt` | string | When the output files are deleted and their URLs stop working |
+
+</ReferenceDetails>
+
+### Higgsfield Get Request Status
+
+Get the status of a Higgsfield generation request and, once completed, its output URLs.
+
+<ReferenceDetails>
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `requestId` | string | Yes | Higgsfield request ID returned by a generation request |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `requestId` | string | Higgsfield request ID |
+| `status` | string | Request status: queued, in_progress, completed, failed, nsfw, or canceled |
+| `error` | string | Failure reason, when provided |
+| `imageUrls` | array | Generated image URLs \(image models\) |
+| `videoUrl` | string | Generated video URL \(video models\) |
+| `audioUrl` | string | Generated audio URL \(audio output\) |
+| `audioUrls` | array | Generated audio URLs \(audio output\) |
+| `statusUrl` | string | URL for checking the request status |
+| `cancelUrl` | string | URL for canceling the queued request |
+| `expiresAt` | string | When the output files are deleted and their URLs stop working |
+
+</ReferenceDetails>
+
+### Higgsfield Cancel Request
+
+Cancel a Higgsfield generation request that is still queued. Requests that have started processing cannot be canceled.
+
+<ReferenceDetails>
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `requestId` | string | Yes | Higgsfield request ID to cancel |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `requestId` | string | ID of the canceled request |
+| `canceled` | boolean | Whether the request was canceled |
+
+</ReferenceDetails>
+
+### Higgsfield Delete Request
+
+Immediately delete a finished Higgsfield request's output files, prompt, and parameters.
+
+<ReferenceDetails>
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `requestId` | string | Yes | ID of a finished Higgsfield request |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `requestId` | string | ID of the deleted request |
+| `deleted` | boolean | Whether the request data was deleted |
+
+</ReferenceDetails>
+
+### Higgsfield Create Character
+
+Train a reusable Soul ID character from public reference image URLs. Training runs in the background; use Get Character to check when it completes.
+
+<ReferenceDetails>
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `name` | string | Yes | Character name \(up to 100 characters\) |
+| `modelVersion` | string | No | SOUL family that will use the character: v1, v2, or cinema \(default v1\) |
+| `imageUrls` | array | Yes | 1 to 100 public URLs of reference photos of the character |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `character` | json | Created character reference |
+|   ↳ `id` | string | Character \(Soul ID\) reference ID |
+|   ↳ `name` | string | Character name |
+|   ↳ `modelVersion` | string | SOUL family: v1, v2, or cinema |
+|   ↳ `status` | string | Training status: not_ready, queued, in_progress, completed, or failed |
+|   ↳ `thumbnailUrl` | string | Thumbnail image URL |
+|   ↳ `createdAt` | string | Creation timestamp |
+|   ↳ `inProgressAt` | string | Training start timestamp |
+|   ↳ `failReason` | string | Training failure reason |
+
+</ReferenceDetails>
+
+### Higgsfield Get Character
+
+Get a Soul ID character reference, including its training status.
+
+<ReferenceDetails>
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `characterId` | string | Yes | Soul ID character reference ID |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `character` | json | Character reference |
+|   ↳ `id` | string | Character \(Soul ID\) reference ID |
+|   ↳ `name` | string | Character name |
+|   ↳ `modelVersion` | string | SOUL family: v1, v2, or cinema |
+|   ↳ `status` | string | Training status: not_ready, queued, in_progress, completed, or failed |
+|   ↳ `thumbnailUrl` | string | Thumbnail image URL |
+|   ↳ `createdAt` | string | Creation timestamp |
+|   ↳ `inProgressAt` | string | Training start timestamp |
+|   ↳ `failReason` | string | Training failure reason |
+
+</ReferenceDetails>
+
+### Higgsfield List Characters
+
+List the Soul ID character references in the Higgsfield account, one page at a time.
+
+<ReferenceDetails>
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `page` | number | No | Page number, starting at 1 \(default 1\) |
+| `pageSize` | number | No | Characters per page \(default 20\) |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `characters` | array | Character references on this page |
+|   ↳ `id` | string | Character \(Soul ID\) reference ID |
+|   ↳ `name` | string | Character name |
+|   ↳ `modelVersion` | string | SOUL family: v1, v2, or cinema |
+|   ↳ `status` | string | Training status: not_ready, queued, in_progress, completed, or failed |
+|   ↳ `thumbnailUrl` | string | Thumbnail image URL |
+|   ↳ `createdAt` | string | Creation timestamp |
+|   ↳ `inProgressAt` | string | Training start timestamp |
+|   ↳ `failReason` | string | Training failure reason |
+| `total` | number | Total number of characters |
+| `page` | number | Current page number |
+| `pageSize` | number | Characters per page |
+| `totalPages` | number | Total number of pages |
+
+</ReferenceDetails>
+
+### Higgsfield Delete Character
+
+Permanently delete a Soul ID character reference.
+
+<ReferenceDetails>
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `characterId` | string | Yes | Soul ID character reference ID to delete |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `characterId` | string | ID of the deleted character |
+| `deleted` | boolean | Whether the character was deleted |
+
+</ReferenceDetails>
+
+

apps/docs/content/docs/integrations/meta.json

@@ -123,6 +123,7 @@
     "harmonic",
     "helpscout",
     "hex",
+    "higgsfield",
     "hubspot",
     "hubspot-service-account",
     "hubspot-setup",