JADE REALMS / Documentación para desarrolladores

Referencia REST API

Los metadatos públicos y modelos individuales gratuitos no requieren cuenta ni clave. Los archivos de pago mantienen la comprobación de compra del sitio.

v1.0.0Solo lectura · sin clave APIOpenAPI JSON ↗

Inicio rápido

Buscar → consultar → descargar

cURL

curl --fail 'https://3dmodelhub.io/api/v1/models?q=pine&limit=2&locale=es'

JavaScript

const response = await fetch("https://3dmodelhub.io/api/v1/models?q=pine&limit=2&locale=es", {
  credentials: 'omit',
  headers: { Accept: 'application/json' }
});
const body = await response.json();
if (!response.ok) throw new Error(body.error?.code || response.status);
console.log(body.data);

Python

import json
from urllib.request import urlopen

with urlopen("https://3dmodelhub.io/api/v1/models?q=pine&limit=2&locale=es") as response:
    body = json.load(response)
print(body['data'])

Ejemplos generados con el catálogo actual. Las cantidades, precios e identificadores pueden cambiar.

Autenticación y acceso

Los metadatos públicos y modelos individuales gratuitos no requieren cuenta ni clave. Los archivos de pago mantienen la comprobación de compra del sitio.

Base URL: https://3dmodelhub.io/api/v1
API version: 1.0.0
Idiomas: en · zh · ja · ko · es · de · fr

GET/HEAD leen y OPTIONS gestiona CORS. En el navegador usa credentials: omit. Parámetros desconocidos, duplicados o inválidos devuelven 400.

Los metadatos comparten un límite al mejor esfuerzo de 120 peticiones por minuto e IP en cada ubicación Cloudflare; no es una cuota de archivos gratuitos.

Solo devuelve datos publicados. Lo desconocido es null; las verificaciones corresponden al hash GLB registrado y no certifican rendimiento.

GET/api/v1/site

Información del sitio

Read published categories, styles, languages and counts. Catalog entries are not necessarily independent models; read the scope notes.

jaderealms_get_site_info

Parámetros	Obligatorio	Valor inicial	Valores permitidos	Descripción
`locale`query · string	Opcional	`"en"`	en · zh · ja · ko · es · de · fr	Idioma.

cURL

curl --fail 'https://3dmodelhub.io/api/v1/site?locale=es'

JavaScript

const response = await fetch("https://3dmodelhub.io/api/v1/site?locale=es", {
  credentials: 'omit',
  headers: { Accept: 'application/json' }
});
const body = await response.json();
if (!response.ok) throw new Error(body.error?.code || response.status);
console.log(body.data);

Python

import json
from urllib.request import urlopen

with urlopen("https://3dmodelhub.io/api/v1/site?locale=es") as response:
    body = json.load(response)
print(body['data'])

Ejemplo de respuesta · HTTP 200

Ejemplos generados con el catálogo actual. Las cantidades, precios e identificadores pueden cambiar.

JSON

{
  "locale": "es",
  "data": {
    "name": "JadeRealms",
    "origin": "https://3dmodelhub.io",
    "languages": [
      {
        "code": "en",
        "tag": "en",
        "label": "English"
      },
      {
        "code": "zh",
        "tag": "zh-CN",
        "label": "中文"
      },
      {
        "code": "ja",
        "tag": "ja",
        "label": "日本語"
      },
      {
        "code": "ko",
        "tag": "ko",
        "label": "한국어"
      },
      {
        "code": "es",
        "tag": "es",
        "label": "Español"
      },
      {
        "code": "de",
        "tag": "de",
        "label": "Deutsch"
      },
      {
        "code": "fr",
        "tag": "fr",
        "label": "Français"
      }
    ],
    "catalog": {
      "verified_entries": 252,
      "scope_verified_entries": 252,
      "scope_pending_entries": 0,
      "historical_entries": 251,
      "separate_modules": 1,
      "verified_atomic_model_total": null,
      "verified_scene_packs": 4,
      "count_note": "Catalog entries may be scenes, kits or entries of unverified scope. A parent scene and an extracted module are not counted as independent designs twice."
    },
    "categories": [
      {
        "id": "terrain",
        "name": "Rocas y terreno",
        "count": 29
      },
      {
        "id": "vegetation",
        "name": "Árboles y plantas",
        "count": 18
      },
      {
        "id": "architecture",
        "name": "Edificios y arquitectura",
        "count": 71
      },
      {
        "id": "creatures",
        "name": "Criaturas y animales",
        "count": 30
      },
      {
        "id": "props",
        "name": "Objetos y accesorios",
        "count": 96
      },
      {
        "id": "environment",
        "name": "Elementos de entorno",
        "count": 8
      }
    ],
    "styles": [
      {
        "id": "ancient",
        "name": "Estilo antiguo",
        "count": 72
      },
      {
        "id": "fantasy",
        "name": "Fantasía",
        "count": 64
      },
      {
        "id": "scifi",
        "name": "Ciencia ficción",
        "count": 22
      },
      {
        "id": "modern",
        "name": "Estilo moderno",
        "count": 23
      },
      {
        "id": "toon",
        "name": "Estilo de dibujos animados",
        "count": 78
      },
      {
        "id": "anime",
        "name": "Anime y JRPG",
        "count": 43
      }
    ],
    "access": {
      "free_model_login_required": false,
      "paid_pack_login_required": true,
      "paid_pack_purchase_required": true,
      "private_account_data_exposed": false
    },
    "links": {
      "home": "https://3dmodelhub.io/es/",
      "models": "https://3dmodelhub.io/es/models/",
      "kits": "https://3dmodelhub.io/es/kits/",
      "guide": "https://3dmodelhub.io/es/guide/",
      "license": "https://3dmodelhub.io/es/license/"
    }
  },
  "meta": {
    "api_version": "1.0.0",
    "request_id": "b99e74e8-9129-40b5-8469-c3b37c36dedf"
  }
}

