# Image to Gaussian Splat
**Base URL:** `https://openapi.tripo3d.ai/v3`
**Endpoint:** `POST /generation/image-to-splat`
Generate a 3D Gaussian Splat (.splat) from a single image. Gaussian Splatting is a modern 3D representation well-suited for high-quality real-time rendering and photorealistic scene reconstruction. The output .splat file can be loaded by mainstream Gaussian Splat viewers and renderers. Choose this endpoint for real-time rendering or photorealistic capture; use Image to 3D Model when you need a mesh, textures, or an editable asset. Fixed cost: 30 credits per generation. Typical generation time is around 4 minutes.
## Request Parameters
### input
- **Type:** string
- **Required:** Required
Source image for Gaussian Splat generation. Accepts the following input types:**Choose exactly one** of the following — do not pass multiple types simultaneously.
- file_token — Upload an image via the File Upload API first, then pass the returned token.
Example: `file_abc123`
- URL — A publicly accessible direct link to an image.
Example: `https://example.com/photo.png`
- Supported formats: `PNG`, `JPEG`, `WebP`
- Max file size: **20 MB**
- Recommended resolution: at least **256 × 256 px**. Subject should be clearly visible with a clean background and minimal occlusion.
### model_seed
- **Type:** integer
- **Required:** Optional
Random seed for Gaussian Splat generation. Using the same seed with the same input produces an identical .splat result. If not set, a random seed is used each time.
## Request Example
### From URL
```bash
curl --request POST \
--url https://openapi.tripo3d.ai/v3/generation/image-to-splat \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"input": "https://example.com/photo.png"
}'
```
### From file token
```bash
curl --request POST \
--url https://openapi.tripo3d.ai/v3/generation/image-to-splat \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"input": "file_abc123"
}'
```
## Response Example
### Create task
```json
{
"code": 0,
"data": {
"task_id": "task_abc123"
}
}
```
### Task result
```json
{
"code": 0,
"data": {
"task_id": "task_abc123",
"type": "image_to_splat",
"status": "success",
"progress": 100,
"output": {
"model_url": "https://cdn.tripo3d.ai/output/scene.splat"
},
"credits_consumed": 30.00,
"created_at": "2026-04-28T12:00:00Z",
"completed_at": "2026-04-28T12:04:10Z"
}
}
```
http
Base URL: https://openapi.tripo3d.ai/v3
Endpoint:POST /generation/image-to-splat
Generate a 3D Gaussian Splat (.splat) from a single image. Gaussian Splatting is a modern 3D representation well-suited for high-quality real-time rendering and photorealistic scene reconstruction. The output .splat file can be loaded by mainstream Gaussian Splat viewers and renderers. Choose this endpoint for real-time rendering or photorealistic capture; use Image to 3D Model when you need a mesh, textures, or an editable asset. Fixed cost: 30 credits per generation. Typical generation time is around 4 minutes.
Note
This endpoint requires an API Key. Include it in the Authorization header as Bearer {api_key}.
This is an asynchronous API. After submitting the request, use the Task Query API to poll for results, or configure a Webhook to receive automatic notifications when the task completes.
Request Parameters
Request Body
inputstringRequired
Source image for Gaussian Splat generation. Accepts the following input types:
Choose exactly one of the following — do not pass multiple types simultaneously.
file_token — Upload an image via the File Upload API first, then pass the returned token. Example:file_abc123
URL — A publicly accessible direct link to an image. Example:https://example.com/photo.png
Notes
Supported formats: PNG, JPEG, WebP
Max file size: 20 MB
Recommended resolution: at least 256 × 256 px. Subject should be clearly visible with a clean background and minimal occlusion.
model_seedinteger
Random seed for Gaussian Splat generation. Using the same seed with the same input produces an identical .splat result. If not set, a random seed is used each time.
