Blog

Hướng Dẫn Toàn Diện Lập Trình Viên Sử Dụng Tripo 3D API

Herve Kom

20 tháng 1 2026

Hướng Dẫn Toàn Diện Lập Trình Viên Sử Dụng Tripo 3D API

Khả năng tạo mô hình 3D từ mô tả văn bản hoặc hình ảnh đã thay đổi cách các nhà phát triển xây dựng ứng dụng cho game, thương mại điện tử, thực tế ảo và trực quan hóa kiến trúc. API Tripo 3D cung cấp một cách đơn giản để tích hợp tính năng tạo mô hình 3D được hỗ trợ bởi AI vào các ứng dụng của bạn mà không yêu cầu chuyên môn sâu về mô hình 3D.

💡
Bạn muốn một công cụ kiểm thử API tuyệt vời giúp tạo ra Tài liệu API đẹp mắt?

Bạn muốn một nền tảng tích hợp, tất cả trong một để đội ngũ phát triển của bạn làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng tất cả các yêu cầu của bạn và thay thế Postman với mức giá phải chăng hơn nhiều!

nút

Hướng dẫn này sẽ đi qua mọi thứ bạn cần để triển khai API Tripo 3D, từ thiết lập ban đầu đến triển khai sản phẩm.

API Tripo 3D là gì?

API Tripo 3D chuyển đổi các lời nhắc văn bản hoặc hình ảnh 2D thành các mô hình 3D sẵn sàng cho sản xuất thông qua các thuật toán AI tiên tiến. Dịch vụ này xử lý các quy trình học máy phức tạp ở phía sau, cung cấp các điểm cuối REST đơn giản mà các nhà phát triển có thể tích hợp trong vài phút.

Bạn có thể truy cập và sử dụng API Tripo 3D với chi phí thấp tại Hypereal AI.

Hypereal AI

Nền tảng này hỗ trợ ba chế độ tạo chính:

Các mô hình được tạo ra có thể xuất dưới các định dạng chuẩn bao gồm GLB, GLTF, FBX và OBJ, giúp chúng tương thích với hầu hết phần mềm 3D và công cụ trò chơi.

Bắt đầu: Xác thực và Thiết lập

Bước 1: Tạo khóa API của bạn

Trước khi thực hiện bất kỳ lệnh gọi API nào, bạn cần thông tin xác thực:

  1. Truy cập trang tài liệu nền tảng Tripo 3D

2. Nhấp vào "Generate New API Key" (Tạo khóa API mới)

3. Sao chép khóa của bạn ngay lập tức (nó bắt đầu bằng tsk_)

4. Lưu trữ nó an toàn, bạn không thể lấy lại nó sau khi đóng cửa sổ

Lưu ý bảo mật: Không bao giờ tiết lộ khóa API trong mã phía máy khách hoặc kho lưu trữ công khai. Sử dụng biến môi trường hoặc các dịch vụ quản lý bí mật an toàn.

Bước 2: Cài đặt Python SDK (Tùy chọn)

Mặc dù bạn có thể sử dụng trực tiếp API REST với bất kỳ máy khách HTTP nào, Python SDK chính thức giúp đơn giản hóa việc tích hợp:

pip install tripo3d

SDK xử lý xác thực, thăm dò tác vụ không đồng bộ và tải xuống tệp tự động.

Bước 3: Xác minh thiết lập của bạn

Kiểm tra xác thực của bạn bằng yêu cầu cURL cơ bản này:

export TRIPO_API_KEY="tsk_your_actual_key_here"

curl https://api.tripo3d.ai/v2/openapi/task \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer ${TRIPO_API_KEY}" \
  -d '{"type": "text_to_model", "prompt": "a simple wooden chair"}'

Một phản hồi thành công sẽ trả về một ID tác vụ, cho biết xác thực của bạn hoạt động chính xác.

Phương pháp 1: Tạo mô hình 3D từ văn bản

