Image Hub

Generate images from a text prompt and reuse them as the reference for a 3D model. Generate once, then feed the same image into as many Sculptor or Detailer jobs as you like.

Generate images

POST /api/v1/imagehub

Requires API key.

Queue one or more text-to-image generations. Each returns an id you can poll for completion, then download or reuse.

Request Body

Name	Type	Description
`prompt`	string	Natural-language description of the image. Required.
`n`	integer	Number of images to generate, 1–4. Default: `1`.
`size`	string	`1024x1024` (default), `1536x1024`, or `1024x1536`.
`reference_image`	string	Optional image to guide generation — base64 data URL or HTTPS URL.

Example Request

curl -X POST https://api.thrixel.com/api/v1/imagehub \
  -H "Authorization: Bearer sk-thrixel-<YOUR_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a weathered brass steampunk compass"}'

Example Response

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "queued",
    "size": "1024x1024",
    "url": null
  }
]

Retrieve your images

GET /api/v1/imagehub

Requires API key.

Lists your images, newest first. Poll until status is completed; the url is then the image file (also served directly at GET /api/v1/imagehub/{image_id}/file).

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "completed",
    "size": "1024x1024",
    "url": "/api/v1/imagehub/a1b2c3d4-e5f6-7890-abcd-ef1234567890/file"
  }
]

Use an image to create 3D

Pass an image's id as reference_image_id to /sculptor/submit or /detailer/submit to turn it into a 3D model. The stored image is reused as the reference — no new image is generated.

curl -X POST https://api.thrixel.com/api/v1/sculptor/submit \
  -H "Authorization: Bearer sk-thrixel-<YOUR_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"reference_image_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"}'