Sperid Labs Idol

Idol by Sperid Labs turns a single image of an object into a 3D Gaussian splat, with a GLB point-cloud preview.

MODALITIES

text

Sperid Labs Idol (speridlabs/idol) is a 3d model from Speridlabs. Pricing via AIgateway: see pricing table. Call it via https://api.aigateway.sh/v1/3d/generations — set model="speridlabs/idol".

model · speridlabs/idol

Use this model

model: speridlabs/idol

curl https://api.aigateway.sh/v1/3d/generations \
  -H "Authorization: Bearer $AIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"speridlabs/idol","prompt":"A low-poly treasure chest"}'

curl https://api.aigateway.sh/v1/3d/generations \ -H "Authorization: Bearer $AIGATEWAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"speridlabs/idol","prompt":"A low-poly treasure chest"}'

Capabilities

Image to 3d

Pricing

You pay pass-through pricing.

See API example →Compare API reference See usage ranking →

Collections

More text models →More from Speridlabs →Frontier models →Free-tier models →

API schema

Call Sperid Labs Idol from any OpenAI SDK

POST https://api.aigateway.sh/v1/3d/generations·Content-Type: application/json·Auth: Bearer sk-aig-...

Request body

json

{
  "model": "speridlabs/idol",
  "prompt": "A low-poly treasure chest, game asset",
  // optional "image_url" to reconstruct from a reference image
  "webhook_url": "https://your.app/webhooks/aigateway"  // optional
}

// Response is an async job — poll /v1/jobs/<id> until status === "completed".

Response

json

{
  "id": "job_abc123",
  "status": "queued",        // queued | processing | completed | failed
  "model": "speridlabs/idol",
  "created": 1776947082
}

// After completion (GET /v1/jobs/job_abc123):
{
  "id": "job_abc123",
  "status": "completed",
  "result": {
    "url": "https://media.aigateway.sh/3d/abc123.glb",
    "format": "glb"
  }
}

Quickstart

import os, requests

r = requests.post(
    "https://api.aigateway.sh/v1/3d/generations",
    headers={"Authorization": f"Bearer {os.environ['AIGATEWAY_API_KEY']}"},
    json={
        "model": "speridlabs/idol",
        "prompt": "A low-poly treasure chest"
    },
)
print(r.json())

Errors

401authentication_errorInvalid or missing API key

402insufficient_creditsWallet empty (PAYG only)

404not_foundUnknown model or endpoint

429rate_limit_errorOver per-minute limit — see Retry-After header

500server_errorUpstream provider failed (retryable)

503service_unavailableUpstream saturated (retryable)

Full docs →API reference →OpenAPI spec →llms.txt →

Frequently asked questions

What is Sperid Labs Idol?

Idol by Sperid Labs turns a single image of an object into a 3D Gaussian splat, with a GLB point-cloud preview. It is a 3d model from Speridlabs, accessible via AIgateway's OpenAI-compatible API at slug speridlabs/idol.

How much does Sperid Labs Idol cost via AIgateway?

Pass-through pricing. See the pricing panel on this page for exact rates.

How do I call Sperid Labs Idol from my code?

Point the OpenAI SDK at https://api.aigateway.sh/v1 with your AIgateway key and set model to "speridlabs/idol". The request and response shapes match OpenAI exactly.

Does Sperid Labs Idol support streaming, tool calling, vision, and JSON mode?

Streaming — no. Tool calling — no. Vision — no. JSON mode — no. Prompt caching — no.

Can I bring my own Speridlabs API key (BYOK)?

Yes. Attach a Speridlabs key in your AIgateway dashboard and this model flips to pass-through — you pay Speridlabs directly and AIgateway adds no platform fee on those calls.