이미지를 멀티뷰로

POST /v3/generation/image-to-multiview

단일 이미지에서 다중 뷰 이미지를 생성합니다.

요청 매개변수

요청 헤더

매개변수	유형	필수	기본값	설명
Content-Type	문자열	예	-	`application/json`
Authorization	문자열	예	-	`Bearer {api_key}`

요청 본문

매개변수	유형	필수	기본값	설명
input	문자열	예	-	소스 이미지. `file_token` 또는 이미지 URL 지원

요청 예시

curl -X POST https://openapi.tripo3d.ai/v3/generation/image-to-multiview \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "https://example.com/character.png"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/image-to-multiview"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "https://example.com/character.png"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/generation/image-to-multiview";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "https://example.com/character.png"
  })
});

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

응답

성공반응

JSON

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

작업이 완료된 후 API 작업을 쿼리하여 다중 보기 출력을 검색합니다.

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123",
    "status": "success",
    "output": {
      "front_view_url": "https://cdn.tripo3d.ai/front.png",
      "left_view_url": "https://cdn.tripo3d.ai/left.png",
      "back_view_url": "https://cdn.tripo3d.ai/back.png",
      "right_view_url": "https://cdn.tripo3d.ai/right.png"
    }
  }
}

응답 필드

매개변수	유형	설명
code	정수	상태 코드. `0`는 성공을 나타냅니다.
data.task_id	문자열	생성 진행 상황 및 결과를 쿼리하는 데 사용되는 고유 작업 식별자
data.output.front_view_url	문자열	전면 이미지 URL
data.output.left_view_url	문자열	좌측면 이미지 URL
data.output.back_view_url	문자열	후방 이미지 URL
data.output.right_view_url	문자열	우측면 이미지 URL

오류 코드

HTTP 상태 코드	오류 코드	설명	추천
429	2000	생성 한도를 초과했습니다.	요청 빈도를 줄이고 나중에 다시 시도하세요.
400	2002	지원되지 않는 요청 매개변수	요청 본문 매개변수 이름 및 값 범위 확인
400	2003	입력 파일이 비어 있습니다.	`input`가 유효한 이미지 리소스를 가리키는지 확인하세요.
400	2004	지원되지 않는 파일 형식	지원되는 이미지 형식(PNG, JPEG, WebP)을 사용하세요.
400	2008	입력 내용이 콘텐츠 정책을 위반합니다.	입력 이미지 수정 및 정책 위반 콘텐츠 제거
403	2010	크레딧이 부족합니다.	크레딧을 추가하고 다시 시도하세요.