oc_prompt가 포함된 구조화 캐릭터 데이터를 만들고, 이어서 선택한 렌더링 백엔드가 이미지를 생성합니다. 요청은 폴링이나 콜백 처리를 위한 비동기 img_uuid를 반환합니다.오리지널 캐릭터 생성을 위한 OC Maker API
GoEnhance를 통해 2단계 캐릭터 워크플로를 제품에 추가합니다. 프롬프트가 언어 모델을 유도해
API 키 만들기
캐릭터 기획안을 구조화 데이터와 렌더링 결과로
캐릭터 데이터 설계
텍스트 단계 프롬프트 전문을 제공하고 애플리케이션에 필요한 JSON 필드를 정의합니다. 응답에는 반드시 oc_prompt가 포함되어야 하며, 캐릭터 이름·외형·성격·배경 이야기 같은 필드는 생성된 캐릭터 데이터와 함께 전달될 수 있습니다.
렌더링 경로 선택
이미지 단계에는 seedream 또는 gpt-image-2를 선택하고, 필요하면 지원되는 비율을 지정합니다. 요청 수준의 ratio는 생성된 JSON의 oc_ratio를 덮어쓰므로 레이아웃 결정권은 애플리케이션에 남습니다.
범용 이미지 엔드포인트라고 가정하지 말고, 문서에 명시된 요청과 결과 규약에 맞춰 개발하세요.
OC Maker API 기능
2단계 생성
한 번의 요청으로 구조화 캐릭터 생성을 먼저, 이미지 렌더링을 그다음에 실행합니다.
커스텀 프롬프트 규약
텍스트 단계 지시를 정의하고 <code>oc_prompt</code> 필드가 포함된 파싱 가능한 JSON을 필수로 요구합니다.
유연한 캐릭터 필드
외형, 성격, 캐릭터 이름, 배경 이야기 같은 추가 필드를 요청해 후속 처리에 활용합니다.
렌더링 백엔드 선택
<code>image_render_model</code>을 <code>seedream</code> 또는 <code>gpt-image-2</code>로 설정합니다.
지원되는 출력 비율
1:1, 2:3, 3:2, 4:3, 3:4, 16:9, 9:16 중에서 선택하며 기본값은 3:4입니다.
비동기 결과 처리
<code>img_uuid</code>를 저장한 뒤 작업 상세를 폴링하거나 공개 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을 읽습니다.구조화 캐릭터 데이터와 그에 맞는 비주얼이 같은 제품 워크플로를 함께 뒷받침할 때 활용하세요.
OC Maker API 활용 사례
롤플레잉 캐릭터 빌더
롤플레잉 도구 안에서 검토할 수 있도록 캐릭터 프로필과 그에 대응하는 비주얼을 생성합니다.
게임 콘셉트 파이프라인
구조화된 기획안을 초기 캐릭터 레코드와 이미지로 바꿔 사람이 주도하는 콘셉트 과정에 넘깁니다.
스토리 개발 도구
작가를 위해 외형, 성격, 배경 이야기 필드를 시각 레퍼런스와 함께 만듭니다.
아바타 제작 플로우
사용자 선택을 모아 통제된 프롬프트를 구성하고, 생성된 캐릭터 초상 또는 전신 결과물을 반환합니다.
크리에이티브 프로토타입 앱
캐릭터 아이디어를 시험하면서도 편집이나 승인 화면으로 넘길 수 있는 구조화 데이터를 유지합니다.
자동화된 애셋 워크플로
작업 완료를 검수, 저장, 리뷰 및 후속 콘텐츠 시스템과 연결합니다.
가격, 프롬프트, 렌더링, 연동에 대해 자주 묻는 질문의 답변입니다.