QubiCore API

QubiCore API Documentation

Version: v1.0 Base URL: https://api.qubic.ai/v1/ Auth Required: Yes – Bearer Token or Signed Wallet Auth (EIP‑712) Format: JSON (RESTful) Rate Limits: Based on plan tier. See Rate Limits.

---

Overview

The QubiCore API provides secure programmatic access to QubicAI’s core features, allowing developers, studios, and platforms to generate, enhance, and deploy 3D/2D assets using natural language, sketches, or references.

Common use cases include:

• Game asset pipelines

• AR/VR content generation

• AI NFT minting tools

• Design tool integrations

• Product prototyping workflows

---

Authentication

Option 1: Bearer Token

httpCopyEditAuthorization: Bearer YOUR_API_KEY

Option 2: Signed Wallet (Web3)

• Sign EIP‑712 message

• Pass signature as header:

httpCopyEditAuthorization: Qubic-Wallet YOUR_WALLET_ADDRESS:SIGNATURE

---

Endpoints

1. Generate 3D Model

POST /generate/model Create a 3D asset from a prompt or reference input.

Request Body

jsonCopyEdit{
  "prompt": "futuristic cyberpunk drone",
  "style": "realistic",
  "referenceImage": "data:image/png;base64,...",  // Optional
  "outputFormat": "glb"  // glb, fbx, obj
}

Response

jsonCopyEdit{
  "modelId": "mod_7832ab19",
  "status": "processing",
  "estimatedTime": "9s"
}

---

2. Retrieve Model Asset

GET /models/{modelId}

Response

jsonCopyEdit{
  "modelId": "mod_7832ab19",
  "status": "completed",
  "downloadUrl": "https://cdn.qubic.ai/assets/mod_7832ab19.glb"
}

---

3. Texture & UV Mapping

POST /generate/texture

Request Body

jsonCopyEdit{
  "modelId": "mod_7832ab19",
  "preset": "pbr-metallic",
  "smartUV": true
}

Response

jsonCopyEdit{
  "textureId": "tx_512e8a7a",
  "maps": {
    "diffuse": "...",
    "normal": "...",
    "metallic": "..."
  }
}

---

4. Image Upscaling

POST /tools/upscale

Request Body

jsonCopyEdit{
  "image": "data:image/jpeg;base64,...",
  "factor": 4
}

Response

jsonCopyEdit{
  "output": "https://cdn.qubic.ai/upscaled/up_8877a.jpeg"
}

---

5. Asset Search (Coming Soon)

GET /search/assets?q=cyberpunk%20drone

---

Webhooks (Optional)

You can register a webhook to receive completion notifications:

jsonCopyEdit{
  "event": "model.generated",
  "target": "https://yourdomain.com/callbacks/qubic"
}

---

Rate Limiting

Plan Tier	Requests/min	Concurrent Jobs
Free	5	1
Creator	30	3
Pro / Studio	120	10
Enterprise	Custom	Custom

429 errors will be returned when limits are exceeded.

---

SDKs

Official client libraries are available:

• Node.js – @qubicai/sdk

• Python – qubicai

• Unity Plugin (in beta)

• Unreal Plugin (Q3 2025)

---

Error Codes

Code	Meaning
400	Bad request / validation
401	Unauthorized / invalid key
403	Forbidden / quota exceeded
404	Asset not found
500	Server error