01
获取 API Key
创建免费账号，API Key 即时生成，无需等待，无需信用卡。
创建免费账号 →您的 Key 格式如下：
// Your key will look like:
const API_KEY = "sk-sam3-xxxxxxxxxxxxxxxxxxxxxxxx";// Your key will look like:
const API_KEY = "sk-sam3-xxxxxxxxxxxxxxxxxxxxxxxx";02
发送第一个请求
将图片（Base64 编码）和文字提示词 POST 到我们的端点，任何 HTTP 客户端均可使用。
curl -X POST https://api.sam3.ai/v1/segment \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "data:image/jpeg;base64,/9j/4AAQ...",
"prompts": ["cat"]
}'curl -X POST https://api.sam3.ai/v1/segment \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "data:image/jpeg;base64,/9j/4AAQ...",
"prompts": ["cat"]
}'NewClick-to-segment endpoint —
Read docs →/v1/pvsUse point prompts (positive/negative) to segment a specific area — no text prompt required. Same auth, same pricing as /v1/segment.
# Click-to-segment (PVS) — when you already know the area you want
curl -X POST https://api.sam3.ai/v1/pvs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "data:image/jpeg;base64,/9j/4AAQ...",
"points": [
{ "x": 412, "y": 318, "positive": true },
{ "x": 540, "y": 290, "positive": false }
]
}'# Click-to-segment (PVS) — when you already know the area you want
curl -X POST https://api.sam3.ai/v1/pvs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"image": "data:image/jpeg;base64,/9j/4AAQ...",
"points": [
{ "x": 412, "y": 318, "positive": true },
{ "x": 540, "y": 290, "positive": false }
]
}'03
解析响应结果
返回结果包含多边形遮罩、标签和置信度，可直接在应用中渲染。
JSON 响应
{
"masks": [
{
"label": "cat",
"confidence": 0.96,
"polygon": [
[120, 45], [185, 32], [260, 40],
[318, 78], [325, 160], [290, 240],
[200, 268], [118, 250], [80, 175],
["..."]
]
}
]
}{
"masks": [
{
"label": "cat",
"confidence": 0.96,
"polygon": [
[120, 45], [185, 32], [260, 40],
[318, 78], [325, 160], [290, 240],
[200, 268], [118, 250], [80, 175],
["..."]
]
}
]
}每个遮罩包含对象标签、置信度分数和多边形坐标。
每次 API 调用消耗 1 个额度 · 注册即送 5 个免费额度更多额度最低 $0.07 / 次查看定价 →