Object Detector API

The Object Detector API is a powerful tool designed to identify objects within images based on specific keywords.

About

Leveraging state-of-the-art machine learning algorithms, this API offers seamless integration for developers seeking to incorporate object detection functionality into their applications.

With the Object Detector API, users can submit images along with a list of keywords corresponding to the objects they wish to identify. The API then processes the image using advanced computer vision techniques to locate and label objects matching the provided keywords. Whether you need to detect common items like "car," "dog," or "tree," or more specialized objects such as "cell phone" or "umbrella," the Object Detector API delivers accurate and reliable results.

Developers can integrate this API into a wide range of applications across various industries, including e-commerce, automotive, healthcare, and more. By accurately identifying objects within images, developers can enhance user experiences, automate tasks, and extract valuable insights from visual data.

Developer Portal: https://api.market/store/magicapi/objectdetector

Curl Requests and Responses

Process the API

Curl

curl -X 'POST' \
  'https://api.magicapi.dev/api/v1/magicapi/objectdetector/objectdetector' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "image": "https://replicate.delivery/mgxm/36b04aec-efe2-4dea-9c9d-a5faca68b2b2/000000039769.jpg",
  "text": "a photo of a dog | a cat | two cats with remote controls"
}'

Python

import requests

headers = {
    'accept': 'application/json',
    'x-magicapi-key': 'API_KEY',
    'Content-Type': 'application/json',
}

json_data = {
    'image': 'https://replicate.delivery/mgxm/36b04aec-efe2-4dea-9c9d-a5faca68b2b2/000000039769.jpg',
    'text': 'a photo of a dog | a cat | two cats with remote controls',
}

response = requests.post(
    'https://api.magicapi.dev/api/v1/magicapi/objectdetector/objectdetector',
    headers=headers,
    json=json_data,
)

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.magicapi.dev/api/v1/magicapi/objectdetector/objectdetector');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'accept: application/json',
    'x-magicapi-key: API_KEY',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n  \"image\": \"https://replicate.delivery/mgxm/36b04aec-efe2-4dea-9c9d-a5faca68b2b2/000000039769.jpg\",\n  \"text\": \"a photo of a dog | a cat | two cats with remote controls\"\n}");

$response = curl_exec($ch);

curl_close($ch);

NodeJs

import axios from 'axios';

const response = await axios.post(
  'https://api.magicapi.dev/api/v1/magicapi/objectdetector/objectdetector',
  // '{\n  "image": "https://replicate.delivery/mgxm/36b04aec-efe2-4dea-9c9d-a5faca68b2b2/000000039769.jpg",\n  "text": "a photo of a dog | a cat | two cats with remote controls"\n}',
  {
    'image': 'https://replicate.delivery/mgxm/36b04aec-efe2-4dea-9c9d-a5faca68b2b2/000000039769.jpg',
    'text': 'a photo of a dog | a cat | two cats with remote controls'
  },
  {
    headers: {
      'accept': 'application/json',
      'x-magicapi-key': 'API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

Javascript

fetch('https://api.magicapi.dev/api/v1/magicapi/objectdetector/objectdetector', {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'x-magicapi-key': 'API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    'image': 'https://replicate.delivery/mgxm/36b04aec-efe2-4dea-9c9d-a5faca68b2b2/000000039769.jpg',
    'text': 'a photo of a dog | a cat | two cats with remote controls'
  })
});

{
  "request_id": REQUEST_ID
}

Get the result

Curl

curl -X 'GET' \
  'https://api.magicapi.dev/api/v1/magicapi/objectdetector/predictions/REQUEST_ID' \
  -H 'accept: application/json' \
  -H 'x-magicapi-key: API_KEY'

Python

import requests

headers = {
    'accept': 'application/json',
    'x-magicapi-key': 'API_KEY',
}

response = requests.get('https://api.magicapi.dev/api/v1/magicapi/objectdetector/predictions/REQUEST_ID', headers=headers)

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.magicapi.dev/api/v1/magicapi/objectdetector/predictions/REQUEST_ID');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'accept: application/json',
    'x-magicapi-key: API_KEY',
]);

$response = curl_exec($ch);

curl_close($ch);

NodeJs

import axios from 'axios';

const response = await axios.get('https://api.magicapi.dev/api/v1/magicapi/objectdetector/predictions/REQUEST_ID', {
  headers: {
    'accept': 'application/json',
    'x-magicapi-key': 'API_KEY'
  }
});

Javascript

fetch('https://api.magicapi.dev/api/v1/magicapi/objectdetector/predictions/REQUEST_ID', {
  headers: {
    'accept': 'application/json',
    'x-magicapi-key': 'API_KEY'
  }
});

{
  "status": "succeeded",
  "result": [
    3.860912656250548e-8,
    0.0000025217079837602796,
    0.9999974966049194
  ]
}