常见问题
关于任务、重试、额度和文件上传的常见问题解答。
是否有同步接口？
图像、视频和音乐模型以异步任务运行：POST /api/v1/jobs 立即返回任务 ID，随后轮询 GET /api/v1/jobs/{id} 直到终态。大语言模型通过 POST /api/v1/chat/completions 同步返回。
可以使用 OpenAI SDK 吗？
可以。把 base URL 设为 https://api.hermes-ai.net/api/v1，API Key 使用 Hermes 的 Key。对话补全、流式输出、工具调用和 JSON 输出无需改动；模型 id 见 GET /api/v1/chat/models。
应该多久轮询一次？
每隔几秒一次。网页 Playground 每 4 秒轮询一次。在 succeeded、failed 或 reconciliation_required 时停止。
提交时网络中断怎么办？
使用相同的 Idempotency-Key 和请求体重试。如果任务已被接收，会返回原任务（200，replayed: true），不会重复扣费。
为什么无法运行某个模型？
请确认模型当前可用，且账户余额足以支付任务费用。错误码会说明请求无法执行的原因。
如何增加额度？
在控制台的账单页面购买额度，并查看余额、付款和用量。付款确认后额度到账。
可以发送本地文件吗？
使用 POST /api/v1/media 上传，并将返回的 media:<uuid> 引用填入模型的图像或视频字段。也可使用公开 HTTPS URL。