AI3D API v2
Build and run a request.
Sign in with your AI3D account to use the playground. You can also connect with an API key for API clients and older accounts.
Need a key? Choose a prepaid package.
API playground
Turn a form into an API call.
Choose a model and source, adjust its settings, then inspect the JSON before you run it.
Available API credits—— reserved
1 · Configure
Generation request
One run creates one billable v2 job from your account credits.
Current models and request settings come from the v2 catalog.
Use a publicly accessible HTTPS URL.
Optional. Uploading does not start a paid generation.
Use public HTTPS PNG, JPEG, or WebP images of the same object. Front and at least one other view are required.
Retarget requires Tripo’s task ID for a rigged model. A public model-file URL cannot be used here, even if the file is already rigged. Select the completed AI3D Tripo Rig job that produced it.
Only your own succeeded Tripo jobs that this operation accepts are listed.
GLB, GLTF, FBX, OBJ or STL, up to 150 MB. AI3D does not upload 3D models.
Checks that the model can be rigged, then sets the rig type and rig model below.
Added to the model input as a prompt.
Review the Tencent HY-Motion license and Acceptable Use Policy. This model is unavailable in the European Union, United Kingdom, and South Korea, and its outputs cannot be used to improve another AI model. Enable the license acceptance setting below only if you agree and your use is in a permitted territory.
Saved with this generation and applied automatically to supported mesh outputs in the viewer.
Model settings
Choose a model to see its controls. Changes update the request preview.
Advanced settings JSON
Settings shown above are included here. You can add or edit fields as a JSON object; the API accepts up to 16 KiB.
Webhook (optional)
Must be a public HTTPS endpoint on port 443.
Provide a secret you generated. V2 stores it encrypted and signs job events with it.
Completed jobs have a public, unlisted viewer link. Anyone with that link can see the 3D output and its original image.
Loading live reservation estimate…—
Credits are reserved when you start the job.
Request preview
Request JSON
This is the body sent to POST /v2/jobs. Your API key is never included here.
JSON body
Loading…
Example cURL
Job result
Job status
Waiting for the API…
—
queuedContinue with this result