Higgsfield API in Practice: Prompt to Editorial Photo, and the Defaults That Bite

说明与用途

开发者需要一个可靠、成本可控的 Higgsfield 图像生成 API 工作流，解决文档不一致、身份验证细节、状态轮询和准确计价等问题。

问题

Developers need a reliable, cost‑aware workflow for generating images with Higgsfield’s API, but the documentation contains inconsistencies and undocumented behaviors that can cause failures and unexpected charges.

结果

The workflow demonstrates that authentication, status polling, and cost estimation can be handled with minimal dependencies, and that careful handling of undocumented headers and discount logic prevents unexpected failures and charges.

工作流

• Export HF_API_KEY_ID and HF_API_KEY_SECRET as environment variables.
• Send a POST to https://api.higgsfield.ai/{model} with the Authorization header and an Idempotency-Key. Receive a response containing status, request_id, status_url, and cancel_url. Poll status_url every 2–10 s until status is one of completed, failed, nsfw, or canceled. If completed, download the image from the provided URL. If failed/ nsfw/ canceled, handle accordingly. Before sending a request, POST to /estimate/{model} with the same body to obtain credits and USD, including any discount. Verify the estimate against the account balance; if the estimate exceeds the balance, abort before submission. Use the x-correlation-id (lowercase) header for tracing and handle x-process-time if needed.

证据

The docs' model page counts 84 entries (17 image, 67 video), while GET /models answered with 85 on my account — 18 image and 67 video by slug.

来源

That 404 is the good outcome — it means the credentials were accepted and the request id simply does not exist.

来源

Ask the price first: /estimate returns credits and USD for your account before anything is spent.

来源

Only successful generations are charged. failed and nsfw requests are not billed, and reserved credits are refunded; a canceled queued request is refunded too.

来源