GET/api/v1/models

Buscar modelos

Filter by keyword and structured conditions. Default order is featured first, then ID; use offset for pagination. Read /site for category and style values.

jaderealms_search_models

Parámetros	Obligatorio	Valor inicial	Valores permitidos	Descripción
`q`query · string	Opcional	`""`	≤ 120	Coincidencia de palabras en nombres y descripciones; no búsqueda semántica.
`category`query · string	Opcional	`—`	terrain · vegetation · architecture · creatures · props · environment	Categoría.
`style`query · string	Opcional	`—`	ancient · fantasy · scifi · modern · toon · anime	Estilo.
`tested_engine`query · string	Opcional	`—`	godot · unity · unreal	Verificación de importación con hash GLB coincidente.
`max_triangles`query · integer	Opcional	`—`	1–100000000	Máximo de triángulos.
`limit`query · integer	Opcional	`8`	1–20	Filas por página.
`offset`query · integer	Opcional	`0`	0–10000	Posición inicial.
`locale`query · string	Opcional	`"en"`	en · zh · ja · ko · es · de · fr	Idioma.

cURL

curl --fail 'https://3dmodelhub.io/api/v1/models?q=pine&limit=2&locale=es'

JavaScript

const response = await fetch("https://3dmodelhub.io/api/v1/models?q=pine&limit=2&locale=es", {
  credentials: 'omit',
  headers: { Accept: 'application/json' }
});
const body = await response.json();
if (!response.ok) throw new Error(body.error?.code || response.status);
console.log(body.data);

Python

import json
from urllib.request import urlopen

with urlopen("https://3dmodelhub.io/api/v1/models?q=pine&limit=2&locale=es") as response:
    body = json.load(response)
print(body['data'])

Ejemplo de respuesta · HTTP 200

Ejemplos generados con el catálogo actual. Las cantidades, precios e identificadores pueden cambiar.

JSON

