面向原创角色生成的 OC Maker API

通过 GoEnhance 为你的产品接入两阶段角色生成流程。你的提示词先引导语言模型输出带 oc_prompt 的结构化角色数据,再由所选渲染后端生成图片。请求会返回一个异步的 img_uuid,用于轮询或回调处理。
创建 API Key
电影感创作工作室中的原创奇幻角色,代表 OC Maker API

把角色设定说明变成结构化数据与渲染结果

服装细节前后一致的原创奇幻角色,置于单一工作室场景中
在电影级制作环境中渲染的原创科幻奇幻角色
请按文档给出的请求与结果契约来开发,别当成通用图片端点去猜。

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

1. 编写文本阶段提示词

要求模型只返回包含 oc_prompt 的可解析 JSON。再补上应用需要的角色字段。
2. 配置渲染
2

2. 配置渲染

POST 提交 model: oc-maker、你的提示词,以及必填的 image_render_model。可选设置输出比例、文本模型、系统提示词或回调 URL。
3. 跟踪任务并读取两类结果
3

3. 跟踪任务并读取两类结果

校验提交响应,并把 data.img_uuid 与你自己的任务记录一起持久化。轮询 GET /api/v1/jobs/detail 或处理回调,直到进入终态,然后从 JSON 条目读取结构化对象,从图片条目读取素材 URL。
当结构化角色数据和配套视觉图服务于同一条产品流程时,就同时用上这两份输出。

OC Maker API 应用场景

角色扮演角色生成器

在角色扮演工具里生成角色档案和对应的视觉图,供用户审阅。

游戏概念设计流水线

把结构化的设定说明转成早期角色记录和图片,交给以人为主导的概念设计流程。

故事创作工具

为作者同时产出外貌、性格、背景故事字段和一张视觉参考图。

头像生成流程

收集用户的选择,组装成受控的提示词,返回生成的角色头像或全身图。

创意原型应用

在试验角色创意的同时保留结构化数据,可以继续送进编辑或审批界面。

自动化素材工作流

把任务完成事件接到审核、存储、复核以及下游内容系统。
价格、提示词、渲染和接入方面的常见问题解答。

OC Maker API 常见问题

用 OC Maker API 开始构建