认证与请求信封

所有 MADES API 调用均需携带认证信息，请求 / 响应遵循统一信封格式。

认证方式

使用 X-API-Key 请求头进行认证，在门户中创建 API Key 后即可获得（mds_live_ 开头）。

API 端点

curl · 同步调用

curl -X POST https://gw.mades.ai/v1/invoke/{service_id} \
  -H "X-API-Key: mds_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "uuid-v4",
    "params": { ... }
  }'

响应格式

{
  "request_id": "uuid",
  "status": "succeeded | failed",
  "data": { /* 业务返回结果 */ },
  "credits_consumed": 2.0,
  "error": { "code": "string", "message": "string" }
}

错误码

状态码	code	说明
400	VALIDATION_ERROR	请求参数不合规
401	AUTH_FAILED	API Key 无效
402	INSUFFICIENT_BALANCE	余额不足
403	TIER_NOT_ALLOWED	套餐等级不允许
404	SERVICE_NOT_FOUND	服务不存在
409	DUPLICATE_REQUEST	重复请求（幂等命中）
429	RATE_LIMITED	触发限流
503	CIRCUIT_BREAKER_OPEN	服务熔断

MCP 接入指南

使用标准 MCP 协议接入，在任意支持 MCP 的客户端中配置https://gw.mades.ai/mcp端点并携带 API Key 即可。

查看完整接入教程