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.