curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "tripo3d/p1/image-to-3d",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"texture": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Tripo3D
Tripo3D P1 Image to 3D
Turn a reference image into a 3D object with Tripo3D P1, with optional textures and control over polygon count.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "tripo3d/p1/image-to-3d",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"texture": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- Submit the request with
VIDGO_API_KEY. Atask_idis returned immediately. Keep it until the task reachesfinishedorfailed. - Use Query Task Status to retrieve the result. If you provide a
callback_url, Vidgo sends the result to your webhook when the task finishes or fails.
Tripo3D P1 Image to 3D
Turn a reference image into a 3D object with Tripo3D P1, with optional textures and control over polygon count.Available Models
- tripo3d/p1/image-to-3d - Generate a 3D model from an image.
Output Options
Face Limit
face_limit: Optional. Set the face-count limit. Integer from48to20000.
Key Features
- Generate a 3D model from an image.
- Accepts exactly 1 image in
image_urls. - Retrieve model assets and available previews or supporting files from the task result.
Advanced Parameters
Setmodel and optional callback_url at the request root. Place all workflow parameters, including output options, inside input.
Use the input fields listed below for this workflow. Provide a publicly accessible HTTP(S) image URL.
Image URLs
image_urls: Required. Provide publicly accessible image URLs. Supply exactly 1 item. Each item must be an HTTP(S) URL.
Texture
texture: Optional. Control texture generation. Usetrueorfalse. Default:true.
Model Seed
model_seed: Optional. Set the model-generation seed. Integer.
Output Files
- Read every item in the returned
filesarray. - Model assets use
file_type: "3d"; previews usefile_type: "image". - Supporting files use
file_type: "other". Preserve each returned file and itslabel,format,content_type,file_name, andfile_sizemetadata when present. - Use the
model_glbfile for 3D preview and thethumbnailfile as its cover image when these labels are present.
Authorizations
Use VIDGO_API_KEY.
Body
application/json
Set model and optional callback_url at the request root. Place the fields listed for this workflow inside input.