مرجع REST API

Authorization: Bearer ul_your_api_key_here

https://platform.ultralytics.com/api

Retry-After: 12
X-RateLimit-Reset: 2026-02-21T12:34:56.000Z

{
    "datasets": [...],
    "total": 100
}

{
    "error": "Invalid dataset ID"
}

GET /api/datasets

{
    "datasets": [
        {
            "_id": "dataset_abc123",
            "name": "my-dataset",
            "slug": "my-dataset",
            "task": "detect",
            "imageCount": 1000,
            "classCount": 10,
            "classNames": ["person", "car"],
            "visibility": "private",
            "username": "johndoe",
            "starCount": 3,
            "isStarred": false,
            "sampleImages": [
                {
                    "url": "https://storage.example.com/...",
                    "width": 1920,
                    "height": 1080,
                    "labels": [{ "classId": 0, "bbox": [0.5, 0.4, 0.3, 0.6] }]
                }
            ],
            "createdAt": "2024-01-15T10:00:00Z",
            "updatedAt": "2024-01-16T08:30:00Z"
        }
    ],
    "total": 1,
    "region": "us"
}

GET /api/datasets/{datasetId}

POST /api/datasets

{
    "slug": "my-dataset",
    "name": "My Dataset",
    "task": "detect",
    "description": "A custom detection dataset",
    "visibility": "private",
    "classNames": ["person", "car"]
}

PATCH /api/datasets/{datasetId}

{
    "name": "Updated Name",
    "description": "New description",
    "visibility": "public"
}

DELETE /api/datasets/{datasetId}

POST /api/datasets/{datasetId}/clone

{
    "name": "cloned-dataset",
    "description": "My cloned dataset",
    "visibility": "private",
    "owner": "team-username"
}

GET /api/datasets/{datasetId}/export

{
    "downloadUrl": "https://storage.example.com/export.ndjson?signed=...",
    "cached": true
}

GET /api/datasets/{datasetId}/class-stats

{
    "classes": [{ "classId": 0, "count": 1500, "imageCount": 450 }],
    "imageStats": {
        "widthHistogram": [{ "bin": 640, "count": 120 }],
        "heightHistogram": [{ "bin": 480, "count": 95 }],
        "pointsHistogram": [{ "bin": 4, "count": 200 }]
    },
    "locationHeatmap": {
        "bins": [
            [5, 10],
            [8, 3]
        ],
        "maxCount": 50
    },
    "dimensionHeatmap": {
        "bins": [
            [2, 5],
            [3, 1]
        ],
        "maxCount": 12,
        "minWidth": 10,
        "maxWidth": 1920,
        "minHeight": 10,
        "maxHeight": 1080
    },
    "classNames": ["person", "car", "dog"],
    "cached": true,
    "sampled": false,
    "sampleSize": 1000
}

GET /api/datasets/{datasetId}/models

{
    "models": [
        {
            "_id": "model_abc123",
            "name": "experiment-1",
            "slug": "experiment-1",
            "status": "completed",
            "task": "detect",
            "epochs": 100,
            "bestEpoch": 87,
            "projectId": "project_xyz",
            "projectSlug": "my-project",
            "projectIconColor": "#3b82f6",
            "projectIconLetter": "M",
            "username": "johndoe",
            "startedAt": "2024-01-14T22:00:00Z",
            "completedAt": "2024-01-15T10:00:00Z",
            "createdAt": "2024-01-14T21:55:00Z",
            "metrics": {
                "mAP50": 0.85,
                "mAP50-95": 0.72,
                "precision": 0.88,
                "recall": 0.81
            }
        }
    ],
    "count": 1
}

POST /api/datasets/{datasetId}/predict

POST /api/datasets/ingest

GET /api/datasets/{datasetId}/images

POST /api/datasets/{datasetId}/images/urls

DELETE /api/datasets/{datasetId}/images/{hash}

GET /api/datasets/{datasetId}/images/{hash}/labels

PUT /api/datasets/{datasetId}/images/{hash}/labels

{
    "labels": [{ "classId": 0, "bbox": [0.5, 0.5, 0.2, 0.3] }]
}

PATCH /api/datasets/{datasetId}/images/bulk

DELETE /api/datasets/{datasetId}/images/bulk

GET /api/projects

GET /api/projects/{projectId}

POST /api/projects

PATCH /api/projects/{projectId}

DELETE /api/projects/{projectId}

POST /api/projects/{projectId}/clone

