빠른 시작

# 빠른 시작 15분 안에 Tripo API를 시작하고 처음부터 첫 번째 3D 모델을 생성하세요. ## 1. API Key를 받으세요 [Tripo 콘솔](https://platform.tripo3d.ai)로 이동하여 계정을 만든 다음 "API Keys" 페이지를 열어 API Key를 만듭니다. ## 2. 첫 번째 요청 보내기 텍스트 설명에서 3D 모델을 생성합니다. ### curl ```bash curl -X POST https://openapi.tripo3d.ai/v3/generation/text-to-model \ -H "Content-Type: application/json" \ -H "Authorization: Bearer {api_key}" \ -d '{ "prompt": "a cute cat", "model": "tripo-v3.1" }' ``` 성공 응답: ```json { "code": 0, "data": { "task_id": "task_abc123" } } ``` ## 3. 작업 결과 조회 3D 생성은 비동기 작업으로 실행됩니다. 반환된 `task_id`를 사용하여 작업 상태를 폴링합니다. ```bash curl -X GET https://openapi.tripo3d.ai/v3/tasks/task_abc123 \ -H "Authorization: Bearer {api_key}" ``` `status`가 `success`이면 작업이 완료됩니다. ```json { "code": 0, "data": { "task_id": "task_abc123", "type": "text_to_model", "status": "success", "progress": 100, "output": { "model_url": "https://...", "rendered_image_url": "https://..." } } } ``` ## 4. 모델 다운로드 응답의 `output.model_url`에서 GLB 3D 모델 파일을 다운로드합니다. Blender, Unity, Three.js 등의 도구에서 직접 사용할 수 있습니다. ## 완전한 예 ### Python ```python import time import requests API_KEY = "your_api_key_here" BASE_URL = "https://openapi.tripo3d.ai/v3" headers = { "Content-Type": "application/json", "Authorization": f"Bearer {API_KEY}" } # 1. Create a text-to-3D task response = requests.post( f"{BASE_URL}/generation/text-to-model", headers=headers, json={ "prompt": "a cute cat", "model": "tripo-v3.1" } ) task_id = response.json()["data"]["task_id"] print(f"Task created: {task_id}") # 2. Poll until the task is complete while True: response = requests.get( f"{BASE_URL}/tasks/{task_id}", headers={"Authorization": f"Bearer {API_KEY}"} ) task = response.json()["data"] status = task["status"] progress = task.get("progress", 0) print(f"Status: {status}, progress: {progress}%") if status == "success": model_url = task["output"]["model_url"] print(f"Model download URL: {model_url}") break elif status in ("failed", "cancelled", "banned"): print(f"Task failed: {status}") break time.sleep(2) # 3. Download the model file if status == "success": model_data = requests.get(model_url) with open("model.glb", "wb") as f: f.write(model_data.content) print("Model saved as model.glb") ``` ### JavaScript ```javascript const API_KEY = "your_api_key_here"; const BASE_URL = "https://openapi.tripo3d.ai/v3"; async function generateModel() { // 1. Create a text-to-3D task const createResponse = await fetch(`${BASE_URL}/generation/text-to-model`, { method: "POST", headers: { "Content-Type": "application/json", "Authorization": `Bearer ${API_KEY}` }, body: JSON.stringify({ prompt: "a cute cat", model: "tripo-v3.1" }) }); const { data: { task_id } } = await createResponse.json(); console.log(`Task created: ${task_id}`); // 2. Poll until the task is complete while (true) { const pollResponse = await fetch(`${BASE_URL}/tasks/${task_id}`, { headers: { "Authorization": `Bearer ${API_KEY}` } }); const { data: task } = await pollResponse.json(); const { status, progress = 0 } = task; console.log(`Status: ${status}, progress: ${progress}%`); if (status === "success") { console.log(`Model download URL: ${task.output.model_url}`); return task.output; } if (["failed", "cancelled", "banned"].includes(status)) { throw new Error(`Task failed: ${status}`); } await new Promise(resolve => setTimeout(resolve, 2000)); } } generateModel().catch(console.error); ```

-cmd">curl -X POST https://openapi.tripo3d.ai/v3/generation/text class="hl-flag">-to-model \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer " \
  -d '{
    "prompt": "a cute cat",
    "model": "v3.1-20260211"}'

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}

-cmd">curl -X GET https://openapi.tripo3d.ai/v3/tasks/{task_id} \
  -H "Authorization: Bearer "

{
  "code": 0,
  "data": {
    "task_id": "task_abc123",
    "type": "text_to_model",
    "status": "success",
    "progress": 100,
    "output": {
      "model_url": "https://...",
      "rendered_image_url": "https://..."}
  }
}

import requests, time

HEADERS = {"Authorization": "Bearer ", "Content-Type": "application/json"}

def poll(task_id):
    while True:
        r = requests.get(f"https://openapi.tripo3d.ai/v3/tasks/{task_id}", headers=HEADERS).json()
        if r["data"]["status"] == "success": return r["data"]
        if r["data"]["status"] in ("failed","cancelled"): raise Exception(r["data"])
        time.sleep(2)

# Step 1 — Generate model
task_id = requests.post("https://openapi.tripo3d.ai/v3/generation/image-to-model",
    headers=HEADERS, json={"file_token":"","model":"P1-20260311","face_limit":5000}
).json()["data"]["task_id"]
poll(task_id)

# Step 2 — Rig check
rig_type = requests.post("https://openapi.tripo3d.ai/v3/animations/rig-check",
    headers=HEADERS, json={"input": task_id}).json()["data"]["rig_type"]

# Step 3 — Rig
rig_id = requests.post("https://openapi.tripo3d.ai/v3/animations/rig",
    headers=HEADERS, json={"input":task_id,"rig_type":rig_type,"spec":"mixamo"}
).json()["data"]["task_id"]
poll(rig_id)

# Step 4 — Retarget animations
anim_id = requests.post("https://openapi.tripo3d.ai/v3/animations/retarget",
    headers=HEADERS, json={"input":rig_id,"animations":["preset:walk","preset:idle","preset:run"]}
).json()["data"]["task_id"]
result = poll(anim_id)
print("Animated GLBs:", result["output"]["model_urls"])