API Documentation

Integrate RmWatermark AI image processing into your applications.

Authentication

All API requests require a Bearer token in the Authorization header. Get your API key from the Dashboard.

curl -H "Authorization: Bearer sk_live_xxxx"      -H "Content-Type: application/json"      https://rmwatermark.net/api/v1/balance

Tools & Pricing

TypeCreditsDescription
remove-bg1去除圖片背景
remove-watermark1去除浮水印

POST /api/v1/jobs

Create a new image processing job

Request Body

{
  "type": "remove-watermark",
  "image_url": "https://example.com/photo.jpg",
  "options": {
    "mode": "pro",
    "prompt": "去除图片中的所有水印文字和 LOGO，其余内容保持不变"
  }
}

// mode: "auto" 本地检测修复 1 积分 | "pro" 大模型编辑 3 积分（可自定义 prompt） | "manual" 需传 mask_url

Response

{
  "data": {
    "id": "uuid",
    "type": "remove-watermark",
    "status": "processing",
    "result_urls": null,
    "credits_used": 0,
    "processing_ms": null
  }
}

GET /api/v1/jobs/{id}

Get job status and results

Response

{
  "data": {
    "id": "uuid",
    "type": "remove-bg",
    "status": "completed",
    "result_urls": ["https://..."],
    "error_message": null,
    "credits_used": 1,
    "processing_ms": 1234,
    "created_at": "2026-06-04T00:00:00Z"
  }
}

GET /api/v1/balance

Get your remaining credit balance

Response

{
  "data": {
    "balance": 497,
    "total_earned": 1000,
    "total_spent": 503
  }
}

Error Codes

CodeDescription
400無效的請求參數
401缺少或無效的 API 金鑰
402積分不足
404找不到工作
500內部伺服器錯誤