oc_prompt 的結構化角色資料，再由所選的算圖後端產生圖片。請求會回傳一個非同步的 img_uuid，供輪詢或回呼處理使用。用於原創角色生成的 OC Maker API
透過 GoEnhance 為你的產品加入兩階段角色生成流程。你的提示詞先引導語言模型輸出帶有
建立 API Key
把角色設定說明變成結構化資料與算圖成果
定義角色資料
提供完整的文字階段提示詞，並定義應用程式需要的 JSON 欄位。回應必須包含 oc_prompt，而角色名稱、外貌、個性、背景故事等欄位可以隨產生的角色資料一併回傳。
選擇算圖路徑
為圖片階段選擇 seedream 或 gpt-image-2，並可選擇設定受支援的比例。請求層級的 ratio 會覆寫產生的 JSON 中的 oc_ratio，讓版面決策始終掌握在應用程式手上。
請依文件載明的請求與結果約定來開發，別當成一般圖片端點來臆測。
OC Maker API 功能
兩階段生成
一次請求先執行結構化角色生成，再執行圖片算圖。
自訂提示詞約定
定義文字階段指令，並要求回傳帶有 <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 個 Token
每次 OC Maker 請求在兩個處理階段合計消耗 1 個 GoEnhance Token。
每次請求 $0.02
文件目前載明的美元等值價格為：一次完整的 OC Maker 請求 $0.02。
失敗工作退還 Token
文件說明：任一階段失敗都會導致整個工作失敗，並退還已扣的 Token。
四個步驟串接 OC Maker API
1
1. 撰寫文字階段提示詞
要求模型只回傳包含
oc_prompt 的可解析 JSON。再補上應用程式需要的角色欄位。 2
2. 設定算圖
以 POST 送出
model: oc-maker、你的提示詞，以及必填的 image_render_model。可選擇設定輸出比例、文字模型、系統提示詞或回呼 URL。 3
3. 追蹤工作並讀取兩種結果
驗證送出後的回應，並把
data.img_uuid 與你自己的工作紀錄一起保存。輪詢 GET /api/v1/jobs/detail 或處理回呼，直到進入最終狀態，然後從 JSON 項目讀取結構化物件，從圖片項目讀取素材 URL。當結構化角色資料與對應視覺圖服務於同一條產品流程時，就同時運用這兩份輸出。
OC Maker API 應用情境
角色扮演角色產生器
在角色扮演工具中產生角色檔案與對應的視覺圖，供使用者審閱。
遊戲概念設計流程
把結構化的設定說明轉成早期角色紀錄與圖片，交給由人主導的概念設計流程。
故事開發工具
為作者同時產出外貌、個性與背景故事欄位，以及一張視覺參考圖。
頭像製作流程
蒐集使用者的選擇，組成受控的提示詞，回傳產生的角色頭像或全身圖。
創意原型應用
在試驗角色構想的同時保留結構化資料，可再送進編輯或審核介面。
自動化素材工作流程
把工作完成事件接到審核、儲存、複審以及後續的內容系統。
價格、提示詞、算圖與串接方面常見問題的解答。