Tripo3D H3.1 API Examples for PoYo

Focused server-side examples for building text-to-3D, image-to-3D, and multiview-to-3D workflows with Tripo3D H3.1 on PoYo.

Tripo3D H3.1 is useful for game prop candidates, product visualization assets, AR previews, and 3D concept workflows that need textured drafts quickly.

Try on PoYo | Get API Key | Docs | Pricing | Main Examples

What This Repo Covers

• Text-to-3D with tripo3d-h3.1-text-to-3d
• Image-to-3D with tripo3d-h3.1-image-to-3d
• Multiview-to-3D with tripo3d-h3.1-multiview-to-3d
• Async task flow with polling and webhooks
• cURL and Node.js backend examples

Quick Start

cp .env.example .env
export POYO_API_KEY="your-api-key"

Run the Node.js example:

cd node
npm start

Keep POYO_API_KEY on the server. Do not expose it in browser code, mobile apps, screenshots, or public logs.

Production Pattern

• Keep POYO_API_KEY on the server
• Submit a generation task
• Store data.task_id
• Poll status while testing
• Use callback_url webhooks in production

Models

This repo uses tripo3d-h3.1-text-to-3d, tripo3d-h3.1-image-to-3d, and tripo3d-h3.1-multiview-to-3d.

Examples

Path	What it covers
curl/generate.md	Copy-paste async submit request.
node/	Native Node.js backend example with polling.
docs/prompt-examples.md	Practical prompts for product workflows and creative tests.
docs/production-notes.md	Security and reliability notes before launch.
webhooks/express-webhook/	Minimal Express receiver for PoYo callbacks.

Run Checks

make check

On Windows:

./scripts/check.ps1

License

MIT