curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "tripo3d-h3.1-text-to-3d",
"input": {
"prompt": "A japanese samurai kabuto helmet with gold dragon ornament and red cord lacing",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard",
"quad": false
}
}
'{
"code": 200,
"data": {
"task_id": "<string>",
"status": "not_started",
"created_time": "2023-11-07T05:31:56Z"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Tripo3D
Tripo3D H3.1
The Tripo3D H3.1 API generates a high-detail 3D mesh from text, one image, or multiple views of the same object. Textures, PBR maps, quad topology, and standard or detailed geometry and texture quality can be requested.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "tripo3d-h3.1-text-to-3d",
"input": {
"prompt": "A japanese samurai kabuto helmet with gold dragon ornament and red cord lacing",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard",
"quad": false
}
}
'{
"code": 200,
"data": {
"task_id": "<string>",
"status": "not_started",
"created_time": "2023-11-07T05:31:56Z"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the result through the unified Query Task Status endpoint.
Models
- tripo3d-h3.1-text-to-3d - Generate a high-detail 3D model from a prompt
- tripo3d-h3.1-image-to-3d - Generate a 3D model from one object image
- tripo3d-h3.1-multiview-to-3d - Generate a 3D model from 2-4 views of the same object
Required parameters
- model:
tripo3d-h3.1-text-to-3d,tripo3d-h3.1-image-to-3d, ortripo3d-h3.1-multiview-to-3d - input.prompt: Required for
tripo3d-h3.1-text-to-3d - input.image_urls: Required for image models. Use exactly one item for image-to-3D; use 2-4 items for multiview-to-3D
Optional parameters
- negative_prompt: Text-to-3D only. Features to avoid
- face_limit: Target face count, from
1000to2000000 - texture: Whether to generate textures. Default is
true - pbr: Whether to generate PBR materials when textures are enabled
- model_seed, image_seed, texture_seed: Optional integer seeds
- texture_quality:
standardordetailed. Default isstandard - geometry_quality:
standardordetailed. Default isstandard - auto_size: Whether to auto-scale the model
- quad: Whether to generate quad mesh topology
- callback_url: Optional webhook URL for task completion notification
Output
The task result is returned as a file list. Available items may include:model_glbthumbnail- entries from
model_urls, such asglb,base_model, andpbr_model, when available
label, file_url, file_type, format, content_type, file_name, and file_size when available.
Notes
- Multiview inputs should show the same object from different angles.
- The API returns asynchronous task status. Poll the unified task status endpoint or use
callback_url.
Authorizations
All API endpoints require Bearer Token authentication.
Create an API key: sign in to PoYo, open Dashboard → API Key at poyo.ai/dashboard/api-key, and click to create a key.
Add it to the request header:
Authorization: Bearer YOUR_API_KEY
Body
application/json
Response
Task submitted successfully
Business status code. 200 means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with code: 400 in the body.
200: Success400: Invalid request parameters401: Missing or invalid API key402: Insufficient credits403: Permission denied404: Resource not found408: Request timeout429: Rate limit exceeded500: Internal server error502: Upstream service error503: Service unavailable
See Error Codes for details.
Available options:
200, 400, 401, 402, 403, 404, 408, 429, 500, 502, 503 Example:
200
Show child attributes
Show child attributes