Nucleus API Documentation

Comprehensive technical documentation for CPU, APU, GPU, NPU, and SoC specifications

C
CPUs
A
APUs
G
GPUs
N
NPUs
S
SoCs

Introduction

Nucleus API provides comprehensive hardware specifications for various processing units including CPUs, APUs, GPUs, NPUs, and SoCs. All data is provided in JSON format for easy integration into applications.

Our API is completely free and requires no authentication, with CORS support enabled for frontend applications.

Authentication

Currently, Nucleus API requires no authentication, and all endpoints are publicly accessible.

No Authentication Required

All endpoints can be accessed directly without any API keys or authentication tokens.

Rate Limiting

To ensure service stability, we enforce the following rate limits:

  • Per minute: 60 requests
  • Per hour: 1,000 requests

If you exceed these limits, you will receive a 429 Too Many Requests response.

Endpoints Overview

All endpoints follow the same base structure:

https://nucleus.api.qingyi-studio.top/{hardware_type}/{brand}/{model}

Supported Hardware Types

Hardware Type Path Example
Central Processing Unit /cpu /cpu/intel/i5-12500H
Accelerated Processing Unit /apu /apu/amd/A12-9800
Graphics Processing Unit /gpu /gpu/nvidia/rtx4090
Neural Processing Unit /npu /npu/apple/a16
System on Chip /soc /soc/qualcomm/snapdragon-8-gen2

CPU Endpoint

Retrieve detailed specifications for Central Processing Units (CPUs).

GET
https://nucleus.api.qingyi-studio.top/cpu/{brand}/{model}

Path Parameters

Parameter Type Description
brand string Manufacturer (e.g., intel, amd, apple)
model string CPU model (e.g., i5-12500H, R9-7950X, M1)

Response Example

{
  "name": "Intel Core i5-12500H",
  "codename": "Alder Lake-H",
  "architecture": "Hybrid (Performance-cores: Golden Cove / Efficient-cores: Gracemont)",
  "process_node": "Intel 7 (10 nm ESF)",
  "transistors": 17100000000,
  "die_size_mm2": 217,
  "socket": "FCBGA1744",
  "launch_date": "2022-01-04",
  "part_number": "FJ8071504827302",
  "launch_price_usd": 320,
  "cores": {
    "total": 12,
    "performance_cores": 4,
    "efficient_cores": 8,
    "threads": 16
  },
  "clock": {
    "base_p_core_ghz": 2.5,
    "base_e_core_ghz": 1.8,
    "max_boost_p_core_single_ghz": 4.5,
    "max_boost_p_core_all_ghz": 4.3,
    "max_boost_e_core_ghz": 3.3
  },
  "cache": {
    "l1_instruction_kb_per_p_core": 32,
    "l1_data_kb_per_p_core": 48,
    "l1_instruction_kb_per_e_core": 64,
    "l1_data_kb_per_e_core": 32,
    "l2_kb_per_p_core": 1280,
    "l2_kb_per_e_cluster": 2048,
    "l2_total_mb": 9.0,
    "l3_mb_total": 18
  }
}

APU Endpoint

Retrieve detailed specifications for Accelerated Processing Units (APUs).

GET
https://nucleus.api.qingyi-studio.top/apu/{brand}/{model}

Path Parameters

Parameter Type Description
brand string Manufacturer (currently only amd supported)
model string APU model (e.g., A12-9800, Ryzen-7-5700G)

Response Example

{
  "name": "AMD A12-9800",
  "codename": "Bristol Ridge",
  "architecture": "Excavator",
  "process_node": {
    "cpu_cores": "28nm",
    "io_die": "55nm"
  },
  "transistors": 3100000000,
  "die_size_mm2": 250,
  "package": "AM4",
  "launch_date": "2016-07-27",
  "part_number": "AD9800AUABBOX",
  "launch_price_usd": 99,
  "cores": {
    "total": 4,
    "performance_cores": 4,
    "efficient_cores": 0,
    "threads": 4
  },
  "clock": {
    "base_ghz": 3.8,
    "max_boost_ghz": 4.2
  },
  "integrated_graphics": {
    "name": "Radeon R7",
    "cores": 8,
    "base_freq_ghz": 1.108
  }
}

