API Tripo H3.1

Tài liệu tham khảo API đầy đủ cho các mô hình tạo 3D Tripo H3.1 của Tripo3D AI.

Các biến thể mô hình

Mô hình	Mô tả
`tripo3d-h3.1-text-to-3d`	Tạo mô hình 3D từ mô tả bằng văn bản
`tripo3d-h3.1-image-to-3d`	Tạo mô hình 3D từ một hình ảnh
`tripo3d-h3.1-multiview-to-3d`	Tạo mô hình 3D từ hình ảnh ở nhiều góc nhìn

Điểm cuối

text
POST /api/v1/3d/task
GET /api/v1/3d/{task_id}

Tripo H3.1 chuyển văn bản thành 3D

Tham số bắt buộc

Tham số	Kiểu	Mô tả
`model_name`	string	Phải là `tripo3d-h3.1-text-to-3d`
`prompt`	string	Mô tả bằng văn bản về mô hình 3D cần tạo

Tham số tùy chọn

Tham số	Kiểu	Mặc định	Tùy chọn / Phạm vi	Mô tả
`negative_prompt`	string	-	Tối đa 1024 ký tự	Nội dung cần loại trừ khỏi kết quả được tạo
`texture`	boolean	`true`	`true`, `false`	Có tạo họa tiết bề mặt hay không
`pbr`	boolean	Giống `texture`	`true`, `false`	Có tạo vật liệu PBR hay không. Không thể là `true` khi `texture` là `false`
`texture_quality`	string	`standard`	`standard`, `detailed`	Chất lượng họa tiết bề mặt
`geometry_quality`	string	`standard`	`standard`, `detailed`	Chất lượng hình học
`auto_size`	boolean	`false`	`true`, `false`	Có tự động điều chỉnh tỷ lệ mô hình theo kích thước thực tế hay không
`quad`	boolean	`false`	`true`, `false`	Có tạo lưới tứ giác hay không

Yêu cầu mẫu

javascript
const response = await fetch('https://api.flaq.ai/api/v1/3d/task', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model_name: 'tripo3d-h3.1-text-to-3d',
    prompt: 'A cute cartoon robot with a round head',
    negative_prompt: 'blurry, deformed, extra limbs',
    texture: true,
    pbr: true,
    texture_quality: 'standard',
    geometry_quality: 'standard',
    auto_size: false,
    quad: false,
  }),
});

const result = await response.json();
console.log(result.data.task_id);

Tripo H3.1 chuyển hình ảnh thành 3D

Tham số bắt buộc

Tham số	Kiểu	Mô tả
`model_name`	string	Phải là `tripo3d-h3.1-image-to-3d`
`image_url`	string	URL của hình ảnh đầu vào duy nhất

Tham số tùy chọn

Tham số	Kiểu	Mặc định	Tùy chọn / Phạm vi	Mô tả
`texture_alignment`	string	`original_image`	`original_image`, `geometry`	Phương pháp căn chỉnh họa tiết bề mặt
`orientation`	string	`default`	`default`, `align_image`	Hướng của mô hình được tạo
`texture`	boolean	`true`	`true`, `false`	Có tạo họa tiết bề mặt hay không
`pbr`	boolean	Giống `texture`	`true`, `false`	Có tạo vật liệu PBR hay không. Không thể là `true` khi `texture` là `false`
`texture_quality`	string	`standard`	`standard`, `detailed`	Chất lượng họa tiết bề mặt
`geometry_quality`	string	`standard`	`standard`, `detailed`	Chất lượng hình học
`auto_size`	boolean	`false`	`true`, `false`	Có tự động điều chỉnh tỷ lệ mô hình theo kích thước thực tế hay không
`quad`	boolean	`false`	`true`, `false`	Có tạo lưới tứ giác hay không

Yêu cầu mẫu

javascript
const response = await fetch('https://api.flaq.ai/api/v1/3d/task', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model_name: 'tripo3d-h3.1-image-to-3d',
    image_url: 'https://example.com/object.png',
    texture_alignment: 'original_image',
    orientation: 'default',
    texture: true,
    pbr: true,
    texture_quality: 'standard',
    geometry_quality: 'standard',
    auto_size: false,
    quad: false,
  }),
});

const result = await response.json();
console.log(result.data.task_id);

Tripo H3.1 chuyển nhiều góc nhìn thành 3D

Tham số bắt buộc

Tham số	Kiểu	Mô tả
`model_name`	string	Phải là `tripo3d-h3.1-multiview-to-3d`
`images`	string[]	URL hình ảnh đầu vào theo thứ tự mặt trước, bên trái, mặt sau, bên phải. Cần ít nhất hai hình ảnh

Tham số tùy chọn

