Rage3D API

Transform 2D images into high-quality 3D models using advanced AI. Our API produces industry-leading results with 8K textures, PBR materials, and optimized geometry suitable for 3D printing, game development, e-commerce, and visualization.

What you can build

• E-commerce product visualization — Convert product photos to interactive 3D models
• 3D printing services — Generate print-ready STL files from any image
• Game asset creation — Create game-ready models with PBR textures
• AR/VR applications — Build immersive experiences with AI-generated 3D content

Key features

• 8K HD Textures — Ultra-detailed PBR materials
• Multiple input support — Single image or multi-view (up to 4 images)
• 3D print ready — Automatic STL conversion
• Fast processing — Most models ready in under 2 minutes

Quickstart

Generate your first 3D model in 4 simple steps.

curl -X POST https://rage3d-api-797053387346.asia-south1.run.app/generate-3d \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "images=@photo.jpg"

import requests

response = requests.post(
    "https://rage3d-api-797053387346.asia-south1.run.app/generate-3d",
    headers={"X-API-Key": "YOUR_API_KEY"},
    files={"images": open("photo.jpg", "rb")}
)

task_id = response.json()["task_id"]
print(f"Task ID: {task_id}")

const fs = require('fs');
const FormData = require('form-data');
const axios = require('axios');

const form = new FormData();
form.append('images', fs.createReadStream('photo.jpg'));

const response = await axios.post(
    'https://rage3d-api-797053387346.asia-south1.run.app/generate-3d',
    form,
    { headers: { 'X-API-Key': 'YOUR_API_KEY', ...form.getHeaders() } }
);

console.log('Task ID:', response.data.task_id);

curl https://rage3d-api-797053387346.asia-south1.run.app/task/YOUR_TASK_ID \
  -H "X-API-Key: YOUR_API_KEY"

import time

while True:
    status = requests.get(
        f"https://rage3d-api-797053387346.asia-south1.run.app/task/{task_id}",
        headers={"X-API-Key": "YOUR_API_KEY"}
    ).json()
    
    print(f"Progress: {status['progress']}%")
    
    if status["status"] == "success":
        print("Done!", status['pbr_model_url'])
        break
    elif status["status"] == "failed":
        print("Failed")
        break
    
    time.sleep(5)

curl https://rage3d-api-797053387346.asia-south1.run.app/download/YOUR_TASK_ID/glb \
  -H "X-API-Key: YOUR_API_KEY" \
  -o model.glb

Authentication

All API requests require an API key in the X-API-Key header.

X-API-Key: hyp3d_your_api_key_here

Getting your API key

1. Sign in to your dashboard
2. Copy your API key from the "API Access" section

Base URL

Pricing

Bulk pricing

• Cumulative, not per-order — your purchased generations add up across every recharge until you reach the threshold.
• Permanent once unlocked — after you qualify, the ₹149 rate applies to every future recharge and generation, automatically.
• Nothing to claim — the discount is applied by the system; no coupon or sales contact needed.
• Check your current rate any time via GET /auth/me (generation_cost) or GET /pricing.

How billing works

• Prepaid wallet — Add funds from dashboard
• Per-generation — ₹199 deducted when you submit
• No hidden fees — STL conversion and downloads are free
• Failed generations — Not charged if generation fails

How It Works

The generation pipeline

1. Image upload — Your image is validated
2. AI analysis — AI understands 3D structure
3. Geometry generation — Optimized mesh created
4. Texture creation — 8K PBR textures generated
5. Model packaging — GLB file with embedded textures

Asynchronous processing

3D generation takes 1-3 minutes. The API returns a task_id immediately, then poll GET /task/{task_id} to check progress.

Image Requirements

Tips for best results

• Clear subject with good lighting
• Simple or white backgrounds
• For complex objects, provide 2-4 views

Output Formats

GLB (default)

Binary glTF with embedded 8K PBR textures. Industry standard for web 3D.

STL (optional)

Geometry-only format for 3D printing. Use POST /task/{id}/convert-stl.

Generate 3D Model

