オリジナルキャラクター生成のための OC Maker API

GoEnhance を通じて、2 段階のキャラクター生成ワークフローを自社プロダクトに追加できます。プロンプトが言語モデルを誘導し、oc_prompt を含む構造化キャラクターデータを生成したうえで、選択したレンダリングバックエンドが画像を作成します。リクエストは非同期の img_uuid を返し、ポーリングまたはコールバックで処理します。
API キーを作成
OC Maker API を象徴する、映画的なクリエイティブスタジオのオリジナルファンタジーキャラクター

キャラクター設定を構造化データとレンダリング結果に

キャラクターデータの設計

テキスト段階のプロンプト全文を渡し、アプリケーションに必要な JSON フィールドを定義します。レスポンスには oc_prompt が必須で、キャラクター名・外見・性格・背景設定などのフィールドは生成されたキャラクターデータとあわせて受け取れます。
衣装のディテールに一貫性のあるオリジナルファンタジーキャラクターを単一のスタジオシーンで撮影

レンダリング経路の選択

画像段階には seedream か gpt-image-2 を選び、必要に応じて対応する比率を指定します。リクエスト単位の ratio は生成された JSON の oc_ratio を上書きするため、レイアウトの判断はアプリケーション側に残ります。
映画的な制作環境でレンダリングされたオリジナルのサイエンスファンタジーキャラクター
汎用の画像エンドポイントと決めつけず、ドキュメント化されたリクエストと結果の契約に沿って実装してください。

OC Maker API の機能

2 段階生成

1 回のリクエストで、まず構造化キャラクター生成、次に画像レンダリングを実行します。

カスタムプロンプト契約

テキスト段階の指示を定義し、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 コールバックを処理します。
記載の料金は、言語モデル段階と画像レンダリング段階の両方を 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 を取得します。
API キーを作成
構造化キャラクターデータと対応するビジュアルが同じプロダクト業務を支える場面で活用してください。

OC Maker API のユースケース

ロールプレイのキャラクター作成機能

ロールプレイツール内で確認できるキャラクタープロフィールと対応するビジュアルを生成します。

ゲームのコンセプト制作パイプライン

構造化した設定案を初期のキャラクターレコードと画像に変換し、人が主導するコンセプト工程へ渡します。

ストーリー制作ツール

外見・性格・背景設定のフィールドと、ライター向けのビジュアル参照をあわせて作成します。

アバター作成フロー

ユーザーの選択を集めて制御されたプロンプトを組み立て、生成されたキャラクターの肖像画または全身画像を返します。

クリエイティブなプロトタイプアプリ

キャラクターのアイデアを試しながら構造化データを保持し、編集画面や承認画面へ引き継げます。

アセット処理の自動化

タスク完了をモデレーション、ストレージ、レビュー、後続のコンテンツ基盤に接続します。
料金・プロンプト・レンダリング・実装に関するよくある質問への回答です。

OC Maker API のよくある質問

OC Maker API の料金は?

GoEnhance は現在、OC Maker API の料金を 1 リクエストあたり 1 トークン($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 で開発を始める