面向原创角色生成的 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 开始构建