# Lighter mesh + webhook instead of polling
curl -X POST https://rage3d-api-797053387346.asia-south1.run.app/generate-3d \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "images=@photo.jpg" \
  -F "target_faces=600000" \
  -F "callback_url=https://your.app/hooks/rage3d"

# View-targeted: send specific angles (e.g. front + back only)
curl -X POST https://rage3d-api-797053387346.asia-south1.run.app/generate-3d \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "image_front=@front.jpg" \
  -F "image_back=@back.jpg"

{
  "task_id": "42539d4f-9ce0-4599-8da5-21c58477562c",
  "status": "queued",
  "message": "Task submitted. Use GET /task/{task_id} to check status.",
  "balance_after": 1881.0,
  "cost": 199.0
}

Get Task Status

{
  "task_id": "42539d4f-9ce0-4599-8da5-21c58477562c",
  "status": "success",
  "progress": 100,
  "stage": "ready",
  "eta_seconds": null,
  "model_url": "https://...",
  "pbr_model_url": "https://...",
  "rendered_image_url": "https://...",
  "expires_at": "2026-03-21T12:00:00+00:00"
}

Webhooks

Instead of polling, pass a callback_url on /generate-3d. When the job reaches a terminal state, we POST a JSON body to that URL.

{
  "task_id": "42539d4f-9ce0-4599-8da5-21c58477562c",
  "status": "success",
  "stage": "ready",
  "model_url": "https://...",
  "stl_url": "https://...",
  "rendered_image_url": "https://..."
}

Convert to STL

curl -X POST https://rage3d-api-797053387346.asia-south1.run.app/task/YOUR_TASK_ID/convert-stl \
  -H "X-API-Key: YOUR_API_KEY"

Download File

# Download GLB (using header auth)
curl https://rage3d-api-797053387346.asia-south1.run.app/download/TASK_ID/glb \
  -H "X-API-Key: YOUR_API_KEY" -o model.glb

# Download STL (using query param auth - works in browser)
curl "https://rage3d-api-797053387346.asia-south1.run.app/download/TASK_ID/stl?key=YOUR_API_KEY" -o model.stl

List Generations

curl https://rage3d-api-797053387346.asia-south1.run.app/generations?limit=10 \
  -H "X-API-Key: YOUR_API_KEY"

Get Wallet Balance

curl https://rage3d-api-797053387346.asia-south1.run.app/wallet/balance \
  -H "X-API-Key: YOUR_API_KEY"

# Response:
{
  "balance": 1990.0,
  "message": "You can generate 10 models with current balance"
}

Get Profile

curl https://rage3d-api-797053387346.asia-south1.run.app/auth/me \
  -H "X-API-Key: YOUR_API_KEY"

# Response:
{
  "email": "user@example.com",
  "name": "John Doe",
  "balance": 1990.0,
  "total_generations": 24,
  "generation_cost": 199.0
}

Error Handling

{
  "detail": "Insufficient balance. Required: ₹199, Available: ₹50"
}

Content-policy rejections (422)

If an image is rejected, you get a machine-actionable body. Branch on error, not the message text. Note the phase field: submission means it was rejected up front, generation means it was rejected after processing started (in which case the rejection surfaces when you poll the task).

{
  "error": "content_policy_violation",
  "code": 2008,
  "message": "...",
  "suggestion": "...",
  "retryable": true,
  "phase": "submission"
}

retryable: true means the classifier is non-deterministic across renders — re-submitting a re-rendered image often passes.

Generation failures

If a task fails after it started, polling it returns one of these. All carry error, code, message and retryable:

Best Practices

Polling strategy

• Poll every 5-10 seconds
• Stop when stage is ready or failed
• Use stage — not a wall-clock timeout — to decide if a task is stuck. A long progress: 99 with stage: "finalizing" is normal export work.
• Download only after stage: "ready"; a 503 means retry, a 410 means don't
• Prefer callback_url over polling at scale — see Webhooks
• Implement exponential backoff for rate limits

Image optimization

• Use 1024×1024 or higher resolution
• Good lighting, clear subject
• Plain backgrounds work best

Security

• Never hardcode API keys
• Use environment variables
• Separate keys for dev/production