curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "tripo3d/p1/text-to-3d",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"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 Text to 3D
Create 3D objects from text with Tripo3D P1, with optional textures and a compact mesh budget for props and scene assets.
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/text-to-3d",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"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 Text to 3D
Create 3D objects from text with Tripo3D P1, with optional textures and a compact mesh budget for props and scene assets.Available Models
- tripo3d/p1/text-to-3d - Generate a 3D model from a text prompt.
Output Options
Face Limit
face_limit: Optional. Set the face-count limit. Integer from48to20000.
Key Features
- Generate a 3D model from a text prompt.
- 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.
Prompt
prompt: Required. Describe the desired 3D object. Length: 1-1,024 characters.- Provide a non-empty string describing the object.
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.