Skip to main content

​
Frequently Asked Questions

Send requests to https://api.higgsfield.ai and authenticate server-side with Authorization: Key YOUR_KEY_ID:YOUR_KEY_SECRET. Do not use a Bearer token or expose the secret in browser or mobile code. See Authentication.
Generation is asynchronous. A successful submission returns request_id, status_url, and cancel_url. Poll status_url or configure a webhook, then read the output URL after the status becomes completed. See Requests and lifecycle.
Choose by input and output workflow: text-to-image, image editing, text-to-video, image-to-video, or frame-controlled video. Model availability depends on your account. Not sure which endpoint fits your case? Ask in our Discord.
Generated output files are stored and accessible for a minimum of 7 days from the time of creation. We strongly recommend downloading and storing files in your own infrastructure for long-term retention. Files may be removed from our servers at any time after the 7-day retention period.
No. Failed generation requests are not charged to your account. You are only billed for successful completions. In the event of a failure, any credits or costs associated with that request are automatically refunded.
NSFW (Not Safe For Work) indicates that either your input parameters or the generated output did not pass our content moderation system due to content policy violations. Content policy rules and restrictions may vary depending on the specific model being used.
No. Requests flagged as NSFW are not charged to your account. When content is rejected by our moderation system, any associated credits or costs are automatically refunded.
The API runs on pay-as-you-go by default: you top up a balance and pay per generation. Invoice-based billing is available for customers on a committed-use contract. To discuss one, email support@higgsfield.ai.
Rate limits depend on your account and the selected model. You can view your current limits and usage in your dashboard. Need a higher limit? Let us know in our Discord.
You can monitor your API usage, credit consumption, and request history through the Higgsfield Console dashboard. The dashboard provides real-time analytics and detailed usage reports.
We provide official Python and Node.js/TypeScript SDKs. You can also integrate directly through the REST API from any language with an HTTP client. See Client libraries.
To get started:
  1. Create an account at console.higgsfield.ai
  2. Generate your API credentials from the dashboard
  3. Follow our Quickstart for your first integration
  4. Read How the API works, then use a generation endpoint available to your account
Generation requests have model-specific timeout limits. If a request exceeds the timeout, it will be marked as failed and you will not be charged. You can resubmit the request. If timeouts keep happening, reach out in our Discord with your request_id.

​
Still have questions?

If you didn’t find your answer, here is where to go next: