Meta: SAM 3

Integrate the Roboflow "SAM 3" workflow into my app.

- Endpoint: POST https://serverless.roboflow.com/<your-workspace>/workflows/sam-3-promptable-concept-segmentation
- Auth: send my Roboflow API key as `api_key` in the request body, read from the ROBOFLOW_API_KEY env var (never hardcode).
- Body: { "api_key": ..., "inputs": { `image`: { type: "url" | "base64", value }, `classes`: string array } }.

With the Roboflow MCP connected, call `workflows_get` on "sam-3-promptable-concept-segmentation" to read the exact input schema (the source of truth), then `workflows_run` on a sample image to confirm the output shape before writing code (the MCP is authenticated, so this needs no key). Without the MCP, use the contract above.

Before running the app, set up these keys so it does not error at runtime:
- `ROBOFLOW_API_KEY` (sent as `api_key`) from https://app.roboflow.com/settings/api
Create a .gitignore'd .env with these variables, using placeholder values for any I haven't given you. Then pause and tell me directly, in your reply: the full path to the .env file, exactly which keys I need to paste in, and the link to get each one. Wait for me to confirm I've added them before you run anything. Do not run the app until I confirm.

Then add the integration to my codebase: match my project's language, framework, and conventions; read every key from environment variables (never hardcode); add basic error handling; and include a small runnable example. If you can't tell what language my project uses, ask me.

# 1. Import the library
from inference_sdk import InferenceHTTPClient

# 2. Connect to your workflow
client = InferenceHTTPClient(
  api_url="https://serverless.roboflow.com",
  api_key="YOUR_API_KEY"
)

# 3. Run your workflow on an image
result = client.run_workflow(
  workspace_name="your-workspace",
  workflow_id="sam-3-promptable-concept-segmentation",
  images={
    "image": "YOUR_IMAGE.jpg"  # Path to your image file
  },
  parameters={
    "classes": ["class1", "class2", "class3"]
  },
  use_cache=True  # cache workflow definition for 15 minutes
)

# 4. Get your results
print(result)

const response = await fetch('https://serverless.roboflow.com/your-workspace/workflows/sam-3-promptable-concept-segmentation', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    inputs: {
      "image": {"type": "url", "value": "IMAGE_URL"},
      "classes": ["class1", "class2", "class3"]
    }
  })
});

const result = await response.json();
console.log(result);

curl --location 'https://serverless.roboflow.com/your-workspace/workflows/sam-3-promptable-concept-segmentation' \
--header 'Content-Type: application/json' \
--data '{
  "api_key": "YOUR_API_KEY",
  "inputs": {
    "image": {"type": "url", "value": "IMAGE_URL"},
    "classes": ["class1", "class2", "class3"]
  }
}'