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 段階生成
1 回のリクエストで、まず構造化キャラクター生成、次に画像レンダリングを実行します。
カスタムプロンプト契約
テキスト段階の指示を定義し、<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 コールバックを処理します。
記載の料金は、言語モデル段階と画像レンダリング段階の両方を 1 回の課金リクエストでカバーします。
OC Maker API の料金
1 リクエストにつき 1 トークン
OC Maker のリクエストは、2 つの処理段階を合わせて GoEnhance トークン 1 個を消費します。
1 リクエストにつき $0.02
現在ドキュメントに記載された米ドル換算額は、OC Maker リクエスト 1 件あたり $0.02 です。
失敗ジョブは返金
いずれかの段階で失敗するとジョブ全体が失敗し、トークンは返金されるとドキュメントに記載されています。
4 ステップで OC Maker API を実装
1
1. テキスト段階のプロンプトを書く
oc_prompt を含むパース可能な JSON のみを返すようモデルに指示します。アプリケーションに必要なキャラクターフィールドを追加してください。 2
2. レンダリングを設定する
model: oc-maker、プロンプト、必須の image_render_model を POST します。出力比率、テキストモデル、システムプロンプト、コールバック URL は任意で設定できます。 3
3. ジョブを追跡し 2 種類の結果を読む
送信レスポンスを検証し、
data.img_uuid を自前のタスクレコードとあわせて保存します。GET /api/v1/jobs/detail をポーリングするかコールバックを処理して終了状態になるまで待ち、JSON エントリから構造化オブジェクトを、画像エントリからアセット URL を取得します。構造化キャラクターデータと対応するビジュアルが同じプロダクト業務を支える場面で活用してください。
OC Maker API のユースケース
ロールプレイのキャラクター作成機能
ロールプレイツール内で確認できるキャラクタープロフィールと対応するビジュアルを生成します。
ゲームのコンセプト制作パイプライン
構造化した設定案を初期のキャラクターレコードと画像に変換し、人が主導するコンセプト工程へ渡します。
ストーリー制作ツール
外見・性格・背景設定のフィールドと、ライター向けのビジュアル参照をあわせて作成します。
アバター作成フロー
ユーザーの選択を集めて制御されたプロンプトを組み立て、生成されたキャラクターの肖像画または全身画像を返します。
クリエイティブなプロトタイプアプリ
キャラクターのアイデアを試しながら構造化データを保持し、編集画面や承認画面へ引き継げます。
アセット処理の自動化
タスク完了をモデレーション、ストレージ、レビュー、後続のコンテンツ基盤に接続します。
料金・プロンプト・レンダリング・実装に関するよくある質問への回答です。