よくある質問
タスク、再試行、クレジット、ファイルのアップロードに関するよくある質問。
同期エンドポイントはありますか？
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.
どのくらいの頻度でポーリングすべきですか？
数秒ごとです。Web Playground は 4 秒ごとにポーリングします。succeeded、failed、reconciliation_required で停止してください。
送信中にネットワークが切れたらどうなりますか？
同じ Idempotency-Key と同じボディで再試行してください。タスクが受け付けられていれば、二重に課金されることなくそのタスクが返されます（200、replayed: true）。
モデルを実行できないのはなぜですか？
Check that the model is available and your balance covers the task price. The error code explains why a request cannot run.
クレジットを追加するには？
Open Billing in the console to buy credits and view your balance, payments and usage. Credits become available after payment confirmation.
ローカルファイルを送信できますか？
POST /api/v1/media でアップロードし、返された media:<uuid> 参照をモデルの画像または動画フィールドに指定してください。公開 HTTPS URL も使用できます。