Ultralytics HUB ์ถ๋ก API
Ultralytics HUB ์ถ๋ก API๋ฅผ ์ฌ์ฉํ๋ฉด Ultralytics YOLO ํ๊ฒฝ์ ๋ก์ปฌ์ ์ค์น ๋ฐ ์ค์ ํ ํ์ ์์ด REST API๋ฅผ ํตํด ์ถ๋ก ์ ์คํํ ์ ์์ต๋๋ค.
Watch: Ultralytics HUB ์ถ๋ก API ์ฐ์ต
Python
Python ์ ์ฌ์ฉํ์ฌ Ultralytics HUB ์ถ๋ก API์ ์ก์ธ์คํ๋ ค๋ฉด ๋ค์ ์ฝ๋๋ฅผ ์ฌ์ฉํฉ๋๋ค:
import requests
# API URL, use actual MODEL_ID
url = "https://api.ultralytics.com/v1/predict/MODEL_ID"
# Headers, use actual API_KEY
headers = {"x-api-key": "API_KEY"}
# Inference arguments (optional)
data = {"size": 640, "confidence": 0.25, "iou": 0.45}
# Load image and send request
with open("path/to/image.jpg", "rb") as image_file:
files = {"image": image_file}
response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())
์ฐธ๊ณ
๊ต์ฒด MODEL_ID
๋ฅผ ์ํ๋ ๋ชจ๋ธ ID์ ํจ๊ป ์
๋ ฅํฉ๋๋ค, API_KEY
์ค์ API ํค์ path/to/image.jpg
๋ฅผ ์ถ๋ก ์ ์คํํ๋ ค๋ ์ด๋ฏธ์ง์ ๊ฒฝ๋ก์ ํจ๊ป ์
๋ ฅํฉ๋๋ค.
cURL
cURL์ ์ฌ์ฉํ์ฌ Ultralytics HUB ์ถ๋ก API์ ์ก์ธ์คํ๋ ค๋ฉด ๋ค์ ์ฝ๋๋ฅผ ์ฌ์ฉํฉ๋๋ค:
curl -X POST "https://api.ultralytics.com/v1/predict/MODEL_ID" \
-H "x-api-key: API_KEY" \
-F "image=@/path/to/image.jpg" \
-F "size=640" \
-F "confidence=0.25" \
-F "iou=0.45"
์ฐธ๊ณ
๊ต์ฒด MODEL_ID
๋ฅผ ์ํ๋ ๋ชจ๋ธ ID์ ํจ๊ป ์
๋ ฅํฉ๋๋ค, API_KEY
์ค์ API ํค์ path/to/image.jpg
๋ฅผ ์ถ๋ก ์ ์คํํ๋ ค๋ ์ด๋ฏธ์ง์ ๊ฒฝ๋ก์ ํจ๊ป ์
๋ ฅํฉ๋๋ค.
์ธ์
์ฌ์ฉ ๊ฐ๋ฅํ ์ถ๋ก ์ธ์์ ์ ์ฒด ๋ชฉ๋ก์ ์๋ ํ๋ฅผ ์ฐธ์กฐํ์ธ์.
์ธ์ | ๊ธฐ๋ณธ๊ฐ | ์ ํ | ์ค๋ช |
---|---|---|---|
image |
image |
์ถ๋ก ์ ์ฌ์ฉํ ์ด๋ฏธ์ง ํ์ผ์ ๋๋ค. | |
url |
str |
ํ์ผ์ ์ ๋ฌํ์ง ์๋ ๊ฒฝ์ฐ ์ด๋ฏธ์ง์ URL์ ๋๋ค. | |
size |
640 |
int |
์
๋ ฅ ์ด๋ฏธ์ง์ ํฌ๊ธฐ, ์ ํจํ ๋ฒ์๋ 32 - 1280 ํฝ์
. |
confidence |
0.25 |
float |
์์ธก์ ๋ํ ์ ๋ขฐ๋ ์๊ณ๊ฐ, ์ ํจ ๋ฒ์ 0.01 - 1.0 . |
iou |
0.45 |
float |
IoU(Union) ์๊ณ๊ฐ์ ์ด๊ณผํ๋ ๊ต์ฐจ์ , ์ ํจํ ๋ฒ์ 0.0 - 0.95 . |
์๋ต
Ultralytics HUB ์ถ๋ก API๋ JSON ์๋ต์ ๋ฐํํฉ๋๋ค.
๋ถ๋ฅ
๋ถ๋ฅ ๋ชจ๋ธ
import requests
# API URL, use actual MODEL_ID
url = "https://api.ultralytics.com/v1/predict/MODEL_ID"
# Headers, use actual API_KEY
headers = {"x-api-key": "API_KEY"}
# Inference arguments (optional)
data = {"size": 640, "confidence": 0.25, "iou": 0.45}
# Load image and send request
with open("path/to/image.jpg", "rb") as image_file:
files = {"image": image_file}
response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())
ํ์ง
ํ์ง ๋ชจ๋ธ
import requests
# API URL, use actual MODEL_ID
url = "https://api.ultralytics.com/v1/predict/MODEL_ID"
# Headers, use actual API_KEY
headers = {"x-api-key": "API_KEY"}
# Inference arguments (optional)
data = {"size": 640, "confidence": 0.25, "iou": 0.45}
# Load image and send request
with open("path/to/image.jpg", "rb") as image_file:
files = {"image": image_file}
response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())
OBB
OBB ๋ชจ๋ธ
import requests
# API URL, use actual MODEL_ID
url = "https://api.ultralytics.com/v1/predict/MODEL_ID"
# Headers, use actual API_KEY
headers = {"x-api-key": "API_KEY"}
# Inference arguments (optional)
data = {"size": 640, "confidence": 0.25, "iou": 0.45}
# Load image and send request
with open("path/to/image.jpg", "rb") as image_file:
files = {"image": image_file}
response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())
์ธ๋ถํ
์ธ๋ถํ ๋ชจ๋ธ
import requests
# API URL, use actual MODEL_ID
url = "https://api.ultralytics.com/v1/predict/MODEL_ID"
# Headers, use actual API_KEY
headers = {"x-api-key": "API_KEY"}
# Inference arguments (optional)
data = {"size": 640, "confidence": 0.25, "iou": 0.45}
# Load image and send request
with open("path/to/image.jpg", "rb") as image_file:
files = {"image": image_file}
response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())
ํฌ์ฆ
ํฌ์ฆ ๋ชจ๋ธ
import requests
# API URL, use actual MODEL_ID
url = "https://api.ultralytics.com/v1/predict/MODEL_ID"
# Headers, use actual API_KEY
headers = {"x-api-key": "API_KEY"}
# Inference arguments (optional)
data = {"size": 640, "confidence": 0.25, "iou": 0.45}
# Load image and send request
with open("path/to/image.jpg", "rb") as image_file:
files = {"image": image_file}
response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())
์์ฑ 2024-01-23, ์ ๋ฐ์ดํธ 2024-06-22
์์ฑ์: glenn-jocher (9), sergiuwaxmann (2), RizwanMunawar (1), priytosh-tripathi (1)