Python Integration Guide

pip install requests

import requests
import time
from typing import Optional, Dict, Any

class Hydrilla:
    def __init__(self, api_key: str, base_url: str = "https://api.hydrilla.co"):
        self.base_url = base_url.rstrip("/")
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }

    def text_to_3d(self, prompt: str, resolution: int = 1536, image_model: Optional[Dict[str, str]] = None) -> str:
        """Trigger Text-to-3D generation and return the task ID."""
        payload = {"prompt": prompt, "resolution": resolution}
        if image_model:
            payload["image_model"] = image_model
            
        res = requests.post(f"{self.base_url}/v1/3d/text-to-3d", headers=self.headers, json=payload)
        res.raise_for_status()
        return res.json()["id"]

    def image_to_3d(self, image_url: str, resolution: int = 1536) -> str:
        """Trigger Image-to-3D generation and return the task ID."""
        payload = {"image_url": image_url, "resolution": resolution}
        res = requests.post(f"{self.base_url}/v1/3d/image-to-3d", headers=self.headers, json=payload)
        res.raise_for_status()
        return res.json()["id"]

    def poll_task(self, task_id: str, poll_interval: int = 3, timeout: int = 180) -> Dict[str, Any]:
        """Poll task until completed or failed."""
        start = time.time()
        while time.time() - start < timeout:
            res = requests.get(f"{self.base_url}/v1/3d/tasks/{task_id}", headers=self.headers)
            res.raise_for_status()
            data = res.json()
            status = data.get("status")
            
            if status == "completed":
                return data["result"]
            elif status == "failed":
                raise RuntimeError(f"Hydrilla Task Failed: {data.get('error')}")
                
            time.sleep(poll_interval)
            
        raise TimeoutError(f"Task {task_id} timed out after {timeout} seconds.")

from hydrilla import Hydrilla

client = Hydrilla(api_key="hyd_live_your_api_key_here")

# 1. Generate 3D directly from prompt
task_id = client.text_to_3d(
    prompt="Cyberpunk drone quadcopter, carbon fiber frame, glowing blue LED",
    resolution=1536
)
print(f"Queued 3D task: {task_id}")

# 2. Wait for GLB export
result = client.poll_task(task_id)
print(f"Success! Download GLB mesh: {result['mesh_url']}")