POST /api/projects/{projectId}/icon

DELETE /api/projects/{projectId}/icon

GET /api/models

GET /api/models/completed

GET /api/models/{modelId}

POST /api/models

PATCH /api/models/{modelId}

DELETE /api/models/{modelId}

GET /api/models/{modelId}/files

POST /api/models/{modelId}/clone

{
    "targetProjectSlug": "my-project",
    "modelName": "cloned-model",
    "description": "Cloned from public model",
    "owner": "team-username"
}

POST /api/models/{modelId}/track-download

POST /api/models/{modelId}/predict

{
    "images": [
        {
            "shape": [1080, 1920],
            "results": [
                {
                    "class": 0,
                    "name": "person",
                    "confidence": 0.92,
                    "box": { "x1": 100, "y1": 50, "x2": 300, "y2": 400 }
                }
            ]
        }
    ],
    "metadata": {
        "imageCount": 1
    }
}

POST /api/models/{modelId}/predict/token

POST /api/models/{modelId}/predict/warmup

POST /api/training/start

GET /api/models/{modelId}/training

DELETE /api/models/{modelId}/training

GET /api/deployments

POST /api/deployments

{
    "modelId": "model_abc123",
    "name": "my-deployment",
    "region": "us-central1",
    "resources": {
        "cpu": 1,
        "memoryGi": 2,
        "minInstances": 0,
        "maxInstances": 1
    }
}

GET /api/deployments/{deploymentId}

DELETE /api/deployments/{deploymentId}

POST /api/deployments/{deploymentId}/start

POST /api/deployments/{deploymentId}/stop

GET /api/deployments/{deploymentId}/health

POST /api/deployments/{deploymentId}/predict

GET /api/deployments/{deploymentId}/metrics

GET /api/deployments/{deploymentId}/logs

GET /api/monitoring

GET /api/exports

POST /api/exports

GET /api/exports/{exportId}

DELETE /api/exports/{exportId}

POST /api/exports/{exportId}/track-download

GET /api/activity

POST /api/activity/mark-seen

{
    "all": true
}

{
    "eventIds": ["EVENT_ID_1", "EVENT_ID_2"]
}

POST /api/activity/archive

{
    "all": true,
    "archive": true
}

{
    "eventIds": ["EVENT_ID_1", "EVENT_ID_2"],
    "archive": false
}

GET /api/trash

POST /api/trash

{
    "id": "item_abc123",
    "type": "dataset"
}

DELETE /api/trash

{
    "id": "item_abc123",
    "type": "dataset"
}

DELETE /api/trash/empty

GET /api/billing/balance

{
    "creditsCents": 2500,
    "plan": "free",
    "cashBalance": 25,
    "creditBalance": 0,
    "reservedAmount": 0,
    "totalBalance": 25
}

GET /api/billing/usage-summary

GET /api/billing/transactions

POST /api/billing/checkout-session

{
    "amount": 25,
    "owner": "team-username"
}

POST /api/billing/subscription-checkout

{
    "planId": "pro",
    "billingCycle": "monthly",
    "owner": "team-username"
}

POST /api/billing/portal-session

GET /api/billing/auto-topup

PATCH /api/billing/auto-topup

{
    "enabled": true,
    "thresholdCents": 500,
    "amountCents": 2500
}

GET /api/billing/payment-methods

POST /api/billing/payment-methods/setup

POST /api/billing/payment-methods/default

{
    "paymentMethodId": "pm_123"
}

PATCH /api/billing/payment-methods

{
    "name": "Jane Doe",
    "address": {
        "line1": "123 Main St",
        "city": "San Francisco",
        "state": "CA",
        "postal_code": "94105",
        "country": "US"
    }
}

DELETE /api/billing/payment-methods/{id}

GET /api/storage

{
    "tier": "free",
    "usage": {
        "storage": {
            "current": 1073741824,
            "limit": 107374182400,
            "percent": 1.0
        }
    },
    "region": "us",
    "username": "johndoe",
    "updatedAt": "2024-01-15T10:00:00Z",
    "breakdown": {
        "byCategory": {
            "datasets": { "bytes": 536870912, "count": 2 },
            "models": { "bytes": 268435456, "count": 4 },
            "exports": { "bytes": 268435456, "count": 3 }
        },
        "topItems": [
            {
                "_id": "dataset_abc123",
                "name": "my-dataset",
                "slug": "my-dataset",
                "sizeBytes": 536870912,
                "type": "dataset"
            },
            {
                "_id": "model_def456",
                "name": "experiment-1",
                "slug": "experiment-1",
                "sizeBytes": 134217728,
                "type": "model",
                "parentName": "My Project",
                "parentSlug": "my-project"
            }
        ]
    }
}

