오리지널 캐릭터 생성을 위한 OC Maker API

GoEnhance를 통해 2단계 캐릭터 워크플로를 제품에 추가합니다. 프롬프트가 언어 모델을 유도해 oc_prompt가 포함된 구조화 캐릭터 데이터를 만들고, 이어서 선택한 렌더링 백엔드가 이미지를 생성합니다. 요청은 폴링이나 콜백 처리를 위한 비동기 img_uuid를 반환합니다.
API 키 만들기
OC Maker API를 상징하는, 영화적인 크리에이티브 스튜디오 속 오리지널 판타지 캐릭터

캐릭터 기획안을 구조화 데이터와 렌더링 결과로

캐릭터 데이터 설계

텍스트 단계 프롬프트 전문을 제공하고 애플리케이션에 필요한 JSON 필드를 정의합니다. 응답에는 반드시 oc_prompt가 포함되어야 하며, 캐릭터 이름·외형·성격·배경 이야기 같은 필드는 생성된 캐릭터 데이터와 함께 전달될 수 있습니다.
의상 디테일이 일관된 오리지널 판타지 캐릭터를 단일 스튜디오 장면에서 촬영

렌더링 경로 선택

이미지 단계에는 seedream 또는 gpt-image-2를 선택하고, 필요하면 지원되는 비율을 지정합니다. 요청 수준의 ratio는 생성된 JSON의 oc_ratio를 덮어쓰므로 레이아웃 결정권은 애플리케이션에 남습니다.
영화 수준의 프로덕션 환경에서 렌더링한 오리지널 사이언스 판타지 캐릭터
범용 이미지 엔드포인트라고 가정하지 말고, 문서에 명시된 요청과 결과 규약에 맞춰 개발하세요.

OC Maker API 기능

2단계 생성

한 번의 요청으로 구조화 캐릭터 생성을 먼저, 이미지 렌더링을 그다음에 실행합니다.

커스텀 프롬프트 규약

텍스트 단계 지시를 정의하고 oc_prompt 필드가 포함된 파싱 가능한 JSON을 필수로 요구합니다.

유연한 캐릭터 필드

외형, 성격, 캐릭터 이름, 배경 이야기 같은 추가 필드를 요청해 후속 처리에 활용합니다.

렌더링 백엔드 선택

image_render_model을 seedream 또는 gpt-image-2로 설정합니다.

지원되는 출력 비율

1:1, 2:3, 3:2, 4:3, 3:4, 16:9, 9:16 중에서 선택하며 기본값은 3:4입니다.

비동기 결과 처리

img_uuid를 저장한 뒤 작업 상세를 폴링하거나 공개 HTTPS 콜백을 처리합니다.
문서에 명시된 요금은 언어 모델 단계와 이미지 렌더링 단계를 하나의 과금 요청으로 함께 포함합니다.

OC Maker API 가격

요청당 1 토큰

OC Maker 요청 한 건은 두 처리 단계를 합쳐 GoEnhance 토큰 1개를 사용합니다.

요청당 $0.02

현재 문서에 명시된 미국 달러 환산 금액은 완전한 OC Maker 요청 한 건당 $0.02입니다.

실패한 작업은 환불

어느 한 단계라도 실패하면 작업 전체가 실패하고 토큰이 환불된다고 문서에 명시되어 있습니다.

네 단계로 OC Maker API 연동하기

1

1. 텍스트 단계 프롬프트 작성

oc_prompt가 포함된 파싱 가능한 JSON만 반환하도록 모델에 지시합니다. 애플리케이션에 필요한 캐릭터 필드를 추가하세요.
2

2. 렌더링 설정

model: oc-maker와 프롬프트, 그리고 필수 항목인 image_render_model을 POST로 전송합니다. 출력 비율, 텍스트 모델, 시스템 프롬프트, 콜백 URL은 선택 사항입니다.
3

3. 작업 추적 및 두 결과 읽기

제출 응답을 검증하고 data.img_uuid를 자체 작업 레코드와 함께 저장합니다. GET /api/v1/jobs/detail을 폴링하거나 콜백을 처리해 종료 상태에 이르면, JSON 항목에서 구조화 객체를, 이미지 항목에서 애셋 URL을 읽습니다.
API 키 만들기
구조화 캐릭터 데이터와 그에 맞는 비주얼이 같은 제품 워크플로를 함께 뒷받침할 때 활용하세요.

OC Maker API 활용 사례

롤플레잉 캐릭터 빌더

롤플레잉 도구 안에서 검토할 수 있도록 캐릭터 프로필과 그에 대응하는 비주얼을 생성합니다.

게임 콘셉트 파이프라인

구조화된 기획안을 초기 캐릭터 레코드와 이미지로 바꿔 사람이 주도하는 콘셉트 과정에 넘깁니다.

스토리 개발 도구

작가를 위해 외형, 성격, 배경 이야기 필드를 시각 레퍼런스와 함께 만듭니다.

아바타 제작 플로우

사용자 선택을 모아 통제된 프롬프트를 구성하고, 생성된 캐릭터 초상 또는 전신 결과물을 반환합니다.

크리에이티브 프로토타입 앱

캐릭터 아이디어를 시험하면서도 편집이나 승인 화면으로 넘길 수 있는 구조화 데이터를 유지합니다.

자동화된 애셋 워크플로

작업 완료를 검수, 저장, 리뷰 및 후속 콘텐츠 시스템과 연결합니다.
가격, 프롬프트, 렌더링, 연동에 대해 자주 묻는 질문의 답변입니다.

OC Maker API 자주 묻는 질문

OC Maker API 가격은 얼마인가요?

GoEnhance는 현재 OC Maker API 가격을 요청당 1 토큰, 즉 $0.02로 문서화하고 있습니다. 이 요금은 텍스트 단계와 이미지 단계를 모두 포함합니다.

프롬프트는 무엇을 반환해야 하나요?

프롬프트는 oc_prompt 필드가 포함된 파싱 가능한 JSON을 반환하도록 텍스트 모델에 지시해야 합니다. 해당 필드가 없거나 출력을 JSON으로 파싱할 수 없으면 작업이 실패합니다.

사용할 수 있는 렌더링 모델은 무엇인가요?

필수 항목인 image_render_model 필드를 seedream 또는 gpt-image-2로 설정합니다.

응답에 캐릭터 시트를 포함할 수 있나요?

네. 캐릭터 이름, 외형, 성격, 배경 이야기 같은 필드를 요청할 수 있습니다. 최종 결과에는 생성된 JSON 객체 전체와 렌더링된 이미지 항목이 함께 담깁니다.

첫 요청에서 완성된 이미지가 바로 오나요?

아니요. 제출에 성공하면 img_uuid가 반환됩니다. 작업 상세 엔드포인트를 폴링하거나 공개 HTTPS 콜백 URL을 제공한 뒤, type: image 결과 항목에서 이미지를 읽으세요.

비율 선택은 어떻게 동작하나요?

요청 수준의 ratio가 생성된 JSON의 oc_ratio를 덮어씁니다. 둘 다 없으면 문서에 명시된 기본값은 3:4입니다.

OC Maker API로 개발 시작하기