https://livepairai.com/hf answers the Higgsfield wire formats so
third-party Higgsfield clients — community studios, SDKs, scripts —
run on LivePair by changing the base URL. Requests translate into the
native generation path, so billing, policy checks and metering are
identical to /v1/agent.
Wire coverage
| Client shape | Submit | Poll | Auth |
|---|---|---|---|
| Platform API (Open-Higgsfield, community tools) | POST /hf/{model-path} | GET /hf/requests/{id}/status | Authorization: Key id:secret |
| SDK v1 (higgsfield-js / -client / CLI) | POST /hf/v1/{task}/{model} | GET /hf/v1/job-sets/{id} | hf-api-key + hf-secret |
Put your lp_ key in either credential slot — Key lp:YOUR_KEY,
key:lp_…, or hf-secret: lp_… all resolve. Calls bill the key
owner's prepaid credits at list price, same as x-api-key on the
native API.
Model mapping
Paths translate by surface — the client's model name is a hint, not a contract:
| Incoming path | LivePair model |
|---|---|
*/image-to-video, image2video/*, paths carrying a source image | wan-3.0-i2v |
*/text-to-video, text2video/*, Kling / Seedance / Veo-style video paths | wan-3.0-t2v |
Image paths with an input image, *edit* | seedream-5.0-edit |
ideogram* | ideogram-3-balanced |
qwen* | qwen-image-3 |
| Everything else image-side (soul, flux, z-image, recraft…) | seedream-5.0 |
LivePair model ids (qwen-image-3, wan-3.0-i2v, …) | pass straight through |
Parameters that carry over: prompt, image_url / input_images,
aspect_ratio, duration, resolution (4k→1080p video / 2k
image), audio off flags. Higgsfield-only knobs — elements, soul ids,
motion presets, batch_size — are dropped.
Example: Open-Higgsfield
HF_API_BASE_URL=https://livepairai.com/hf
# then paste `key:lp_…` as the platform key in the studio UI
Example: higgsfield-js
const client = new HiggsfieldClient({
baseURL: "https://livepairai.com/hf",
apiKey: "key", // placeholder — any non-empty value
apiSecret: "lp_…", // your LivePair key
});
await client.generate("/v1/text2image/soul", { prompt: "…" });
Not covered
Soul ID training, the elements reference system, motion-control
presets, custom references, speak/voice tools, file-upload endpoints
and webhooks return 501 with a pointer to the native API rather
than a silent mismatch.
The full native surface — model catalog, jobs, tools, x402, the
OpenAI image/video shapes, MCP — lives at
/v1/agent (API docs).