Tham số	Kiểu	Mặc định	Tùy chọn / Phạm vi	Mô tả
`texture_alignment`	string	`original_image`	`original_image`, `geometry`	Phương pháp căn chỉnh họa tiết bề mặt
`orientation`	string	`default`	`default`, `align_image`	Hướng của mô hình được tạo
`texture`	boolean	`true`	`true`, `false`	Có tạo họa tiết bề mặt hay không
`pbr`	boolean	Giống `texture`	`true`, `false`	Có tạo vật liệu PBR hay không. Không thể là `true` khi `texture` là `false`
`texture_quality`	string	`standard`	`standard`, `detailed`	Chất lượng họa tiết bề mặt
`geometry_quality`	string	`standard`	`standard`, `detailed`	Chất lượng hình học
`auto_size`	boolean	`false`	`true`, `false`	Có tự động điều chỉnh tỷ lệ mô hình theo kích thước thực tế hay không
`quad`	boolean	`false`	`true`, `false`	Có tạo lưới tứ giác hay không

Yêu cầu mẫu

javascript
const response = await fetch('https://api.flaq.ai/api/v1/3d/task', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model_name: 'tripo3d-h3.1-multiview-to-3d',
    images: [
      'https://example.com/front.png',
      'https://example.com/left.png',
      'https://example.com/back.png',
      'https://example.com/right.png',
    ],
    texture_alignment: 'original_image',
    orientation: 'default',
    texture: true,
    pbr: true,
    texture_quality: 'standard',
    geometry_quality: 'standard',
    auto_size: false,
    quad: false,
  }),
});

const result = await response.json();
console.log(result.data.task_id);

Định dạng phản hồi

Gửi tác vụ

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "e1688c0c-1a28-47e1-a638-34f04b70e9c0",
    "response_url": "https://api.flaq.ai/api/v1/3d/e1688c0c-1a28-47e1-a638-34f04b70e9c0",
    "task_status": "submitted"
  }
}

Truy vấn trạng thái tác vụ

javascript
const taskId = 'e1688c0c-1a28-47e1-a638-34f04b70e9c0';

const response = await fetch(`https://api.flaq.ai/api/v1/3d/${taskId}`, {
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});

const result = await response.json();
console.log(result.data.task_status);

Tác vụ đã hoàn tất

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "e1688c0c-1a28-47e1-a638-34f04b70e9c0",
    "response_url": "https://api.flaq.ai/api/v1/3d/e1688c0c-1a28-47e1-a638-34f04b70e9c0",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 200,
      "files": [
        {
          "url": "https://example.com/generated-model.glb"
        }
      ]
    }
  }
}

Các giá trị trạng thái tác vụ

submitted: Tác vụ đã được gửi
processing: Tác vụ đang được xử lý
succeed: Tác vụ đã hoàn tất thành công
failed: Tác vụ đã thất bại

API Tripo H3.1

Tài liệu tham khảo API đầy đủ cho các mô hình tạo 3D Tripo H3.1 của Tripo3D AI.

Các biến thể mô hình

Mô hình	Mô tả
`tripo3d-h3.1-text-to-3d`	Tạo mô hình 3D từ mô tả bằng văn bản
`tripo3d-h3.1-image-to-3d`	Tạo mô hình 3D từ một hình ảnh
`tripo3d-h3.1-multiview-to-3d`	Tạo mô hình 3D từ hình ảnh ở nhiều góc nhìn

Điểm cuối

text
POST /api/v1/3d/task
GET /api/v1/3d/{task_id}

Tripo H3.1 chuyển văn bản thành 3D

Tham số bắt buộc

Tham số	Kiểu	Mô tả
`model_name`	string	Phải là `tripo3d-h3.1-text-to-3d`
`prompt`	string	Mô tả bằng văn bản về mô hình 3D cần tạo

Tham số tùy chọn

Tham số	Kiểu	Mặc định	Tùy chọn / Phạm vi	Mô tả
`negative_prompt`	string	-	Tối đa 1024 ký tự	Nội dung cần loại trừ khỏi kết quả được tạo
`texture`	boolean	`true`	`true`, `false`	Có tạo họa tiết bề mặt hay không
`pbr`	boolean	Giống `texture`	`true`, `false`	Có tạo vật liệu PBR hay không. Không thể là `true` khi `texture` là `false`
`texture_quality`	string	`standard`	`standard`, `detailed`	Chất lượng họa tiết bề mặt
`geometry_quality`	string	`standard`	`standard`, `detailed`	Chất lượng hình học
`auto_size`	boolean	`false`	`true`, `false`	Có tự động điều chỉnh tỷ lệ mô hình theo kích thước thực tế hay không
`quad`	boolean	`false`	`true`, `false`	Có tạo lưới tứ giác hay không

Yêu cầu mẫu

javascript
const response = await fetch('https://api.flaq.ai/api/v1/3d/task', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model_name: 'tripo3d-h3.1-text-to-3d',
    prompt: 'A cute cartoon robot with a round head',
    negative_prompt: 'blurry, deformed, extra limbs',
    texture: true,
    pbr: true,
    texture_quality: 'standard',
    geometry_quality: 'standard',
    auto_size: false,
    quad: false,
  }),
});

const result = await response.json();
console.log(result.data.task_id);

Tripo H3.1 chuyển hình ảnh thành 3D

Tham số bắt buộc

