자주 묻는 질문

작업, 재시도, 크레딧, 파일 업로드에 관한 자주 묻는 질문.

동기 엔드포인트가 있나요?

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.

얼마나 자주 폴링해야 하나요?

몇 초마다 폴링하세요. 웹 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도 사용할 수 있습니다.