POST /api/storage

POST /api/upload/signed-url

{
    "assetType": "images",
    "assetId": "abc123",
    "filename": "my-image.jpg",
    "contentType": "image/jpeg",
    "totalBytes": 5242880
}

{
    "sessionId": "session_abc123",
    "uploadUrl": "https://storage.example.com/...",
    "objectPath": "images/abc123/my-image.jpg",
    "downloadUrl": "https://cdn.example.com/...",
    "expiresAt": "2026-02-22T12:00:00Z"
}

POST /api/upload/complete

{
    "datasetId": "abc123",
    "objectPath": "datasets/abc123/images/my-image.jpg",
    "filename": "my-image.jpg",
    "contentType": "image/jpeg",
    "size": 5242880
}

GET /api/api-keys

POST /api/api-keys

{
    "name": "training-server"
}

DELETE /api/api-keys

curl -X DELETE \
  -H "Authorization: Bearer $API_KEY" \
  "https://platform.ultralytics.com/api/api-keys?keyId=KEY_ID"

GET /api/teams

POST /api/teams/create

{
    "username": "my-team",
    "fullName": "My Team"
}

GET /api/members

POST /api/members

{
    "email": "user@example.com",
    "role": "editor"
}

PATCH /api/members/{userId}

DELETE /api/members/{userId}

POST /api/members/transfer-ownership

POST /api/invites/accept

GET /api/invites/info

DELETE /api/invites/{inviteId}

POST /api/invites/{inviteId}/resend

GET /api/explore/search

GET /api/explore/sidebar

GET /api/users

PATCH /api/users

{
    "username": "target-user",
    "followed": true
}

GET /api/username/check

GET /api/settings
POST /api/settings

POST /api/settings/icon
DELETE /api/settings/icon

POST /api/onboarding

GET /api/gdpr

POST /api/gdpr

{
    "action": "export"
}

{
    "action": "delete",
    "confirmationWord": "DELETE"
}

{
    "action": "delete",
    "confirmationWord": "DELETE",
    "teamUsername": "my-team"
}

pip install ultralytics

yolo check

from ultralytics import YOLO

model = YOLO("yolo11n.pt")

# Train on your Platform dataset
model.train(
    data="ul://your-username/your-dataset",
    epochs=100,
    imgsz=640,
)

from ultralytics import YOLO

model = YOLO("yolo11n.pt")

# Results automatically sync to Platform
model.train(
    data="coco8.yaml",
    epochs=100,
    project="ul://your-username/my-project",
    name="experiment-1",
)

# Your own model
model = YOLO("ul://username/project/model-name")

# Official model
model = YOLO("ul://ultralytics/yolo26/yolo26n")

results = model("image.jpg")

# Access results
for r in results:
    boxes = r.boxes  # Detection boxes
    masks = r.masks  # Segmentation masks
    keypoints = r.keypoints  # Pose keypoints
    probs = r.probs  # Classification probabilities

# Export to ONNX
model.export(format="onnx", imgsz=640, half=True)

# Export to TensorRT
model.export(format="engine", imgsz=640, half=True)

# Export to CoreML
model.export(format="coreml", imgsz=640)

metrics = model.val(data="ul://username/my-dataset")

print(f"mAP50: {metrics.box.map50}")
print(f"mAP50-95: {metrics.box.map}")

curl -H "Authorization: Bearer $API_KEY" \
  "https://platform.ultralytics.com/api/datasets?limit=50"

curl -H "Authorization: Bearer $API_KEY" \
  "https://platform.ultralytics.com/api/activity?page=2&limit=20"

curl "https://platform.ultralytics.com/api/explore/search?type=datasets&offset=20&sort=stars"

import time

import requests


def api_request_with_retry(url, headers, max_retries=3):
    for attempt in range(max_retries):
        response = requests.get(url, headers=headers)
        if response.status_code != 429:
            return response
        wait = int(response.headers.get("Retry-After", 2**attempt))
        time.sleep(wait)
    raise Exception("Rate limit exceeded")

https://platform.ultralytics.com/username/project/model-name
                                  ^^^^^^^^ ^^^^^^^ ^^^^^^^^^^
                                  username project   model