跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.vmeg.ai/llms.txt

Use this file to discover all available pages before exploring further.

Open API 使用 JSON 字段 code 表示业务结果。HTTP 状态码用于传输层（例如认证失败为 401），成功与否以 code 为准。

​
码表

code名称说明
200Success请求成功
400Bad Request参数无效或校验失败
401UnauthorizedAPI Key 缺失或无效
402Payment Required积分或配额不足
404Not Found资源不存在
409Conflict幂等键已被使用
413Payload Too Large上传或请求体超限
422Unprocessable Entity格式正确但无法处理
500Internal Server Error服务端错误
502Bad Gateway上游处理失败

​
响应结构

{
  "code": 402,
  "message": "Insufficient quota",
  "data": null
}
  • 成功：code === 200，载荷在 data
  • 失败：message 供日志与支持排查

​
常见场景

同一 X-Idempotency-Key 在幂等 POST 接口的 TTL 内重复使用时返回。响应可能包含 Retry-After: 2。见 幂等。
任务无法扣减项目积分时返回。见 价格 或在 vmeg.ai 价格页 充值。
上游服务调用失败或超时。使用 taskId 轮询 GET /openapi/v1/tasks/detail（vmeg.ai 网页任务记录不包含 Open API 任务）；若已配置 Webhook，可等待重试。