山海印 API 文档

API 适合需要把山海印鉴别能力接入内部系统的团队，例如内容审核后台、商家申诉取证流程、 自动化工作流、插件、脚本或其他服务端工具。API 调用使用你的山海印账户点数， 检测结论、请求编号和内容指纹与网页端保持同一套口径。

如果只是偶尔检测文件，直接使用网页或小程序即可；如果需要系统自动提交检测、保存结果或与业务记录关联， 再使用 API 更合适。

登录后进入 账户中心的 API 调用 创建 API Key。 每个账户最多保留 10 个有效 API Key，可以随时作废。完整密钥只在创建时显示一次， 请立即复制并保存到你的服务端环境变量或密钥管理系统。

API Key 不要写进网页前端、小程序包、移动 App 或公开代码仓库。发现泄露时，先在账户中心作废旧 Key， 再创建新的 Key。

所有公开 API 请求都需要在 Header 中携带 API Key。推荐写法：

Authorization: Bearer shy_live_your_key
Content-Type: application/json

上传文件时由客户端自动生成 multipart 边界，通常只需要设置授权头：

Authorization: Bearer shy_live_your_key
Content-Type: multipart/form-data

也兼容以下请求头：

X-Shanhaiyin-Api-Key: shy_live_your_key

音频和视频不足 1 分钟按 1 分钟计，超出部分按整分钟向上取整；最终以服务器读取的文件时长为准。

请求字段

返回示例

{
  "ok": true,
  "provider": "shanhaiyin",
  "service": "image-aigc-detector",
  "requestId": "SHY-20260819-ABC12345",
  "riskLevel": "high",
  "modelScore": 96.5,
  "detected": true,
  "modelDecision": "Block",
  "results": [
    {
      "label": "aigc",
      "confidence": 96.5,
      "description": "模型发现较强的 AI 生成或深度伪造特征",
      "riskLevel": "high"
    }
  ],
  "fileHash": "e3566ed2eb18...e0d7c03848",
  "detectedAt": "2026-08-19T08:00:00+00:00",
  "billing": {
    "charged": true,
    "channel": "api",
    "units": 1
  }
}

curl 示例

curl -X POST https://shanhaiyin.com/api/v1/images/analyze \
  -H "Authorization: Bearer shy_live_your_key" \
  -F "image=@/path/to/image.jpg"

请求示例

{
  "text": "这里放需要检测的文字内容，当前限制为 350 到 2000 个字符。"
}

请求字段

返回说明

文字接口为同步返回，字段结构与图片检测一致，会额外返回 textHash、textLength 和 billingUnits。

curl 示例

curl -X POST https://shanhaiyin.com/api/v1/text/analyze \
  -H "Authorization: Bearer shy_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text":"这里放需要检测的文字内容，当前限制为 350 到 2000 个字符。"}'

请求字段

创建任务返回示例

{
  "ok": true,
  "status": "processing",
  "jobId": "9f1c4a2b3d4e5f60718293a4b5c6d7e8",
  "mediaKind": "audio",
  "durationSeconds": 73.42,
  "billingMinutes": 2,
  "retryAfter": 3,
  "billing": {
    "charged": true,
    "channel": "api",
    "units": 6
  }
}

curl 示例

curl -X POST https://shanhaiyin.com/api/v1/audio/analyze \
  -H "Authorization: Bearer shy_live_your_key" \
  -F "audio=@/path/to/audio.mp3"

请求字段

创建任务返回示例

{
  "ok": true,
  "status": "processing",
  "jobId": "9f1c4a2b3d4e5f60718293a4b5c6d7e8",
  "mediaKind": "video",
  "durationSeconds": 73.42,
  "billingMinutes": 2,
  "retryAfter": 3,
  "billing": {
    "charged": true,
    "channel": "api",
    "units": 16
  }
}

curl 示例

curl -X POST https://shanhaiyin.com/api/v1/video/analyze \
  -H "Authorization: Bearer shy_live_your_key" \
  -F "video=@/path/to/video.mp4"

路径参数

处理中返回示例

{
  "ok": true,
  "status": "processing",
  "jobId": "9f1c4a2b3d4e5f60718293a4b5c6d7e8",
  "mediaKind": "video",
  "retryAfter": 3
}

完成后返回示例

{
  "ok": true,
  "provider": "shanhaiyin",
  "service": "video-aigc-detector",
  "requestId": "SHY-20260819-DEF67890",
  "providerTaskId": "w-video-aigc-xxx",
  "riskLevel": "high",
  "modelScore": 99,
  "detected": true,
  "modelDecision": "Block",
  "fileHash": "4f15e6d23d...87eaf894",
  "fileName": "video.mp4",
  "results": [
    {
      "label": "video_aigc",
      "confidence": 99,
      "description": "模型发现较强的 AI 生成视频画面特征",
      "riskLevel": "high"
    }
  ],
  "billing": {
    "charged": true,
    "channel": "api",
    "units": 16
  }
}

curl 示例

curl https://shanhaiyin.com/api/v1/media-status/9f1c4a2b3d4e5f60718293a4b5c6d7e8 \
  -H "Authorization: Bearer shy_live_your_key"

错误格式

{
  "ok": false,
  "code": "INSUFFICIENT_POINTS",
  "message": "点数不足，请充值后再进行图片鉴别。"
}

API 返回结果是技术参考，不应单独作为司法、行政或平台最终认定。重要场景请结合原文件、 订单记录、传播记录和人工复核。

先创建 API Key，再确认账户点数充足。需要补充点数时可前往 点数充值。

进入账户中心申请 API Key