用於原創角色生成的 OC Maker API

透過 GoEnhance 為你的產品加入兩階段角色生成流程。你的提示詞先引導語言模型輸出帶有 oc_prompt 的結構化角色資料,再由所選的算圖後端產生圖片。請求會回傳一個非同步的 img_uuid,供輪詢或回呼處理使用。
建立 API Key
電影感創作工作室中的原創奇幻角色,代表 OC Maker API

把角色設定說明變成結構化資料與算圖成果

定義角色資料

提供完整的文字階段提示詞,並定義應用程式需要的 JSON 欄位。回應必須包含 oc_prompt,而角色名稱、外貌、個性、背景故事等欄位可以隨產生的角色資料一併回傳。
服裝細節前後一致的原創奇幻角色,置於單一工作室場景中

選擇算圖路徑

為圖片階段選擇 seedream 或 gpt-image-2,並可選擇設定受支援的比例。請求層級的 ratio 會覆寫產生的 JSON 中的 oc_ratio,讓版面決策始終掌握在應用程式手上。
在電影級製作環境中算圖完成的原創科幻奇幻角色
請依文件載明的請求與結果約定來開發,別當成一般圖片端點來臆測。

OC Maker API 功能

兩階段生成

一次請求先執行結構化角色生成,再執行圖片算圖。

自訂提示詞約定

定義文字階段指令,並要求回傳帶有 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 個 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。
建立 API Key
當結構化角色資料與對應視覺圖服務於同一條產品流程時,就同時運用這兩份輸出。

OC Maker API 應用情境

角色扮演角色產生器

在角色扮演工具中產生角色檔案與對應的視覺圖,供使用者審閱。

遊戲概念設計流程

把結構化的設定說明轉成早期角色紀錄與圖片,交給由人主導的概念設計流程。

故事開發工具

為作者同時產出外貌、個性與背景故事欄位,以及一張視覺參考圖。

頭像製作流程

蒐集使用者的選擇,組成受控的提示詞,回傳產生的角色頭像或全身圖。

創意原型應用

在試驗角色構想的同時保留結構化資料,可再送進編輯或審核介面。

自動化素材工作流程

把工作完成事件接到審核、儲存、複審以及後續的內容系統。
價格、提示詞、算圖與串接方面常見問題的解答。

OC Maker API 常見問題

OC Maker API 價格是多少?

GoEnhance 目前文件載明的 OC Maker API 價格為每次請求 1 個 Token,等值 $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 開始打造

OC Maker API:價格與串接 | GoEnhance