Skip to main content
Resources

FAQ

Answers about Higgsfield API authentication, asynchronous requests, model selection, billing, limits, and output retention.

Frequently Asked Questions

What base URL and authentication header should I use?

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.

Why does a generation request not return the media immediately?

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.

Which model or endpoint should I use?

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.

What is the retention policy for generated output files?

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.

Are failed requests charged?

No. Failed generation requests are not charged to your account. You are only billed for successful completions. In the event of a failure, any costs associated with that request are automatically refunded.

What does NSFW status mean?

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.

Are NSFW-flagged requests charged?

No. Requests flagged as NSFW are not charged to your account. When content is rejected by our moderation system, any associated costs are automatically refunded.

Do you offer invoice-based billing?

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, contact sales.

What are the API rate limits?

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.

How do I monitor my API usage?

You can monitor your API usage, spending, and request history through the Higgsfield Console dashboard. The dashboard provides real-time analytics and detailed usage reports.

Which programming languages are supported?

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.

How do I get started with the API?

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

What happens if a generation takes too long?

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:

Was this page helpful?
Navigation