Images
Generate reference images from text, then reuse them to create 3D models.
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. |
model | string | gpt-image-2 (balanced) or nano-banana-2 (faster, cheaper). Default: gpt-image-2. |
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", "model": "nano-banana-2"}'Example Response
[
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "queued",
"model": "nano-banana-2",
"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",
"model": "nano-banana-2",
"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"}'