GPU Endpoint

Retrieve detailed specifications for Graphics Processing Units (GPUs).

GET
https://nucleus.api.qingyi-studio.top/gpu/{brand}/{model}

Path Parameters

Parameter Type Description
brand string Manufacturer (e.g., nvidia, amd, intel)
model string GPU model (e.g., rtx4090, rx7900xt, arc-a770)

Response Example

{
  "name": "NVIDIA GeForce RTX 4090",
  "architecture": "Ada Lovelace",
  "process_node": "TSMC 4N",
  "transistors": 76300000000,
  "die_size_mm2": 608.5,
  "base_clock_mhz": 2235,
  "boost_clock_mhz": 2520,
  "memory": {
    "type": "GDDR6X",
    "size_gb": 24,
    "bus_width_bit": 384,
    "speed_gbps": 21
  },
  "cuda_cores": 16384,
  "rt_cores": 128,
  "tensor_cores": 512,
  "tgp_w": 450,
  "features": [
    "DLSS 3",
    "NVIDIA Reflex",
    "AV1 Encoding"
  ]
}

NPU Endpoint

Retrieve detailed specifications for Neural Processing Units (NPUs).

GET
https://nucleus.api.qingyi-studio.top/npu/{brand}/{model}

Path Parameters

Parameter Type Description
brand string Manufacturer (e.g., apple, qualcomm, intel)
model string NPU model (e.g., a16, hexagon, movidius)

Response Example

{
  "name": "Apple Neural Engine (A16)",
  "architecture": "16-core",
  "process_node": "TSMC 4nm",
  "performance": "17 TOPS",
  "memory_bandwidth": "34.1 GB/s",
  "features": [
    "Real-time machine learning",
    "Camera processing",
    "Speech recognition",
    "Image processing"
  ],
  "applications": [
    "Face ID",
    "Siri",
    "Augmented Reality",
    "Computational Photography"
  ]
}

SoC Endpoint

Retrieve detailed specifications for Systems on Chip (SoCs).

GET
https://nucleus.api.qingyi-studio.top/soc/{brand}/{model}

Path Parameters

Parameter Type Description
brand string Manufacturer (e.g., qualcomm, apple, mediatek)
model string SoC model (e.g., snapdragon-8-gen2, a16-bionic, dimensity-9200)

Response Example

{
  "name": "Qualcomm Snapdragon 8 Gen 2",
  "codename": "SM8550-AB",
  "architecture": "1+4+3 (Cortex-X3, A715, A510)",
  "process_node": "TSMC 4nm",
  "transistors": "16.7 Billion",
  "cpu": {
    "prime_core": "1x Cortex-X3 @ 3.2 GHz",
    "performance_cores": "4x Cortex-A715 @ 2.8 GHz",
    "efficiency_cores": "3x Cortex-A510 @ 2.0 GHz"
  },
  "gpu": "Adreno 740",
  "dsp": "Hexagon",
  "ai_performance": "60 TOPS",
  "modem": "Snapdragon X70 5G",
  "memory_support": "LPDDR5X @ 4200 MHz",
  "storage_support": "UFS 4.0",
  "imaging": "Spectra ISP (200MP photo, 8K HDR video)"
}

Error Handling

All errors are returned in JSON format with error codes and descriptions.

Common Error Responses

HTTP Status Code Error Code Description
404 Not Found not_found Requested hardware information not found
500 Internal Server Error server_error Internal server error
400 Bad Request invalid_request Invalid request parameters
429 Too Many Requests rate_limit_exceeded Request rate limit exceeded

Error Response Example

{
  "error": {
    "code": "not_found",
    "message": "CPU information not found",
    "details": {
      "brand": "intel",
      "model": "i9-99999K"
    }
  }
}