Triển khai cơ bản

Tạo 3D từ văn bản chuyển đổi các mô tả ngôn ngữ tự nhiên thành các đối tượng 3D. Điều này hoạt động tốt để tạo tài sản từ các mô tả khái niệm.

Ví dụ Python SDK:

import asyncio
from tripo3d import TripoClient, TaskStatus

async def generate_from_text():
    async with TripoClient(api_key="YOUR_API_KEY") as client:
        # Gửi tác vụ tạo
        task_id = await client.text_to_model(
            prompt="a vintage leather armchair with wooden legs",
            negative_prompt="low quality, blurry, distorted",
            model_version="v2.5"
        )

        print(f"Task submitted: {task_id}")

        # Chờ hoàn thành
        task = await client.wait_for_task(task_id, verbose=True)

        # Tải xuống kết quả
        if task.status == TaskStatus.SUCCESS:
            files = await client.download_task_models(task, "./output")
            for model_type, path in files.items():
                print(f"Downloaded {model_type}: {path}")
        else:
            print(f"Task failed: {task.status}")

asyncio.run(generate_from_text())

Ví dụ API REST:

curl -X POST https://api.tripo3d.ai/v2/openapi/task \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer ${TRIPO_API_KEY}" \
  -d '{
    "type": "text_to_model",
    "prompt": "a vintage leather armchair with wooden legs",
    "negative_prompt": "low quality, blurry, distorted",
    "model_version": "v2.5"
  }'

Hiểu các tham số

Tham số Loại Bắt buộc Mô tả
prompt string Có Mô tả chi tiết về mô hình 3D mong muốn
negative_prompt string Không Các đặc điểm cần tránh trong quá trình tạo
model_version string Không Phiên bản API (mặc định: mới nhất)

Mẹo thiết kế prompt

Phương pháp 2: Tạo mô hình 3D từ hình ảnh

Chuyển đổi một hình ảnh

Chuyển đổi một bức ảnh hoặc hình minh họa thành mô hình 3D. Điều này hoạt động tốt nhất với hình ảnh rõ ràng, đủ ánh sáng, hiển thị đối tượng từ một góc trực diện.

Ví dụ Python SDK:

import asyncio
from tripo3d import TripoClient, TaskStatus

async def generate_from_image():
    async with TripoClient(api_key="YOUR_API_KEY") as client:
        task_id = await client.image_to_model(
            image="./path/to/product-photo.jpg",
            texture_quality="high",
            auto_scale=True,
            face_limit=50000
        )

        print(f"Processing image: {task_id}")

        task = await client.wait_for_task(task_id, verbose=True)

        if task.status == TaskStatus.SUCCESS:
            files = await client.download_task_models(task, "./models")
            print(f"Model saved to: {files}")

asyncio.run(generate_from_image())

Các tham số nâng cao

Tham số Loại Mặc định Mô tả
texture_seed số nguyên Ngẫu nhiên Seed để tạo họa tiết có thể tái tạo
auto_scale boolean False Tự động điều chỉnh tỷ lệ mô hình theo kích thước thực tế
quad boolean False Tạo lưới tứ giác (+$0.05 mỗi tác vụ)
texture_quality string "original_image" Ưu tiên căn chỉnh họa tiết
orientation string "default" Đặt thành "align_image" để tự động xoay
face_limit số nguyên Biến thiên Kiểm soát số lượng đa giác để tối ưu hóa

Tạo từ nhiều góc nhìn

Để có kết quả chất lượng cao hơn, hãy cung cấp nhiều góc độ của cùng một đối tượng:

async def generate_from_multiview():
    async with TripoClient(api_key="YOUR_API_KEY") as client:
        task_id = await client.multiview_to_model(
            images=[
                "./front-view.jpg",
                "./side-view.jpg",
                "./top-view.jpg"
            ],
            texture_quality="high"
        )

        task = await client.wait_for_task(task_id, verbose=True)

        if task.status == TaskStatus.SUCCESS:
            files = await client.download_task_models(task, "./output")

