integration.provider-higgsfield

Higgsfield provider

Tenant-isolated HTTP adapter for asynchronous images, image-to-video, and talking presenters. Uses the protocol documented in the official Higgsfield TypeScript SDK. The SDK's current v2 implementation stores credentials globally and retries POSTs; this adapter instead resolves credentials per scoped call and submits once.

Inject credentials, trusted authorization, and exact input/output asset host allowlists. The authority port must check durable request/job ownership, current rights, qualification, and cost reservation. It must never authorize from caller strings alone. Use durable orchestration before calling submit; this low-level adapter does not itself provide idempotent submission storage.

For durable orchestration use lib.content-gen/media/workflow with SqlMediaGenerationStore from integration.growth-persistence/marketing. It saves the provider request ID before asset ingestion and resumes failed imports through an idempotent, host-qualified artifact ingestor.

An uncertain submission returns unknown; never resubmit automatically. Poll only known provider job IDs. Ignore provider-returned status/cancel URLs and use the pinned API origin. Cancellation is unavailable until its semantics are qualified. Outputs are temporary locations to ingest into the host asset store, not publication approvals. Responses and errors never include provider headers or raw error bodies.

BYOK only. Managed provisioning, MCP transport, and live provider certification remain unqualified. HTTP fixture tests do not certify account/model access.

Reference: https://github.com/higgsfield-ai/higgsfield-js