SAM 3
SAM 3 (Segment Anything Model 3) delivers foundation-level zero-shot visual segmentation and subject extraction. Seamlessly isolate objects, extract alpha-transparent PNG cutouts, or target specific items with natural language prompts.
API endpoint
POST
https://lumozai.com/api/v4/run
Use this endpoint to run the model with your parameters. Authentication is required using your API key.
Sample code (PHP cURL)
PHP (cURL)
<?php
// API endpoint URL
$apiUrl = 'https://lumozai.com/api/v4/run';
// Your API key
$apiKey = 'YOUR_API_KEY';
// Model parameters
$params = [
'model_id' => 'sam-3',
'image_url' => '',
'prompt' => '',
'apply_mask' => 'true',
'output_format' => 'png',
'return_multiple_masks' => 'false',
'max_masks' => 3,
'include_boxes' => 'false',
'include_scores' => 'false',
];
// Initialize cURL session
$curl = curl_init();
// Set cURL options
curl_setopt_array($curl, [
CURLOPT_URL => $apiUrl,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $params,
CURLOPT_HTTPHEADER => [
'Accept: application/json',
'Authorization: Bearer ' . $apiKey
]
]);
// Execute the request
$response = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
// Check for errors
if (curl_errno($curl)) {
echo 'cURL Error: ' . curl_error($curl);
} else {
// Process the response
$result = json_decode($response, true);
if ($httpCode == 200 && isset($result['success']) && $result['success']) {
// Handle successful response
echo 'Model output: ';
print_r($result['data']['output']);
} else {
// Handle error response
echo 'Error: ' . ($result['message'] ?? 'Unknown error');
}
}
// Close cURL session
curl_close($curl);
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
model_id |
string | Required | The ID of the model to run (sam-3) |
api_key |
string | Required | Your API key for authentication (sent via Bearer token in the Authorization header) |
image_url |
string | Required | Source image to segment or extract objects from. |
prompt |
string | Optional | Natural language prompt identifying which subject(s) to isolate. Leave blank to segment the primary subject. |
apply_mask |
string | Optional | Apply mask as a transparent cutout (alpha PNG) or export binary segmentation mask. |
output_format |
string | Optional | File format for the generated image or mask. |
return_multiple_masks |
string | Optional | Extract separate masks for each distinct detected object instance. |
max_masks |
number | Optional | Maximum number of masks returned when multiple masks is enabled. |
include_boxes |
string | Optional | Include bounding box coordinates in telemetry metadata. |
include_scores |
string | Optional | Include model segmentation confidence scores. |
Response format
JSON
{
"success": true,
"data": {
"output": "https://lumozai.com/storage/outputs/example.png"
}
}
تسعير النموذج
ادفع فقط مقابل ما تشغّله. تُخصم التكلفة مباشرة من رصيدك دون أي التزامات متكررة.
Rate per generation
$
0.008
/ generation
$8.00 per 1,000 generations
حاسبة التكلفة
1,000 generations
الإجمالي التقديري
$8.00
استرداد تلقائي فوري عند فشل أي عملية • الرصيد صالح لمدة عام