Create a 3D generation task (text/image/multiview to 3D). The "type" field selects the model and request shape; parameters vary per model.
All API requests must be authenticated using a Bearer token in the Authorization header. Please ensure your API key is active.Authorization: Bearer sk-xxxxxx
Due to parameter differences across provider models, we recommend referring to the complete form parameter instructions during the specific model trial. The form view intuitively shows parameter types, and the JSON view reveals the exact parameters requested.
type*stringTripo task type. Acts as the model identifier and selects the request shape: text_to_model / image_to_model / multiview_to_model / refine_model / text_to_image / generate_image / generate_multiview_image / edit_multiview_image.
prompt?stringText prompt. Required for text_to_model / text_to_image.
file?objectSingle input image for image_to_model. { type: jpg|png|webp, url }.
type?stringurl?stringfiles?arrayPositional multiview images for multiview_to_model: [front, left, back, right]. Use {} to skip a non-front slot.
model_version?stringTripo model version, e.g. v3.0-20250812.
face_limit?integerTarget face count of the generated mesh.
texture?booleanWhether to generate texture.
pbr?booleanWhether to generate PBR materials.
texture_quality?stringTexture quality.
quad?booleanOutput quad-topology mesh instead of triangles.
auto_size?booleanAuto-scale the model to real-world size.
style?stringStylization preset.
draft_model_task_id?stringSource task id referenced by refine_model.
original_task_id?stringSource task id referenced by multiview_to_model / edit_multiview_image.
code?integerdata?objecttask_id?stringSystem task id; poll it via GET /tripo/v2/openapi/task/{task_id}.
error?objectParameter description for Error
message?stringError Message
type?stringError Type
param?stringRelated Parameters
code?stringError Code