{
  "locale": "es",
  "data": [
    {
      "id": "ancient_pine",
      "name": "Pino antiguo",
      "name_en": "Ancient Pine",
      "category": "vegetation",
      "category_name": "Árboles y plantas",
      "styles": [
        "ancient",
        "fantasy"
      ],
      "triangles": 135682,
      "default_glb_bytes": 19271052,
      "static": true,
      "scope": {
        "type": "independent_functional_object",
        "status": "verified",
        "checked_on": "2026-10-22",
        "evidence": "verified_actual_glb_and_three_view_classification",
        "parent_id": null,
        "historical_count_increment": 1
      },
      "tested_engines": [
        "godot",
        "unity"
      ],
      "detail_url": "https://3dmodelhub.io/es/models/ancient_pine/",
      "poster_url": "https://3dmodelhub.io/media/ancient_pine-1280.jpg"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 2,
    "offset": 0,
    "next_offset": null
  },
  "sort": "featured_then_id",
  "meta": {
    "api_version": "1.0.0",
    "request_id": "0916190f-9784-4640-962f-9f6edc96d658"
  }
}

GET/api/v1/models/{id}

Detalle del modelo

Use an exact ID from search to get files, materials, animations, dimensions and hash-matched engine checks.

jaderealms_get_model_details

Parámetros	Obligatorio	Valor inicial	Valores permitidos	Descripción
`id`path · string	Obligatorio	`—`	^[A-Za-z0-9_-]+$ · 1–100	ID exacto de la lista.
`locale`query · string	Opcional	`"en"`	en · zh · ja · ko · es · de · fr	Idioma.

cURL

curl --fail 'https://3dmodelhub.io/api/v1/models/ancient_pine?locale=es'

JavaScript

const response = await fetch("https://3dmodelhub.io/api/v1/models/ancient_pine?locale=es", {
  credentials: 'omit',
  headers: { Accept: 'application/json' }
});
const body = await response.json();
if (!response.ok) throw new Error(body.error?.code || response.status);
console.log(body.data);

Python

import json
from urllib.request import urlopen

with urlopen("https://3dmodelhub.io/api/v1/models/ancient_pine?locale=es") as response:
    body = json.load(response)
print(body['data'])

Ejemplo de respuesta · HTTP 200

Ejemplos generados con el catálogo actual. Las cantidades, precios e identificadores pueden cambiar.

JSON

{
  "locale": "es",
  "data": {
    "id": "ancient_pine",
    "name": "Pino antiguo",
    "name_en": "Ancient Pine",
    "category": "vegetation",
    "category_name": "Árboles y plantas",
    "styles": [
      "ancient",
      "fantasy"
    ],
    "triangles": 135682,
    "default_glb_bytes": 19271052,
    "static": true,
    "scope": {
      "type": "independent_functional_object",
      "status": "verified",
      "checked_on": "2026-10-22",
      "evidence": "verified_actual_glb_and_three_view_classification",
      "parent_id": null,
      "historical_count_increment": 1
    },
    "tested_engines": [
      "godot",
      "unity"
    ],
    "detail_url": "https://3dmodelhub.io/es/models/ancient_pine/",
    "poster_url": "https://3dmodelhub.io/media/ancient_pine-1280.jpg",
    "version": "Ancient_Pine_Runtime_v1",
    "materials": 5,
    "textures": 8,
    "available_formats": [
      "GLB",
      "Blender"
    ],
    "rigged": false,
    "animation_count": 0,
    "dimensions_m_y_up": null,
    "download": {
      "login_required": false,
      "purchase_required": false,
      "recommended": "complete_model_zip",
      "files": [
        {
          "format": "GLB",
          "purpose": "Direct default model with embedded materials",
          "filename": "ancient_pine_LOD1.glb",
          "bytes": 19271052,
          "sha256": "2301433ad1795a0bff44b55d65f6ad81e2f94c5e3f15fa0eb7dcdc38a8bb6bbb",
          "url": "https://3dmodelhub.io/download/ancient_pine/model-0/"
        },
        {
          "format": "ZIP",
          "purpose": "Complete files for this model, including Blender sources and textures",
          "filename": "ancient_pine_complete.zip",
          "bytes": 41762903,
          "sha256": "1529b0170d56bab328c6bf7688009b0359fd390b5491b2a4689b7c9c9125a631",
          "url": "https://3dmodelhub.io/download/ancient_pine/package/"
        }
      ]
    },
    "validation": {
      "source_glb_sha256": "2301433ad1795a0bff44b55d65f6ad81e2f94c5e3f15fa0eb7dcdc38a8bb6bbb",
      "checks": [
        {
          "engine": "godot",
          "version": "4.7.2",
          "status": "passed",
          "adaptations": [],
          "verified_on": "2026-10-19",
          "scope": "desktop_import_materials_static_render",
          "report_sha256": "56ab80f9590d2708d689fe6fa1f446c19f3a39e9b71b3013ea3737f35c6ade2a"
        },
        {
          "importer": "com.unity.cloud.gltfast 6.14.1",
          "engine": "unity",
          "version": "6000.6.6f1",
          "status": "passed",
          "adaptations": [],
          "verified_on": "2026-10-19",
          "scope": "desktop_import_materials_static_render",
          "report_sha256": "a3034b63e1d70b6970ef6aca228012fc8b76765f2cdaa7c828735f1f46d9c3f4"
        }
      ],
      "limitations": "Pruebas estáticas del GLB predeterminado actual. Sin certificación de rendimiento, rig, animación, colisiones de modelos ni LOD automático.",
      "unreal": "Unreal Engine: sin verificar"
    },
    "license": {
      "url": "https://3dmodelhub.io/es/license/",
      "commercial_games_and_animation": true,
      "cc0_foundation_exception": false
    }
  },
  "meta": {
    "api_version": "1.0.0",
    "request_id": "533d0278-0a6e-4a6b-94f9-1ddd93af4bab"
  }
}

GET/api/v1/kits

Packs de escenas

Read public scene packs, current public prices and delivery summaries. Personal ownership is not queried.

jaderealms_list_scene_kits

Parámetros	Obligatorio	Valor inicial	Valores permitidos	Descripción
`locale`query · string	Opcional	`"en"`	en · zh · ja · ko · es · de · fr	Idioma.

cURL

curl --fail 'https://3dmodelhub.io/api/v1/kits?locale=es'

JavaScript

const response = await fetch("https://3dmodelhub.io/api/v1/kits?locale=es", {
  credentials: 'omit',
  headers: { Accept: 'application/json' }
});
const body = await response.json();
if (!response.ok) throw new Error(body.error?.code || response.status);
console.log(body.data);

Python

import json
from urllib.request import urlopen

with urlopen("https://3dmodelhub.io/api/v1/kits?locale=es") as response:
    body = json.load(response)
print(body['data'])

Ejemplo de respuesta · HTTP 200

Ejemplos generados con el catálogo actual. Las cantidades, precios e identificadores pueden cambiar.

JSON

{
  "locale": "es",
  "data": [
    {
      "id": "meteor-ancient-town",
      "name": "Villa Meteor · Calle del Té",
      "summary": "Explora modelos originales junto a un canal, un puente de piedra y casas de té. Cambia de cámara e iluminación.",
      "version": "v02",
      "access": "paid_one_time",
      "login_required": true,
      "ownership": "not_queried",
      "availability": "on_sale",
      "price": {
        "amount_minor": 799,
        "currency": "usd",
        "phase": "intro",
        "policy": "intro_then_standard",
        "intro_amount_minor": 799,
        "standard_amount_minor": 999,
        "launch_at": "2026-10-21T16:03:49.190Z",
        "intro_ends_at": "2026-11-20T16:03:49.190Z",
        "checkout_enabled": true,
        "mode": "live"
      },
      "contents": {
        "source_catalog": "models",
        "model_count": 9,
        "instance_count": 41,
        "counts_note": "Instances, LOD files and collision proxies are not additional independent models.",
        "source_model_ids": [
          "tea_house",
          "moon_gate",
          "arched_stone_bridge",
          "crimson_maple",
          "weeping_willow",
          "stone_lantern",
          "courtyard_wall_corner",
          "open_tea_pavilion",
          "bamboo_stand"
        ],
        "source_model_access": "free_catalog"
      },
      "delivery": {
        "filename": "Meteor_Ancient_Town_Complete_v02.zip",
        "bytes": 876519048,
        "format": "ZIP",
        "download_ready": true,
        "access_note": "Sign in, purchase this pack, and use the download button on its original page. This response does not grant access."
      },
      "validation": {
        "details_url": "https://3dmodelhub.io/es/kits/meteor-ancient-town/",
        "checks": [],
        "limitations": [
          "Engine checks differ between scene packs. Consult this pack detail page; checks on individual source models do not certify whole-scene performance."
        ]
      },
      "detail_url": "https://3dmodelhub.io/es/kits/meteor-ancient-town/",
      "preview_url": "https://3dmodelhub.io/preview/meteor-ancient-town/?lang=es",
      "license_url": "https://3dmodelhub.io/es/license/"
    },
    {
      "id": "moonlit-bamboo",
      "name": "Puerta lunar y bambú",
      "summary": "Un patio tranquilo con bambú, faroles de piedra y una puerta lunar. Explora los modelos originales, cambia la luz y acércate a los detalles.",
      "version": "v02",
      "access": "paid_one_time",
      "login_required": true,
      "ownership": "not_queried",
      "availability": "on_sale",
      "price": {
        "amount_minor": 399,
        "currency": "usd",
        "phase": "intro",
        "policy": "intro_then_standard",
        "intro_amount_minor": 399,
        "standard_amount_minor": 599,
        "launch_at": "2026-10-21T16:03:49.190Z",
        "intro_ends_at": "2026-11-20T16:03:49.190Z",
        "checkout_enabled": true,
        "mode": "live"
      },
      "contents": {
        "source_catalog": "models",
        "model_count": 4,
        "instance_count": 7,
        "counts_note": "Instances, LOD files and collision proxies are not additional independent models.",
        "source_model_ids": [
          "moon_gate",
          "stone_lantern",
          "bamboo_stand",
          "moss_boulders"
        ],
        "source_model_access": "free_catalog"
      },
      "delivery": {
        "filename": "Moonlit_Bamboo_Complete_v02.zip",
        "bytes": 234657922,
        "format": "ZIP",
        "download_ready": true,
        "access_note": "Sign in, purchase this pack, and use the download button on its original page. This response does not grant access."
      },
      "validation": {
        "details_url": "https://3dmodelhub.io/es/scenes/moonlit-bamboo/",
        "checks": [],
        "limitations": [
          "Engine checks differ between scene packs. Consult this pack detail page; checks on individual source models do not certify whole-scene performance."
        ]
      },
      "detail_url": "https://3dmodelhub.io/es/scenes/moonlit-bamboo/",
      "preview_url": "https://3dmodelhub.io/es/scenes/moonlit-bamboo/#preview",
      "license_url": "https://3dmodelhub.io/es/license/"
    },
    {
      "id": "sunward-modern-town",
      "name": "Sunward Villa Moderna",
      "summary": "Una villa luminosa de fachadas crema, comercios turquesa y calles conectadas. Tiendas, viviendas y espacios públicos para crear entornos de juego.",
      "version": "v02",
      "access": "paid_one_time",
      "login_required": true,
      "ownership": "not_queried",
      "availability": "on_sale",
      "price": {
        "amount_minor": 799,
        "currency": "usd",
        "phase": "fixed",
        "policy": "fixed",
        "intro_amount_minor": 799,
        "standard_amount_minor": 799,
        "launch_at": "2026-10-21T16:03:49.190Z",
        "intro_ends_at": null,
        "checkout_enabled": true,
        "mode": "live"
      },
      "contents": {
        "source_catalog": "sunward",
        "model_count": 72,
        "instance_count": 128,
        "counts_note": "Instances, LOD files and collision proxies are not additional independent models.",
        "source_model_ids": [
          "balcony_platform",
          "balcony_railing",
          "column",
          "corner_external",
          "corner_internal",
          "cornice",
          "exterior_stair",
          "foundation_step",
          "parapet_corner",
          "parapet_straight",
          "porch_canopy",
          "roof_flat",
          "roof_hvac",
          "roof_pitched_end",
          "roof_pitched_middle",
          "shop_awning",
          "solar_rack",
          "wall_entry",
          "wall_shop_entry",
          "wall_shop_window",
          "wall_solid",
          "wall_window",
          "crosswalk_marking",
          "curb_ramp",
          "drain_channel",
          "parking_marking",
          "plaza_paving",
          "road_cross_junction",
          "road_curve",
          "road_straight",
          "road_t_junction",
          "sidewalk_external_corner",
          "sidewalk_internal_corner",
          "sidewalk_straight",
          "bollard",
          "direction_sign",
          "fire_hydrant",
          "fountain",
          "menu_board",
          "planter",
          "shop_hanging_sign",
          "traffic_light",
          "tree_broadleaf",
          "tree_street_tall",
          "tree_pine_layered",
          "tree_blossom",
          "shrub_leafy",
          "fern_arching",
          "grass_upright",
          "grass_arching",
          "rock_single",
          "flowers_meadow",
          "bus_shelter",
          "bus_stop_sign",
          "trash_bin",
          "recycling_bin",
          "post_box",
          "parcel_locker",
          "bicycle_rack",
          "bicycle",
          "bench",
          "street_lamp",
          "notice_board",
          "drinking_fountain",
          "car_compact",
          "delivery_van",
          "vending_machine",
          "cafe_table",
          "cafe_chair",
          "patio_umbrella",
          "shop_crate",
          "ev_charger"
        ],
        "source_model_access": "paid_pack_only"
      },
      "delivery": {
        "filename": "Sunward_Modern_Town_Complete_v02.zip",
        "bytes": 685144857,
        "format": "ZIP",
        "download_ready": true,
        "access_note": "Sign in, purchase this pack, and use the download button on its original page. This response does not grant access."
      },
      "validation": {
        "details_url": "https://3dmodelhub.io/es/products/sunward-modern-town/",
        "checks": [
          "Reimportación real en Blender 4.3.2: aprobados los 175 GLB individuales y 54 de la villa.",
          "Godot 4.6.3 sin interfaz: 175 recursos, 282 formas y 846 muestras exteriores aprobados. Sin compresión con pérdida: 395.326 triángulos base sin degenerados.",
          "Villa en Godot 4.6.3: 54 GLB y 30 imágenes; 17 archivos predeterminados y 17 colisiones juntos. Aprobados 410 componentes, 1.230 muestras exteriores, 560 a escala de personaje y 8 rutas concretas."
        ],
        "limitations": [
          "Solo exteriores. Sin interiores, personajes, misiones, conducción ni interacciones comerciales.",
          "Sin LOD automático, streaming, navegación de todo el mapa ni controlador completo de personaje.",
          "Las colisiones cubren edificios y apoyo del terreno, no todos los objetos urbanos, troncos ni obstáculos pequeños. Ocho rutas no certifican toda la villa como transitable.",
          "Godot no aplica KHR_materials_ior; el vidrio puede verse distinto entre motores.",
          "Sin pruebas de FPS GPU, validación Unity/Unreal ni certificación móvil.",
          "Hay combinaciones repetidas. LOD0 cubre 26 edificios representativos; los otros 102 no tienen el mismo detalle. La villa predeterminada tiene 5.358.342 triángulos y requiere optimización para el dispositivo destino. Las pruebas técnicas no son aprobación visual comercial. Usa los GLB runtime/Collision validados."
        ]
      },
      "detail_url": "https://3dmodelhub.io/es/products/sunward-modern-town/",
      "preview_url": "https://3dmodelhub.io/preview/sunward-modern-town/?lang=es",
      "license_url": "https://3dmodelhub.io/es/license/"
    },
    {
      "id": "creek-village",
      "name": "Aldea del Arroyo V5",
      "summary": "Una pequeña aldea entre laderas de hierba, un arroyo y un molino de agua. Incluye la escena Blender V5 editable con la corrección de sombras de hierba.",
      "version": "v05",
      "access": "paid_one_time",
      "login_required": true,
      "ownership": "not_queried",
      "availability": "on_sale",
      "price": {
        "amount_minor": 599,
        "currency": "usd",
        "phase": "fixed",
        "policy": "fixed",
        "intro_amount_minor": 599,
        "standard_amount_minor": 599,
        "launch_at": "2026-10-22T01:05:44.321Z",
        "intro_ends_at": null,
        "checkout_enabled": true,
        "mode": "live"
      },
      "contents": {
        "source_catalog": "blender-scene",
        "model_count": null,
        "instance_count": null,
        "counts_note": "Instances, LOD files and collision proxies are not additional independent models.",
        "source_model_ids": [],
        "source_model_access": "paid_pack_only"
      },
      "delivery": {
        "filename": "Creek_Village_V5_Complete_v05.zip",
        "bytes": 28490117,
        "format": "ZIP",
        "download_ready": true,
        "access_note": "Sign in, purchase this pack, and use the download button on its original page. This response does not grant access."
      },
      "validation": {
        "details_url": "https://3dmodelhub.io/es/kits/creek-village/",
        "checks": [
          "La corrección de sombras se comprobó en reproducción local de la vista de materiales de Blender. La comparación registrada conserva geometría, transformaciones, nodos y animación."
        ],
        "limitations": [
          "Es un entorno compuesto. Los objetos e instancias de hierba no equivalen a modelos independientes.",
          "El navegador muestra una adaptación GLB estática; los materiales procedurales, la luz y la animación original pueden diferir.",
          "No se han validado importación en Godot, Unity o Unreal, colisiones, navegación ni FPS en dispositivos objetivo.",
          "La revisión de reproducción no certifica el render final de animación Cycles ni todos los fotogramas."
        ]
      },
      "detail_url": "https://3dmodelhub.io/es/kits/creek-village/",
      "preview_url": "https://3dmodelhub.io/preview/creek-village/?lang=es",
      "license_url": "https://3dmodelhub.io/es/license/"
    }
  ],
  "meta": {
    "api_version": "1.0.0",
    "request_id": "a2f366c2-5444-419f-9a1f-540fc3d317b7"
  }
}

GET/api/v1/kits/{id}

Detalle del pack

Read one pack’s public contents, validation and delivery metadata. A filename and size grant no paid-file access.

jaderealms_get_scene_kit_details

Parámetros	Obligatorio	Valor inicial	Valores permitidos	Descripción
`id`path · string	Obligatorio	`—`	^[A-Za-z0-9_-]+$ · 1–100	ID exacto de la lista.
`locale`query · string	Opcional	`"en"`	en · zh · ja · ko · es · de · fr	Idioma.

cURL

curl --fail 'https://3dmodelhub.io/api/v1/kits/creek-village?locale=es'

JavaScript

const response = await fetch("https://3dmodelhub.io/api/v1/kits/creek-village?locale=es", {
  credentials: 'omit',
  headers: { Accept: 'application/json' }
});
const body = await response.json();
if (!response.ok) throw new Error(body.error?.code || response.status);
console.log(body.data);

Python

import json
from urllib.request import urlopen

with urlopen("https://3dmodelhub.io/api/v1/kits/creek-village?locale=es") as response:
    body = json.load(response)
print(body['data'])

Ejemplo de respuesta · HTTP 200

Ejemplos generados con el catálogo actual. Las cantidades, precios e identificadores pueden cambiar.

JSON

{
  "locale": "es",
  "data": {
    "id": "creek-village",
    "name": "Aldea del Arroyo V5",
    "summary": "Una pequeña aldea entre laderas de hierba, un arroyo y un molino de agua. Incluye la escena Blender V5 editable con la corrección de sombras de hierba.",
    "version": "v05",
    "access": "paid_one_time",
    "login_required": true,
    "ownership": "not_queried",
    "availability": "on_sale",
    "price": {
      "amount_minor": 599,
      "currency": "usd",
      "phase": "fixed",
      "policy": "fixed",
      "intro_amount_minor": 599,
      "standard_amount_minor": 599,
      "launch_at": "2026-10-22T01:05:44.321Z",
      "intro_ends_at": null,
      "checkout_enabled": true,
      "mode": "live"
    },
    "contents": {
      "source_catalog": "blender-scene",
      "model_count": null,
      "instance_count": null,
      "counts_note": "Instances, LOD files and collision proxies are not additional independent models.",
      "source_model_ids": [],
      "source_model_access": "paid_pack_only"
    },
    "delivery": {
      "filename": "Creek_Village_V5_Complete_v05.zip",
      "bytes": 28490117,
      "format": "ZIP",
      "download_ready": true,
      "access_note": "Sign in, purchase this pack, and use the download button on its original page. This response does not grant access."
    },
    "validation": {
      "details_url": "https://3dmodelhub.io/es/kits/creek-village/",
      "checks": [
        "La corrección de sombras se comprobó en reproducción local de la vista de materiales de Blender. La comparación registrada conserva geometría, transformaciones, nodos y animación."
      ],
      "limitations": [
        "Es un entorno compuesto. Los objetos e instancias de hierba no equivalen a modelos independientes.",
        "El navegador muestra una adaptación GLB estática; los materiales procedurales, la luz y la animación original pueden diferir.",
        "No se han validado importación en Godot, Unity o Unreal, colisiones, navegación ni FPS en dispositivos objetivo.",
        "La revisión de reproducción no certifica el render final de animación Cycles ni todos los fotogramas."
      ]
    },
    "detail_url": "https://3dmodelhub.io/es/kits/creek-village/",
    "preview_url": "https://3dmodelhub.io/preview/creek-village/?lang=es",
    "license_url": "https://3dmodelhub.io/es/license/"
  },
  "meta": {
    "api_version": "1.0.0",
    "request_id": "22296a8a-984f-4525-ad1a-d2be29d77513"
  }
}

GET/api/v1/guidance

Uso y licencia

topic is required: license, downloads, engines or purchases. The linked license page contains the applicable terms.

jaderealms_get_usage_guidance

Parámetros	Obligatorio	Valor inicial	Valores permitidos	Descripción
`topic`query · string	Obligatorio	`—`	license · downloads · engines · purchases	Tema de ayuda pública.
`locale`query · string	Opcional	`"en"`	en · zh · ja · ko · es · de · fr	Idioma.

cURL

curl --fail 'https://3dmodelhub.io/api/v1/guidance?topic=license&locale=es'

JavaScript

const response = await fetch("https://3dmodelhub.io/api/v1/guidance?topic=license&locale=es", {
  credentials: 'omit',
  headers: { Accept: 'application/json' }
});
const body = await response.json();
if (!response.ok) throw new Error(body.error?.code || response.status);
console.log(body.data);

Python

import json
from urllib.request import urlopen

with urlopen("https://3dmodelhub.io/api/v1/guidance?topic=license&locale=es") as response:
    body = json.load(response)
print(body['data'])

Ejemplo de respuesta · HTTP 200

Ejemplos generados con el catálogo actual. Las cantidades, precios e identificadores pueden cambiar.

JSON

{
  "locale": "es",
  "data": {
    "topic": "license",
    "links": {
      "home": "https://3dmodelhub.io/es/",
      "models": "https://3dmodelhub.io/es/models/",
      "kits": "https://3dmodelhub.io/es/kits/",
      "guide": "https://3dmodelhub.io/es/guide/",
      "license": "https://3dmodelhub.io/es/license/"
    },
    "confirmed": true,
    "commercial_games_and_animation": true,
    "raw_asset_resale": false,
    "repackaged_asset_distribution": false,
    "paid_pack_terms_url": "https://3dmodelhub.io/es/license/",
    "cc0_exceptions": {
      "note": "Project redistribution restrictions do not override the disclosed CC0 foundation rights. Consult the exact source records.",
      "url": "https://3dmodelhub.io/es/license/#cc0-foundations",
      "model_ids": [
        "ancient_east_water_buffalo",
        "anime_jrpg_coastal_wind_cliff"
      ]
    }
  },
  "meta": {
    "api_version": "1.0.0",
    "request_id": "8cc2de1b-bb48-4602-920d-816b7ab81d51"
  }
}

GET/api/v1/models/{id}/downloads

Descargas gratuitas

Get free GLB and complete ZIP metadata and URLs. This endpoint returns JSON; follow files[].url to receive the actual bytes.

jaderealms_get_model_downloads

Parámetros	Obligatorio	Valor inicial	Valores permitidos	Descripción
`id`path · string	Obligatorio	`—`	^[A-Za-z0-9_-]+$ · 1–100	ID exacto de la lista.
`locale`query · string	Opcional	`"en"`	en · zh · ja · ko · es · de · fr	Idioma.

cURL

curl --fail 'https://3dmodelhub.io/api/v1/models/ancient_pine/downloads?locale=es'

JavaScript

const response = await fetch("https://3dmodelhub.io/api/v1/models/ancient_pine/downloads?locale=es", {
  credentials: 'omit',
  headers: { Accept: 'application/json' }
});
const body = await response.json();
if (!response.ok) throw new Error(body.error?.code || response.status);
console.log(body.data);

Python

import json
from urllib.request import urlopen

with urlopen("https://3dmodelhub.io/api/v1/models/ancient_pine/downloads?locale=es") as response:
    body = json.load(response)
print(body['data'])

Ejemplo de respuesta · HTTP 200

Ejemplos generados con el catálogo actual. Las cantidades, precios e identificadores pueden cambiar.

JSON

{
  "locale": "es",
  "data": {
    "id": "ancient_pine",
    "version": "Ancient_Pine_Runtime_v1",
    "login_required": false,
    "purchase_required": false,
    "recommended": "complete_model_zip",
    "files": [
      {
        "format": "GLB",
        "purpose": "Direct default model with embedded materials",
        "filename": "ancient_pine_LOD1.glb",
        "bytes": 19271052,
        "sha256": "2301433ad1795a0bff44b55d65f6ad81e2f94c5e3f15fa0eb7dcdc38a8bb6bbb",
        "url": "https://3dmodelhub.io/download/ancient_pine/model-0/"
      },
      {
        "format": "ZIP",
        "purpose": "Complete files for this model, including Blender sources and textures",
        "filename": "ancient_pine_complete.zip",
        "bytes": 41762903,
        "sha256": "1529b0170d56bab328c6bf7688009b0359fd390b5491b2a4689b7c9c9125a631",
        "url": "https://3dmodelhub.io/download/ancient_pine/package/"
      }
    ],
    "license": {
      "url": "https://3dmodelhub.io/es/license/",
      "commercial_games_and_animation": true,
      "cc0_foundation_exception": false
    }
  },
  "meta": {
    "api_version": "1.0.0",
    "request_id": "7208aefe-ac2e-42a5-ac10-19c5f3eb96c0"
  }
}

Campos de respuesta

JSON	Descripción
`data`	The endpoint result: arrays for model/pack lists, objects for details.
`id / version`	Stable entry ID and content version. Use the ID, not a translated name, in detail paths.
`name / name_en`	Localized and English names. JSON names, enum values and IDs are independent of locale.
`category / category_name / styles`	Category code, display label and style code array. Filter using codes, not labels.
`triangles / default_glb_bytes`	Triangle count and byte size of the default GLB, as integers. Not ZIP size or scene performance.
`materials / textures`	Recorded counts of materials and texture images.
`static / rigged / animation_count`	Catalog static marker, rigging flag and animation count. A character name does not imply a rig or animation.
`available_formats / dimensions_m_y_up`	Recorded formats and dimensions in meters with Y up; null when unknown. Check file notes for actual ZIP contents.
`locale`	Response language; en by default.
`meta.api_version / meta.request_id`	API version and request identifier. An ID shown in an example does not identify your own request.
`pagination.total / next_offset`	Matching rows and the next offset; null means the final page.
`scope / status / checked_on / parent_id`	Entry scope, verification status and date, and parent scene. verified confirms current GLB contents and classification, not engine certification. Entries, extracted modules and repeated instances are different counts.
`tested_engines / validation`	Hash-matched engine import records and their scope; not a performance or other-engine certificate.
`download.files / files`	GLB/ZIP format, filename, bytes, SHA256 and file URL. The array itself is not the file.
`login_required / purchase_required`	Whether sign-in or purchase is required. Both are false for free models; paid packs do not expose private URLs.
`files[].purpose / recommended`	Purpose of each file and recommended choice. complete_model_zip recommends the complete single-model ZIP.
`detail_url / poster_url / preview_url / license_url`	Absolute detail, poster, scene preview and license page URLs. A preview page is not a model file.
`price.amount_minor / currency`	Integer minor currency units: USD 799 means US$7.99. null means unknown, not free.
`price.phase / policy / checkout_enabled`	Current price phase, pricing policy and checkout availability. Server-calculated prices may change; this API creates no checkout.
`access / availability`	Pack access (free or paid_one_time) and availability (free_download, on_sale, unavailable). Follow the returned state.
`contents.model_count / instance_count / source_model_ids`	Source model count, scene instance count and source IDs. Instances, LODs and collision proxies are not extra independent models.
`ownership / delivery`	Public metadata does not query account ownership. Public delivery names and sizes grant no paid-file access.
`delivery.download_url`	May appear only while the pack is publicly free. Omitted for paid packs.
`license / guidance`	License summaries and public guidance. Read the linked terms and asset-specific notes for commercial use, resale restrictions and CC0 exceptions.
`null`	Unknown or inapplicable; do not silently replace with 0, false or a verified claim.

Paginación

Usa next_offset hasta que sea null, manteniendo los filtros. total es el número de coincidencias.

JavaScript

const base = "https://3dmodelhub.io/api/v1";
let offset = 0;
while (offset !== null) {
  const query = new URLSearchParams({ limit: '20', offset: String(offset), locale: "es" });
  const response = await fetch(base + '/models?' + query, { credentials: 'omit' });
  const body = await response.json();
  if (!response.ok) throw new Error(body.error?.code || response.status);
  for (const model of body.data) console.log(model.id, model.name);
  offset = body.pagination.next_offset;
}

Descargar un archivo

downloads devuelve JSON. Sigue url en data.files para obtener el GLB o ZIP. Los archivos gratuitos no requieren autenticación.

cURL · SHA256

curl --fail --location --output 'ancient_pine_LOD1.glb' 'https://3dmodelhub.io/download/ancient_pine/model-0/'

curl --fail --location --output 'ancient_pine_complete.zip' 'https://3dmodelhub.io/download/ancient_pine/package/'

# macOS: compare the first column with data.files[].sha256
shasum -a 256 'ancient_pine_LOD1.glb'

Range: bytes=0-1023 · 206 Partial Content · ETag / If-Range

Los metadatos públicos y modelos individuales gratuitos no requieren cuenta ni clave. Los archivos de pago mantienen la comprobación de compra del sitio.

Errores y reintentos

Comprueba HTTP y error.code; guarda request_id. Los mensajes son en inglés. Para 429 espera Retry-After.

JSON · HTTP 400

{
  "error": {
    "code": "InvalidArguments",
    "message": "Check the documented parameters and their allowed values."
  },
  "request_id": "00000000-0000-4000-8000-000000000000"
}

X-Request-Id = request_id · Access-Control-Allow-Origin: * · Cache-Control: no-store

HTTP	error.code	Descripción
400	`InvalidArguments`	Unknown/repeated argument, missing topic, or limit outside 1–20.
404	`NotFound`	No published entry or no public endpoint.
405	`MethodNotAllowed`	GET, HEAD, OPTIONS
414	`InvalidArguments`	URL > 4096
429	`RateLimited`	Retry-After: 60

downloads devuelve JSON. Sigue url en data.files para obtener el GLB o ZIP. Los archivos gratuitos no requieren autenticación.

File routes may also return 416 for invalid ranges or 503 for storage/integrity failures; paid files may return 401/402. Check status before saving a response as a model.