Tham số	Kiểu	Mô tả
`model_name`	string	Phải là `tripo3d-h3.1-image-to-3d`
`image_url`	string	URL của hình ảnh đầu vào duy nhất

Tham số tùy chọn

Tham số	Kiểu	Mặc định	Tùy chọn / Phạm vi	Mô tả
`texture_alignment`	string	`original_image`	`original_image`, `geometry`	Phương pháp căn chỉnh họa tiết bề mặt
`orientation`	string	`default`	`default`, `align_image`	Hướng của mô hình được tạo
`texture`	boolean	`true`	`true`, `false`	Có tạo họa tiết bề mặt hay không
`pbr`	boolean	Giống `texture`	`true`, `false`	Có tạo vật liệu PBR hay không. Không thể là `true` khi `texture` là `false`
`texture_quality`	string	`standard`	`standard`, `detailed`	Chất lượng họa tiết bề mặt
`geometry_quality`	string	`standard`	`standard`, `detailed`	Chất lượng hình học
`auto_size`	boolean	`false`	`true`, `false`	Có tự động điều chỉnh tỷ lệ mô hình theo kích thước thực tế hay không
`quad`	boolean	`false`	`true`, `false`	Có tạo lưới tứ giác hay không

Yêu cầu mẫu

javascript
const response = await fetch('https://api.flaq.ai/api/v1/3d/task', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model_name: 'tripo3d-h3.1-image-to-3d',
    image_url: 'https://example.com/object.png',
    texture_alignment: 'original_image',
    orientation: 'default',
    texture: true,
    pbr: true,
    texture_quality: 'standard',
    geometry_quality: 'standard',
    auto_size: false,
    quad: false,
  }),
});

const result = await response.json();
console.log(result.data.task_id);

Tripo H3.1 chuyển nhiều góc nhìn thành 3D

Tham số bắt buộc

Tham số	Kiểu	Mô tả
`model_name`	string	Phải là `tripo3d-h3.1-multiview-to-3d`
`images`	string[]	URL hình ảnh đầu vào theo thứ tự mặt trước, bên trái, mặt sau, bên phải. Cần ít nhất hai hình ảnh

Tham số tùy chọn

Tham số	Kiểu	Mặc định	Tùy chọn / Phạm vi	Mô tả
`texture_alignment`	string	`original_image`	`original_image`, `geometry`	Phương pháp căn chỉnh họa tiết bề mặt
`orientation`	string	`default`	`default`, `align_image`	Hướng của mô hình được tạo
`texture`	boolean	`true`	`true`, `false`	Có tạo họa tiết bề mặt hay không
`pbr`	boolean	Giống `texture`	`true`, `false`	Có tạo vật liệu PBR hay không. Không thể là `true` khi `texture` là `false`
`texture_quality`	string	`standard`	`standard`, `detailed`	Chất lượng họa tiết bề mặt
`geometry_quality`	string	`standard`	`standard`, `detailed`	Chất lượng hình học
`auto_size`	boolean	`false`	`true`, `false`	Có tự động điều chỉnh tỷ lệ mô hình theo kích thước thực tế hay không
`quad`	boolean	`false`	`true`, `false`	Có tạo lưới tứ giác hay không

Yêu cầu mẫu

javascript
const response = await fetch('https://api.flaq.ai/api/v1/3d/task', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model_name: 'tripo3d-h3.1-multiview-to-3d',
    images: [
      'https://example.com/front.png',
      'https://example.com/left.png',
      'https://example.com/back.png',
      'https://example.com/right.png',
    ],
    texture_alignment: 'original_image',
    orientation: 'default',
    texture: true,
    pbr: true,
    texture_quality: 'standard',
    geometry_quality: 'standard',
    auto_size: false,
    quad: false,
  }),
});

const result = await response.json();
console.log(result.data.task_id);

Định dạng phản hồi

Gửi tác vụ

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "e1688c0c-1a28-47e1-a638-34f04b70e9c0",
    "response_url": "https://api.flaq.ai/api/v1/3d/e1688c0c-1a28-47e1-a638-34f04b70e9c0",
    "task_status": "submitted"
  }
}

Truy vấn trạng thái tác vụ

javascript
const taskId = 'e1688c0c-1a28-47e1-a638-34f04b70e9c0';

const response = await fetch(`https://api.flaq.ai/api/v1/3d/${taskId}`, {
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});

const result = await response.json();
console.log(result.data.task_status);

Tác vụ đã hoàn tất

json
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "e1688c0c-1a28-47e1-a638-34f04b70e9c0",
    "response_url": "https://api.flaq.ai/api/v1/3d/e1688c0c-1a28-47e1-a638-34f04b70e9c0",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 200,
      "files": [
        {
          "url": "https://example.com/generated-model.glb"
        }
      ]
    }
  }
}

Các giá trị trạng thái tác vụ

submitted: Tác vụ đã được gửi
processing: Tác vụ đang được xử lý
succeed: Tác vụ đã hoàn tất thành công
failed: Tác vụ đã thất bại