3D Generation

Endpoint

POST https://bumi.digital/api/v1/3d/generate
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Example request

curl -X POST https://bumi.digital/api/v1/3d/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model_id":"t3d-meshy-6-t3d","parameters":{"prompt":"A small ceramic robot"},"webhook_url":"https://example.com/webhook"}'

Use GET /api/v1/models?type=3d or GET /api/v1/models/pricing?type=3d to discover active models, exact parameters, and current credit costs. Only models enabled in the availability registry are returned. Text-to-3D requires a prompt; image, multi-view and mesh transformations use their declared input fields. Do not send undeclared options.

Asynchronous status and results

{
  "ok": true,
  "generation_id": "your_generation_id",
  "status": "processing",
  "used_cost": 9999999,
  "balance": 10000000
}

The endpoint returns HTTP 202. Credits are reserved atomically at submission. Poll GET /api/v1/generation/your_generation_id with your API key, or provide an optional public HTTP(S) webhook_url for completion/failure notifications. GET /api/v1/generations?type=model3d lists your 3D history. Generation and webhook type is model3d, while model discovery uses type=3d.

A submission marked submission: unknown remains processing: a timeout, malformed response, server error, or missing task ID does not prove rejection. Do not blindly resubmit; retain the generation ID and check status. Explicit rejection or verified provider failure triggers an idempotent refund. Unconfirmed submissions without a provider task ID may require support reconciliation.

Status responses expose resultUrl (a string or array) and resultUrls; history uses result_url and result_urls. Webhooks expose resultUrl and resultUrls for multiple assets. Stored output metadata uses model3d_outputs. Assets preserve the URLs/formats returned by the provider; no mesh format is guaranteed. Local /api/ai/model3d/file/... downloads require the same API key or an owner session; R2 URLs can be accessed directly.

Available models