Skip to content

FAQ

Answers to common questions about tasks, retries, credits and file uploads.

Is there a synchronous endpoint?

Image, video and music models run as asynchronous tasks: POST /api/v1/jobs returns immediately with a task ID, and you poll GET /api/v1/jobs/{id} until a terminal status. Language models are synchronous through POST /api/v1/chat/completions.

Can I use the OpenAI SDK?

Yes. Set the base URL to https://api.hermes-ai.net/api/v1 and your Hermes key as the API key. Chat completions, streaming, tools and JSON output work unchanged; pick a model id from GET /api/v1/chat/models.

How often should I poll?

Every few seconds. The web playground polls every 4 seconds. Stop at succeeded, failed or reconciliation_required.

What happens if my network drops during submission?

Retry with the same Idempotency-Key and the same body. If the task was accepted you get it back (200, replayed: true) without a second charge.

Why can't I run a model?

Check that the model is available and your balance covers the task price. The error code explains why a request cannot run.

How do I add credits?

Open Billing in the console to buy credits and view your balance, payments and usage. Credits become available after payment confirmation.

Can I send local files?

Upload them with POST /api/v1/media and put the returned media:<uuid> reference in the model's image or video field. Public HTTPS URLs also work.