Tripo 3D model generation

Step 1: Create a task and get the task ID

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/3d-generation' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "Tripo/Tripo-P1.0",
    "input": {
        "prompt": "A cute cat"
    },
    "parameters": {
        "texture_quality": "standard"
    }
}'

Returns a task_id. Example: 0385dc79-5ff8-4d82-bcb6-xxxxxx.

Step 2: Query results by task ID

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Task status flow: PENDING (queued) → RUNNING (processing) → SUCCEEDED (completed) / FAILED (failed).

3D generation typically takes several minutes. We recommend a polling interval of 15 seconds. To use event notifications instead of polling, see Configure asynchronous task callbacks.

Sample output

{
    "request_id": "c1209113-8437-424f-a386-xxxxxx",
    "output": {
        "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
        "task_status": "SUCCEEDED",
        "results": [
            {
                "pbr_model_url": "https://openapi.cdn.tripo3d.com/xxxx.glb?auth_key=xxxx",  // PBR 3D model (GLB), expires in 2 hours
                "rendered_image_url": "https://openapi.cdn.tripo3d.com/xxxx.webp?auth_key=xxxx"  // Rendered preview image, expires in 2 hours
            }
        ]
        ...
    },
    ...
}

Text-to-3D

Pass a text prompt via prompt to describe the 3D model you want to generate. Supports multiple languages (Chinese, English, etc.).

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/3d-generation' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "Tripo/Tripo-P1.0",
    "input": {
        "prompt": "A red sports car"
    },
    "parameters": {
        "texture_quality": "standard"
    }
}'

Single-image-to-3D

Pass the URL of a single image via image to generate a 3D model from it.

Image requirements: JPEG or PNG, 20–6,000 pixels in width and height (recommended > 256 pixels), up to 20 MB.

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/3d-generation' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "Tripo/Tripo-P1.0",
    "input": {
        "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/cfbxhg/tripo-single.jpg"
    },
    "parameters": {
        "texture_quality": "standard"
    }
}'

Multi-image-to-3D

Pass a URL list of 2–4 multi-angle images via images to generate a higher-fidelity 3D model. Images do not need to have the same resolution or aspect ratio. Each image must meet the same format requirements as single-image-to-3D.

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/3d-generation' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "Tripo/Tripo-P1.0",
    "input": {
        "images": [
            { "type": "png", "file_token": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/liafix/tripo-images-1.png" },
            { "type": "png", "file_token": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/slgluy/tripo-images-2.png" },
            { "type": "png", "file_token": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/zjqhyn/tripo-images-3.png" },
            { "type": "png", "file_token": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/mqfzww/tripo-images-4.png" }
        ]
    },
    "parameters": {
        "texture_quality": "standard"
    }
}'

Texture quality

Texture is the image layer applied to the surface of a 3D model that defines its visual detail. Use parameters.texture_quality to control texture quality:

• standard: Default. Standard-definition texture, suitable for most use cases.

• detailed: High-definition texture for fine surface details.

"parameters": {
    "texture_quality": "standard"
}

"parameters": {
    "texture": false,
    "pbr": false
}

Geometry quality

Only supported by Tripo/Tripo-H3.1. Use parameters.geometry_quality to control geometry quality:

• standard: Default. Up to 1,500,000 polygons.

• ultra: Ultra-high quality. Up to 2,000,000 polygons.

Can I pass prompt, image, and images at the same time?

No. The three fields are mutually exclusive. Each request can use only one generation mode. Passing multiple fields causes the request to fail.