이미지를 3D 모델로

사용 가능

이미지나 프롬프트를 넣으면 텍스처가 입혀진 3D 모델이 나옵니다: GLB, FBX, 썸네일. 리깅할 캐릭터나 소품을 만드세요.

$0.325부터GLB + FBX · 캐릭터와 소품 · PBR 텍스처

이미지를 3D 모델로

$0.325부터

입력

설명prompt만들 것을 말로 설명.

80 / 600

종류kindcharacter 또는 prop.

무기, 모자, 가구 같은 사물. 리깅 없음.

품질quality표준 또는 고정밀.

엔진engine실행할 3D 엔진(둘 이상일 때만 전송).

표준 3D × 소품표준 3D × 소품

예시

출력 예시이 프롬프트로 만듦

드래그해서 돌리고, 스크롤해서 확대

GLB 썸네일 FBX

이 모델에 리깅 추가

3D 파이프라인 작동 방식

우리가 직접 만드는 게임의 캐릭터 제작에 쓰는 것과 같은 단계입니다.

01T포즈 확인이미지를 빠르게 확인합니다. 단색 배경에 입을 다문 무표정의 엄격한 정면 T포즈가 아니면 같은 캐릭터로 그렇게 다시 그립니다. 팔을 벌리면 손이 깔끔하게 나옵니다.
023D 모델T포즈 이미지로 만드는 텍스처 입힌 게임용 메시. PBR 머티리얼이며 구워진 조명은 제거합니다. 캐릭터와 소품은 각자 삼각형 예산이 있습니다.
03리깅캐릭터가 움직일 수 있도록 뼈대를 맞추고, 원하면 걷기·달리기 클립도 만듭니다. 게임 엔진용 FBX와 웹용 GLB를 받습니다.

세 단계를 한 번에 호출하기:3D 캐릭터

코드에서 이미지를 3D 모델로 호출하기

3D 도구마다 엔드포인트가 따로 있습니다. 호출하면 작업이 반환되니 끝날 때까지 조회하세요. 실패한 실행은 청구되지 않습니다.

POSThttps://api.opennan.com/v1/3d/models

POST/v1/3d/characters이미지나 프롬프트를 리깅된 캐릭터로.
POST/v1/3d/tpose어떤 캐릭터 이미지든 정면 T포즈로.
POST/v1/3d/rig휴머노이드 모델을 리깅된 FBX와 GLB로.
GET/v1/tasks/{id}진행 상황 및 출력 파일.
GET/v1/models?category=3d3D 엔진과 품질 등급, 가격 포함

API 키 받기
콘솔에서 키를 만드세요. 플레이그라운드와 같은 잔액을 씁니다.
키 만들기

첫 요청 보내기

플레이그라운드가 보내는 것과 같은 요청입니다. OPENNAN_KEY에 키를 넣으세요.

curl https://api.opennan.com/v1/3d/models \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"a wooden treasure chest with gold trim","kind":"prop","quality":"standard","engine":"opennan-3d-studio"}'

# Then poll until "status" is "succeeded" or "failed":
curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"

작업 확인하기
호출하면 바로 작업 ID가 돌아옵니다. 끝날 때까지 작업을 확인하세요:
GEThttps://api.opennan.com/v1/tasks/{id}
queued
워커 대기 중
running
생성 중
succeeded
완료: outputs[].url에 파일이 있습니다
failed
실패: 요금이 청구되지 않습니다

오류와 해결 방법

401키가 없거나 틀림
콘솔에서 만든 키를 Authorization: Bearer 헤더로 보내세요.
402잔액 부족
결제 메뉴에서 잔액을 충전한 뒤 같은 호출을 다시 보내세요.
400받을 수 없는 값
error.message에 필드 이름이 나옵니다. 파라미터 표의 값을 쓰세요.
429요청이 너무 많음
몇 초 기다렸다가 다시 시도하고, 429가 반복되면 더 오래 기다리세요.

AI 앱에 Opennan 추가하기

한 번 설치하면 AI가 Opennan의 모든 도구를 씁니다: 영상, 이미지, 채팅, 음성, 음악, 효과음, 3D, 자막, 더빙. 사용하는 앱을 고르고 단계를 따라 하세요.

MCP 서버https://api.opennan.com/v1/mcp

Codex CLI, Codex 앱, Codex IDE 확장에서 모두 작동합니다(~/.codex/config.toml 공유). 앱이나 IDE가 OPENNAN_KEY를 못 읽으면 키를 넣은 config.toml 방식을 쓰세요. Codex는 도구를 호출하기 전에 묻습니다. 승인하면 계속됩니다.

API 키 받기
콘솔에서 키를 만드세요. sk-로 시작하며 웹사이트와 같은 잔액을 씁니다.
키 만들기

키를 OPENNAN_KEY로 저장

# macOS / Linux (zsh shown; bash: ~/.bashrc)
echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

# Windows (PowerShell), then open a new terminal
setx OPENNAN_KEY "sk-..."

3
Opennan 플러그인 설치: 서버와 함께 모델 선택, 가격 확인, 결과 대기를 AI에게 알려 주는 스킬이 들어 있습니다
```
codex plugin marketplace add Opennan/opennan-ai-plugin
codex plugin add opennan@opennan
```

또는 서버만 추가

codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY

또는 ~/.codex/config.toml에 추가

[mcp_servers.opennan]
url = "https://api.opennan.com/v1/mcp"
http_headers = { Authorization = "Bearer sk-..." }

4
opennan이 목록에 있는지 확인
```
codex mcp list
```
Codex을 다시 시작하고 무엇이든 요청하세요
“네온 거리에 내리는 비 5초 영상, 어울리는 노래, 포스터 이미지를 만들어 줘.”

sk-...를 내 키로 바꾸고 비공개로 두세요. 키를 가진 사람은 잔액을 쓸 수 있습니다. 키가 없어도 도구 목록은 보이지만 만들려면 키가 필요합니다.

AI 에이전트에서 사용하기

에이전트에 Opennan MCP 서버를 추가하고 이 도구를 호출하세요.

도구: generate_3d_model
예시 인수: { "prompt": "a wooden treasure chest with gold trim", "kind": "prop", "quality": "standard", "engine": "opennan-3d-studio" }