@assemblyline-agents/higgsfield 2.0.0 → 3.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/README.md +11 -16
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/package.json +3 -4
- package/skills/higgsfield-generate/SKILL.md +0 -133
- package/skills/higgsfield-generate/references/media-inputs.md +0 -34
- package/skills/higgsfield-generate/references/workflows.md +0 -41
- package/skills/higgsfield-product-photoshoot/SKILL.md +0 -37
- package/skills/higgsfield-soul-id/SKILL.md +0 -37
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# @assemblyline-agents/higgsfield
|
|
2
2
|
|
|
3
3
|
Official Assembly Line connection plugin for Higgsfield's CLI-first coding-agent
|
|
4
|
-
workflow. Higgsfield remains a normal
|
|
4
|
+
workflow. Higgsfield remains a normal filesystem-declared connection; its
|
|
5
5
|
transport runs the official CLI inside the active agent sandbox rather than
|
|
6
6
|
launching a process on the Assembly Line gateway.
|
|
7
7
|
|
|
8
|
-
## Install and
|
|
8
|
+
## Install and configure
|
|
9
9
|
|
|
10
10
|
```sh
|
|
11
11
|
assembly-line add higgsfield agent
|
|
@@ -17,17 +17,18 @@ This creates `connections/higgsfield.ts`:
|
|
|
17
17
|
import { defineHiggsfieldConnection } from "@assemblyline-agents/higgsfield";
|
|
18
18
|
|
|
19
19
|
export default defineHiggsfieldConnection({
|
|
20
|
-
|
|
21
|
-
read: true,
|
|
22
|
-
write: false
|
|
23
|
-
}
|
|
20
|
+
// Reviewed tools are enabled by default.
|
|
24
21
|
});
|
|
25
22
|
```
|
|
26
23
|
|
|
27
|
-
|
|
24
|
+
Set `access: "approval-required"` when generation and editing should pause for
|
|
25
|
+
approval.
|
|
26
|
+
|
|
27
|
+
Use a read-only policy when the agent should inspect Higgsfield without
|
|
28
|
+
generating or editing:
|
|
28
29
|
|
|
29
30
|
```ts
|
|
30
|
-
|
|
31
|
+
export default defineHiggsfieldConnection({ access: "read-only" });
|
|
31
32
|
```
|
|
32
33
|
|
|
33
34
|
The connection exposes `higgsfield__read` for discovery, status, cost, history,
|
|
@@ -38,26 +39,22 @@ and consume account credits.
|
|
|
38
39
|
Assign it to a subagent with the same connection abstraction:
|
|
39
40
|
|
|
40
41
|
```ts
|
|
41
|
-
import { defineAgent,
|
|
42
|
+
import { defineAgent, useModel } from "@assemblyline-agents/core";
|
|
42
43
|
|
|
43
44
|
export default defineAgent({
|
|
44
45
|
description: "Create and edit social video.",
|
|
45
46
|
connections: ["higgsfield"],
|
|
46
47
|
setup() {
|
|
47
48
|
useModel("openai/gpt-5.4-mini");
|
|
48
|
-
useConnection("higgsfield");
|
|
49
49
|
}
|
|
50
50
|
});
|
|
51
51
|
```
|
|
52
52
|
|
|
53
|
-
`assembly-line add` also copies the bundled `higgsfield-generate`,
|
|
54
|
-
`higgsfield-soul-id`, and `higgsfield-product-photoshoot` skills.
|
|
55
|
-
|
|
56
53
|
## Why the transport is a sandbox CLI
|
|
57
54
|
|
|
58
55
|
The connection definition compiles as `protocol: "cli"` and
|
|
59
56
|
`transport: "sandbox"`. Tool discovery, subagent scoping, access policy,
|
|
60
|
-
approval, tracing, and
|
|
57
|
+
approval, tracing, and filesystem activation stay in the connection layer. At
|
|
61
58
|
execution time, Assembly Line invokes the reviewed command in the active run
|
|
62
59
|
sandbox, where it can consume `/files/...` attachments and write results to
|
|
63
60
|
`/workspace`.
|
|
@@ -93,6 +90,4 @@ commands.
|
|
|
93
90
|
Official references:
|
|
94
91
|
|
|
95
92
|
- https://higgsfield.ai/cli
|
|
96
|
-
- https://higgsfield.ai/skills
|
|
97
93
|
- https://github.com/higgsfield-ai/cli
|
|
98
|
-
- https://github.com/higgsfield-ai/skills
|
package/dist/index.d.ts
CHANGED
|
@@ -3,7 +3,7 @@ export interface HiggsfieldConnectionOptions {
|
|
|
3
3
|
/** Executable path only. Shell fragments and extra arguments are not accepted. */
|
|
4
4
|
command?: string;
|
|
5
5
|
description?: string;
|
|
6
|
-
access
|
|
6
|
+
access?: ConnectionPluginAccessSelection;
|
|
7
7
|
readTimeoutMs?: number;
|
|
8
8
|
writeTimeoutMs?: number;
|
|
9
9
|
maxOutputChars?: number;
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EAGrC,MAAM,2BAA2B,CAAC;AAgEnC,MAAM,WAAW,2BAA2B;IAC1C,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EAGrC,MAAM,2BAA2B,CAAC;AAgEnC,MAAM,WAAW,2BAA2B;IAC1C,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,+BAA+B,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,sEAuB9E;AAED,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -60,7 +60,7 @@ export function defineHiggsfieldConnection(options) {
|
|
|
60
60
|
return defineSandboxCliPluginConnection(PLUGIN, {
|
|
61
61
|
...(options.command ? { command: options.command } : {}),
|
|
62
62
|
...(options.description ? { description: options.description } : {}),
|
|
63
|
-
access: options.access,
|
|
63
|
+
...(options.access ? { access: options.access } : {}),
|
|
64
64
|
tools: [
|
|
65
65
|
higgsfieldTool("read", "Inspect Higgsfield models, workflows, jobs, media, account state, and generation cost.", validateReadCommand, options.readTimeoutMs ?? DEFAULT_READ_TIMEOUT_MS),
|
|
66
66
|
higgsfieldTool("write", "Create, upload, train, edit, reframe, or assemble media with Higgsfield.", validateWriteCommand, options.writeTimeoutMs ?? DEFAULT_WRITE_TIMEOUT_MS)
|
|
@@ -125,7 +125,7 @@ function validatedArguments(input) {
|
|
|
125
125
|
return argument;
|
|
126
126
|
});
|
|
127
127
|
if (args.includes("--json") || args.includes("--no-color")) {
|
|
128
|
-
throw new Error("
|
|
128
|
+
throw new Error("Assembly Line adds --json and --no-color automatically; omit them from args.");
|
|
129
129
|
}
|
|
130
130
|
return args;
|
|
131
131
|
}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,gCAAgC,EAKjC,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,GAAG,wBAAwB,CAAC,YAAY,CAAE,CAAC;AACvD,MAAM,uBAAuB,GAAG,EAAE,GAAG,MAAM,CAAC;AAC5C,MAAM,wBAAwB,GAAG,EAAE,GAAG,MAAM,CAAC;AAC7C,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,gBAAgB;IAChB,sBAAsB;IACtB,eAAe;IACf,cAAc;IACd,eAAe;IACf,eAAe;IACf,WAAW;IACX,YAAY;IACZ,aAAa;IACb,aAAa;IACb,cAAc;IACd,cAAc;IACd,aAAa;IACb,YAAY;IACZ,aAAa;IACb,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,YAAY;IACZ,eAAe;IACf,SAAS;IACT,YAAY;IACZ,OAAO;IACP,UAAU;IACV,UAAU;IACV,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,iBAAiB;IACjB,mBAAmB;IACnB,0BAA0B;IAC1B,gBAAgB;IAChB,2BAA2B;IAC3B,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,iBAAiB;CAClB,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,sBAAsB;IACtB,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;IAClB,iBAAiB;IACjB,gBAAgB;IAChB,oBAAoB;IACpB,mBAAmB;CACpB,CAAC,CAAC;AAmBH,MAAM,UAAU,0BAA0B,CAAC,OAAoC;IAC7E,OAAO,gCAAgC,CAAC,MAAM,EAAE;QAC9C,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,EAAE,OAAO,CAAC,MAAM;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@assemblyline-agents/higgsfield",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "3.1.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"exports": {
|
|
6
6
|
".": {
|
|
@@ -9,12 +9,11 @@
|
|
|
9
9
|
}
|
|
10
10
|
},
|
|
11
11
|
"dependencies": {
|
|
12
|
-
"@assemblyline-agents/core": "
|
|
12
|
+
"@assemblyline-agents/core": "3.1.0"
|
|
13
13
|
},
|
|
14
14
|
"description": "Official Assembly Line sandbox CLI connection and skills for Higgsfield creative media workflows.",
|
|
15
15
|
"files": [
|
|
16
|
-
"dist"
|
|
17
|
-
"skills"
|
|
16
|
+
"dist"
|
|
18
17
|
],
|
|
19
18
|
"engines": {
|
|
20
19
|
"node": ">=22.19.0"
|
|
@@ -1,133 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: higgsfield-generate
|
|
3
|
-
description: Generate, analyze, transform, or reframe images, video, 3D assets, and audio with the official Higgsfield CLI. Use for image or video generation, image-to-video, existing-video analysis, Draw to Edit, vertical reframing, Marketing Studio ads, 3D creation, or generated audio. Do not use for local cutting or stitching when FFmpeg or Remotion is the better tool.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Higgsfield Generate
|
|
7
|
-
|
|
8
|
-
Use the reviewed `higgsfield__read` and `higgsfield__write` connection tools. They run the
|
|
9
|
-
official `higgsfield` CLI inside the same sandbox that owns `/files` and
|
|
10
|
-
`/workspace`.
|
|
11
|
-
|
|
12
|
-
Pass CLI arguments as an array without the executable:
|
|
13
|
-
|
|
14
|
-
```json
|
|
15
|
-
{"args":["model","list"]}
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
Assembly Line adds `--json --no-color`. Never include either flag yourself. Never use
|
|
19
|
-
Higgsfield auth commands; if the CLI reports an expired or missing session, ask
|
|
20
|
-
the user to run `higgsfield auth login` interactively in their persistent
|
|
21
|
-
sandbox.
|
|
22
|
-
|
|
23
|
-
## Operating rules
|
|
24
|
-
|
|
25
|
-
1. Use `higgsfield__read` for discovery, account status, cost, job history, and
|
|
26
|
-
polling.
|
|
27
|
-
2. Use `higgsfield__write` for uploads, generation, workflows, and training.
|
|
28
|
-
These calls require approval because they create remote state or
|
|
29
|
-
consume credits.
|
|
30
|
-
3. Pass `/files/...` or `/workspace/...` media paths directly. The CLI
|
|
31
|
-
auto-uploads supported local files; do not pre-upload unless a later step
|
|
32
|
-
needs a reusable upload ID.
|
|
33
|
-
4. Prefer `--wait` for generation so one call returns the completed job. Use
|
|
34
|
-
`--wait-timeout 20m` when a longer job needs it.
|
|
35
|
-
5. Return result URLs and a concise summary. Do not dump raw job IDs or large
|
|
36
|
-
JSON unless the user asks.
|
|
37
|
-
6. Do not silently replace video understanding with random or sparse frame
|
|
38
|
-
sampling. Use Virality Predictor for supported creative analysis, or state
|
|
39
|
-
the limitation.
|
|
40
|
-
|
|
41
|
-
## Discover before generating
|
|
42
|
-
|
|
43
|
-
Start with the full catalog when the exact model or feature is uncertain:
|
|
44
|
-
|
|
45
|
-
```json
|
|
46
|
-
{"args":["model","list"]}
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
Then inspect the chosen model:
|
|
50
|
-
|
|
51
|
-
```json
|
|
52
|
-
{"args":["model","get","seedance_2_0"]}
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
Workflows are separate:
|
|
56
|
-
|
|
57
|
-
```json
|
|
58
|
-
{"args":["workflow","list"]}
|
|
59
|
-
{"args":["workflow","get","reframe"]}
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
Do not conclude that a feature is unavailable from a filtered or semantic
|
|
63
|
-
search alone. Check the unfiltered model or workflow list.
|
|
64
|
-
|
|
65
|
-
## Current quality defaults
|
|
66
|
-
|
|
67
|
-
- General images, graphic design, typography, and on-image text: GPT Image 2.
|
|
68
|
-
- Serious video, multi-shot motion, image-to-video, and video references:
|
|
69
|
-
Seedance 2.0.
|
|
70
|
-
- Character, cartoon, stylized, or reference-driven images: Nano Banana 2;
|
|
71
|
-
Lite for speed, Pro for harder briefs.
|
|
72
|
-
- Ads, UGC, product demos, unboxing, presenters, and brand workflows:
|
|
73
|
-
Marketing Studio.
|
|
74
|
-
- Text-to-audio, sound effects, ambience, foley, and music-like audio:
|
|
75
|
-
Seed Audio 1.0.
|
|
76
|
-
|
|
77
|
-
Resolve the current CLI ID with `model list`; model availability changes.
|
|
78
|
-
|
|
79
|
-
## Generation
|
|
80
|
-
|
|
81
|
-
Examples below are `args` for `higgsfield__write`:
|
|
82
|
-
|
|
83
|
-
```json
|
|
84
|
-
{"args":["generate","create","gpt_image_2","--prompt","neon city at dusk","--aspect_ratio","16:9","--resolution","2k","--wait"]}
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
```json
|
|
88
|
-
{"args":["generate","create","seedance_2_0","--prompt","camera dollies in","--start-image","/files/first.png","--duration","12","--resolution","4k","--wait"]}
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
```json
|
|
92
|
-
{"args":["generate","create","seed_audio","--prompt","cinematic rain ambience with distant thunder","--wait"]}
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
For a prior job, use `higgsfield__read`:
|
|
96
|
-
|
|
97
|
-
```json
|
|
98
|
-
{"args":["generate","get","<job_id>"]}
|
|
99
|
-
{"args":["generate","wait","<job_id>"]}
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
## Existing video
|
|
103
|
-
|
|
104
|
-
Read [references/workflows.md](references/workflows.md) before editing or
|
|
105
|
-
reframing an existing video. Read
|
|
106
|
-
[references/media-inputs.md](references/media-inputs.md) before passing video,
|
|
107
|
-
image, or audio references.
|
|
108
|
-
|
|
109
|
-
Higgsfield currently provides:
|
|
110
|
-
|
|
111
|
-
- `draw_to_video` for editing a source video from an edited/sketched frame at a
|
|
112
|
-
timestamp.
|
|
113
|
-
- `reframe` for converting a source video to a new aspect ratio.
|
|
114
|
-
- `brain_activity`, customer-facing name Virality Predictor, for finished-video
|
|
115
|
-
hook, attention, retention, and virality analysis.
|
|
116
|
-
|
|
117
|
-
Higgsfield is not a general timeline editor. Use sandbox FFmpeg or Remotion for
|
|
118
|
-
precise cuts, concatenation, audio replacement, captions, or deterministic
|
|
119
|
-
stitching; use Higgsfield for generative transformations and supported
|
|
120
|
-
server-side assembly.
|
|
121
|
-
|
|
122
|
-
## Errors
|
|
123
|
-
|
|
124
|
-
- `Session expired` or `Not authenticated`: ask the user to authenticate the
|
|
125
|
-
same persistent, user-scoped sandbox.
|
|
126
|
-
- `Missing required params`: ask only for the missing user input.
|
|
127
|
-
- `Unknown params`: inspect the live model or workflow schema.
|
|
128
|
-
- Timeout: rejoin the existing job with `generate wait`; do not submit a
|
|
129
|
-
duplicate.
|
|
130
|
-
|
|
131
|
-
Source contract: Higgsfield's official CLI and skills documentation at
|
|
132
|
-
https://github.com/higgsfield-ai/cli and
|
|
133
|
-
https://github.com/higgsfield-ai/skills.
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
# Higgsfield Media Inputs
|
|
2
|
-
|
|
3
|
-
Pass local sandbox paths or existing Higgsfield UUIDs directly. The CLI
|
|
4
|
-
auto-uploads local paths and detects upload IDs versus completed job IDs.
|
|
5
|
-
|
|
6
|
-
Supported local extensions include:
|
|
7
|
-
|
|
8
|
-
- Images: PNG, JPEG, WebP, GIF
|
|
9
|
-
- Video: MP4, MOV, WebM
|
|
10
|
-
- Audio: MP3, WAV, M4A, OGG
|
|
11
|
-
|
|
12
|
-
Common flags:
|
|
13
|
-
|
|
14
|
-
- `--image`: image reference
|
|
15
|
-
- `--start-image`: first-frame reference
|
|
16
|
-
- `--end-image`: last-frame reference
|
|
17
|
-
- `--video`: video reference or analyzed video
|
|
18
|
-
- `--audio`: audio reference
|
|
19
|
-
- `--image-references`, `--video-references`, `--audio-references`: repeated
|
|
20
|
-
reference-array inputs when exposed by the model schema
|
|
21
|
-
|
|
22
|
-
Inspect `model get <model_id>` before assuming a media role. Important current
|
|
23
|
-
contracts:
|
|
24
|
-
|
|
25
|
-
- `seedance_2_0` accepts image, start image, end image, video, and audio.
|
|
26
|
-
- `brain_activity` accepts exactly one video and returns a text analysis report.
|
|
27
|
-
- `grok_video_v15` requires one start image.
|
|
28
|
-
- `gemini_omni` accepts up to seven image references or one video reference,
|
|
29
|
-
with lower image limits when video is also present.
|
|
30
|
-
- `multi_image_to_3d` accepts one to four images.
|
|
31
|
-
- `seed_audio` may use audio or image references, but not both together.
|
|
32
|
-
|
|
33
|
-
Do not pass `--generate-audio` to Seedance 2.0. Use `--audio` for its reference
|
|
34
|
-
audio.
|
|
@@ -1,41 +0,0 @@
|
|
|
1
|
-
# Higgsfield Video Workflows
|
|
2
|
-
|
|
3
|
-
Inspect the live workflow before submission:
|
|
4
|
-
|
|
5
|
-
```json
|
|
6
|
-
{"args":["workflow","get","draw_to_video"]}
|
|
7
|
-
{"args":["workflow","get","reframe"]}
|
|
8
|
-
```
|
|
9
|
-
|
|
10
|
-
## Draw to Video
|
|
11
|
-
|
|
12
|
-
Use when the user supplies a source video, an edited or sketched frame, its
|
|
13
|
-
timestamp, and an edit instruction:
|
|
14
|
-
|
|
15
|
-
```json
|
|
16
|
-
{"args":["generate","workflow","draw_to_video","--video","/files/source.mp4","--sketch","/files/frame.png","--timestamp","3.2","--prompt","make the jacket red","--wait"]}
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
`--image` is an alias for `--sketch`.
|
|
20
|
-
|
|
21
|
-
## Reframe
|
|
22
|
-
|
|
23
|
-
Use for aspect-ratio conversion:
|
|
24
|
-
|
|
25
|
-
```json
|
|
26
|
-
{"args":["generate","workflow","reframe","--video","/files/source.mp4","--aspect-ratio","9:16","--resolution","720p","--wait"]}
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
Optional parameters include `--mode std|pro`, `--start-image`, image references
|
|
30
|
-
for Pro mode, and `--folder-id`.
|
|
31
|
-
|
|
32
|
-
## Cost and results
|
|
33
|
-
|
|
34
|
-
Cost uses `generate cost workflow`:
|
|
35
|
-
|
|
36
|
-
```json
|
|
37
|
-
{"args":["generate","cost","workflow","reframe","--duration","7.1","--resolution","1080p"]}
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
Workflow jobs are normal generation jobs. Retrieve them with `generate get` or
|
|
41
|
-
`generate wait`, not `workflow get`.
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: higgsfield-product-photoshoot
|
|
3
|
-
description: Generate brand-quality Higgsfield product photography through the official product-photoshoot prompt enhancer. Use for studio shots, lifestyle scenes, hero banners, Pinterest pins, social carousels, ad creative packs, virtual try-on, conceptual product visuals, or restyling an existing product image.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Higgsfield Product Photoshoot
|
|
7
|
-
|
|
8
|
-
Use the approval-gated `higgsfield__write` connection tool with
|
|
9
|
-
`product-photoshoot create`. Do not bypass the backend prompt enhancer with a
|
|
10
|
-
generic GPT Image command.
|
|
11
|
-
|
|
12
|
-
Choose the most specific mode:
|
|
13
|
-
|
|
14
|
-
- `product_shot`: neutral, studio, catalog, or storefront image
|
|
15
|
-
- `lifestyle_scene`: product in a real environment
|
|
16
|
-
- `closeup_product_with_person`: hands, partial face, or demonstration
|
|
17
|
-
- `moodboard_pin`: vertical Pinterest-native visual
|
|
18
|
-
- `hero_banner`: wide website or campaign header
|
|
19
|
-
- `social_carousel`: connected multi-slide set
|
|
20
|
-
- `ad_creative_pack`: coordinated paid-social variants
|
|
21
|
-
- `virtual_model_tryout`: product worn or used by a generated model
|
|
22
|
-
- `conceptual_product`: surreal, floating, splash, or CGI-style visual
|
|
23
|
-
- `restyle`: change an existing image's mood or season while preserving subject
|
|
24
|
-
|
|
25
|
-
Ask only for unresolved essentials: product/reference image, use case or mode,
|
|
26
|
-
count, and desired mood. Pass `/files/...` paths directly:
|
|
27
|
-
|
|
28
|
-
```json
|
|
29
|
-
{"args":["product-photoshoot","create","--mode","lifestyle_scene","--prompt","cold-brew bottle on a sunlit kitchen counter for Instagram","--image","/files/bottle.jpg","--count","3"]}
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
Use `--count 1..10` for variants. Let the backend choose aspect ratio unless
|
|
33
|
-
the user explicitly requests one; supported overrides are `1:1`, `4:5`,
|
|
34
|
-
`5:4`, `3:4`, `4:3`, `2:3`, `3:2`, `9:16`, and `16:9`.
|
|
35
|
-
|
|
36
|
-
Return the image URLs as a short list. Do not expose the enhanced prompt, raw
|
|
37
|
-
job JSON, or internal model IDs.
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: higgsfield-soul-id
|
|
3
|
-
description: Train and reuse a Higgsfield Soul Character from a person's photos for identity-consistent image or cinematic generation. Use when the user asks to train their face, create a digital twin, build a reusable personal avatar, or preserve identity across generated media.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Higgsfield Soul Character
|
|
7
|
-
|
|
8
|
-
Use `higgsfield__read` for account and Soul lookup. Use the approval-gated
|
|
9
|
-
`higgsfield__write` connection tool for training.
|
|
10
|
-
|
|
11
|
-
Before submission:
|
|
12
|
-
|
|
13
|
-
1. Check account status; Soul training requires a paid Higgsfield plan.
|
|
14
|
-
2. Collect a name and 5–20 well-lit face photos with varied angles.
|
|
15
|
-
3. Choose `--soul-2` for image generation or `--soul-cinematic` for cinematic
|
|
16
|
-
use. Default to `--soul-2`.
|
|
17
|
-
|
|
18
|
-
Pass `/files/...` paths directly; the CLI auto-uploads them:
|
|
19
|
-
|
|
20
|
-
```json
|
|
21
|
-
{"args":["soul-id","create","--name","Alice","--soul-2","--image","/files/alice-1.jpg","--image","/files/alice-2.jpg","--image","/files/alice-3.jpg","--image","/files/alice-4.jpg","--image","/files/alice-5.jpg"]}
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
Wait without duplicating the training job:
|
|
25
|
-
|
|
26
|
-
```json
|
|
27
|
-
{"args":["soul-id","wait","<soul_id>"]}
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
Use the resulting reference in generation:
|
|
31
|
-
|
|
32
|
-
```json
|
|
33
|
-
{"args":["generate","create","text2image_soul_v2","--prompt","cinematic portrait at dusk","--soul-id","<reference_id>","--quality","2k","--wait"]}
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
Do not expose raw IDs in normal chat unless needed. Respect likeness consent;
|
|
37
|
-
never infer permission to train or reuse another person's identity.
|