Việc tạo từ nhiều góc nhìn tạo ra hình học và chi tiết họa tiết tốt hơn đáng kể so với chuyển đổi một hình ảnh.

Hiểu về trạng thái tác vụ và thăm dò

API Tripo 3D xử lý các yêu cầu không đồng bộ. Sau khi gửi một tác vụ, bạn sẽ thăm dò để hoàn thành thay vì chặn.

Vòng đời tác vụ

  1. Submitted (Đã gửi): Tác vụ được chấp nhận và đưa vào hàng đợi
  2. Processing (Đang xử lý): Mô hình AI đang tạo đầu ra 3D
  3. Success (Thành công): Mô hình sẵn sàng để tải xuống
  4. Failed (Thất bại): Quá trình tạo gặp lỗi

Thăm dò thủ công (API REST)

curl https://api.tripo3d.ai/v2/openapi/task/{task_id} \
  -H "Authorization: Bearer ${TRIPO_API_KEY}"

Cấu trúc phản hồi:

{
  "code": 0,
  "data": {
    "task_id": "abc123",
    "status": "success",
    "output": {
      "model": "https://download-url/model.glb",
      "pbr_model": "https://download-url/model-pbr.glb"
    }
  }
}

Thăm dò tự động (Python SDK)

SDK xử lý việc thăm dò tự động:

task = await client.wait_for_task(
    task_id,
    verbose=True,  # Hiển thị cập nhật tiến độ
    timeout=300    # Thời gian chờ tối đa tính bằng giây
)

Hệ thống giá và tín dụng

Tripo sử dụng mô hình giá dựa trên tín dụng, trong đó các hoạt động khác nhau tiêu thụ lượng tín dụng khác nhau.

Các gói giá

Gói Giá Tín dụng hàng tháng Tác vụ đồng thời
Basic Miễn phí 300 1
Professional $15.90/tháng* 3,000 10
Advanced $39.90/tháng* 8,000 15

*Thanh toán hàng năm: giảm 20% ($190.80/năm cho Professional, $478.80/năm cho Advanced)

Chi phí tín dụng

Mẹo tối ưu hóa chi phí

Xử lý lỗi và các phương pháp hay nhất

Xử lý lỗi API một cách khéo léo

from tripo3d import TripoClient, TripoAPIError

async def safe_generation():
    try:
        async with TripoClient(api_key="YOUR_API_KEY") as client:
            task_id = await client.text_to_model(
                prompt="a detailed spaceship"
            )
            task = await client.wait_for_task(task_id)

            if task.status == TaskStatus.SUCCESS:
                files = await client.download_task_models(task, "./output")
                return files
            else:
                print(f"Generation failed: {task.status}")
                return None

    except TripoAPIError as e:
        if e.status_code == 401:
            print("Authentication failed. Check your API key.")
        elif e.status_code == 429:
            print("Rate limit exceeded. Wait before retrying.")
        elif e.status_code >= 500:
            print("Server error. Retry after a delay.")
        else:
            print(f"API error: {e}")
        return None

Các phương pháp hay nhất trong sản xuất

  1. Thực hiện logic thử lại cho các lỗi tạm thời (lỗi cấp 500)
  2. Đặt thời gian chờ thích hợp dựa trên độ phức tạp của tác vụ
  3. Giám sát việc sử dụng tín dụng để ngăn chặn gián đoạn dịch vụ
  4. Xác thực đầu vào trước khi gửi các hoạt động tốn kém
  5. Lưu trữ ID tác vụ để gỡ lỗi và kiểm tra
  6. Sử dụng webhook (nếu có) thay vì thăm dò tích cực

Giới hạn tỷ lệ

