curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "hunyuan-3d/v3.1/rapid/text-to-3d",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"enable_pbr": true,
"enable_geometry": false
}
}
'{
"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>"
}Hunyuan3D
Hunyuan 3D v3.1 Rapid Text to 3D
Turn written object concepts into 3D models with Hunyuan 3D v3.1 Rapid, with an option to generate geometry for further modeling.
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": "hunyuan-3d/v3.1/rapid/text-to-3d",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"enable_pbr": true,
"enable_geometry": false
}
}
'{
"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.
Hunyuan 3D v3.1 Rapid Text to 3D
Turn written object concepts into 3D models with Hunyuan 3D v3.1 Rapid, with an option to generate geometry for further modeling.Available Models
- hunyuan-3d/v3.1/rapid/text-to-3d - Generate a 3D model from a text prompt.
Output Options
Enable Geometry
enable_geometry: Optional. Settruefor a geometry-only white model orfalsefor textured generation.
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 parameters listed below.
Prompt
prompt: Required. Describe the desired 3D object. Length: 1-200 characters.- Use a nonblank string when providing this parameter.
PBR
enable_pbr: Optional. Settrueto generate PBR materials in textured mode. Geometry-only generation takes precedence over this setting.
Output Files
- Read every item in the returned
filesarray. - Model assets use
file_type: "3d"; previews usefile_type: "image". - Additional artifacts may use
file_type: "other". Retain returned textures, material files, and file metadata.
Authorizations
Use VIDGO_API_KEY.
Body
application/json
Place model and callback_url at the request root and generation parameters inside input.