Tuân thủ giới hạn tác vụ đồng thời dựa trên gói của bạn. Vượt quá giới hạn sẽ dẫn đến lỗi 429:

from asyncio import Semaphore

async def batch_generate(prompts, max_concurrent=10):
    semaphore = Semaphore(max_concurrent)

    async def generate_with_limit(prompt):
        async with semaphore:
            async with TripoClient(api_key="YOUR_API_KEY") as client:
                task_id = await client.text_to_model(prompt=prompt)
                return await client.wait_for_task(task_id)

    tasks = [generate_with_limit(p) for p in prompts]
    return await asyncio.gather(*tasks)

Tích hợp với các framework phổ biến

Ứng dụng web Flask

from flask import Flask, request, jsonify
from tripo3d import TripoClient
import asyncio

app = Flask(__name__)

@app.route('/generate-3d', methods=['POST'])
def generate_model():
    data = request.json
    prompt = data.get('prompt')

    if not prompt:
        return jsonify({'error': 'Prompt required'}), 400

    async def generate():
        async with TripoClient(api_key="YOUR_API_KEY") as client:
            task_id = await client.text_to_model(prompt=prompt)
            return {'task_id': task_id}

    result = asyncio.run(generate())
    return jsonify(result)

@app.route('/check-status/')
def check_status(task_id):
    async def get_status():
        async with TripoClient(api_key="YOUR_API_KEY") as client:
            task = await client.get_task(task_id)
            return {'status': task.status}

    result = asyncio.run(get_status())
    return jsonify(result)

Ví dụ Node.js Express

const express = require('express');
const axios = require('axios');
const app = express();

app.post('/generate', async (req, res) => {
  const { prompt } = req.body;

  try {
    const response = await axios.post(
      'https://api.tripo3d.ai/v2/openapi/task',
      {
        type: 'text_to_model',
        prompt: prompt
      },
      {
        headers: {
          'Authorization': `Bearer ${process.env.TRIPO_API_KEY}`,
          'Content-Type': 'application/json'
        }
      }
    );

    res.json({ task_id: response.data.data.task_id });
  } catch (error) {
    res.status(500).json({ error: error.message });
  }
});

Quản lý tích hợp API với Apidog

Các ứng dụng phức tạp thường tích hợp nhiều API cùng một lúc. Việc quản lý xác thực, kiểm thử các điểm cuối và giám sát hiệu suất trên các dịch vụ khác nhau trở nên khó khăn.

Apidog cung cấp quản lý API thống nhất cho các nhà phát triển làm việc với API Tripo 3D và các dịch vụ khác:

Các tính năng chính:

Nhập các yêu cầu API Tripo 3D của bạn vào Apidog, lưu chúng dưới dạng mẫu và thực hiện chúng chỉ với một cú nhấp chuột. Giám sát các mẫu tiêu thụ tín dụng và xác định các cơ hội tối ưu hóa thông qua phân tích tích hợp sẵn.

nút

Kết luận

API Tripo 3D loại bỏ các rào cản kỹ thuật để tích hợp tính năng tạo mô hình 3D được hỗ trợ bởi AI vào các ứng dụng. Giao diện REST đơn giản và Python SDK chính thức cho phép các nhà phát triển thêm khả năng tạo 3D từ văn bản và hình ảnh trong vài giờ thay vì vài tuần.

Bắt đầu với gói Basic miễn phí để tạo nguyên mẫu tích hợp của bạn. Kiểm thử các kiểu prompt và đầu vào hình ảnh khác nhau để hiểu chất lượng đầu ra. Giám sát các mẫu tiêu thụ tín dụng trước khi cam kết với các gói trả phí.

Mô hình xử lý không đồng bộ của nền tảng mở rộng tốt cho khối lượng công việc sản xuất, trong khi các định dạng xuất chuẩn đảm bảo khả năng tương thích với các quy trình 3D và công cụ trò chơi hiện có.

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API

Đăng ký miễn phíTải xuống