L'API OC Maker pour la génération de personnages originaux

Ajoutez à votre produit un workflow de personnage en deux étapes via GoEnhance. Votre prompt guide un modèle de langage pour produire des données de personnage structurées contenant un oc_prompt, puis le backend de rendu choisi crée l'image. La requête renvoie un img_uuid asynchrone à utiliser en polling ou via callback.
Créer une clé API
Personnage de fantasy original dans un studio créatif cinématographique représentant l'API OC Maker

Transformer un brief de personnage en résultats structurés et rendus

Définir les données du personnage

Fournissez l'intégralité du prompt de l'étape texte et définissez les champs JSON dont votre application a besoin. La réponse doit contenir oc_prompt, tandis que des champs comme le nom du rôle, l'apparence, la personnalité ou l'histoire peuvent accompagner les données de personnage générées.
Personnage de fantasy original aux détails de costume cohérents dans une scène de studio unique

Choisir la voie de rendu

Sélectionnez seedream ou gpt-image-2 pour l'étape image et, si besoin, définissez un ratio pris en charge. Un ratio au niveau de la requête remplace le oc_ratio du JSON généré, ce qui laisse les choix de mise en page à votre application.
Personnage de science-fantasy original rendu dans un environnement de production cinématographique
Développez à partir du contrat de requête et de résultat documenté, plutôt que de supposer un endpoint d'image générique.

Fonctionnalités de l'API OC Maker

Génération en deux étapes

Une requête exécute d'abord la création structurée du personnage, puis le rendu de l'image.

Contrat de prompt personnalisé

Définissez les instructions de l'étape texte et exigez un JSON analysable contenant un champ oc_prompt.

Champs de personnage flexibles

Demandez des champs supplémentaires comme l'apparence, la personnalité, le nom du rôle ou l'histoire pour vos traitements ultérieurs.

Choix du backend de rendu

Réglez image_render_model sur seedream ou gpt-image-2.

Ratios de sortie pris en charge

Choisissez 1:1, 2:3, 3:2, 4:3, 3:4, 16:9 ou 9:16 ; la valeur par défaut est 3:4.

Traitement asynchrone des résultats

Conservez img_uuid, puis interrogez les détails de la tâche ou traitez un callback HTTPS public.
Le tarif documenté couvre l'étape du modèle de langage et celle du rendu d'image en une seule requête facturée.

Tarifs de l'API OC Maker

1 token par requête

Chaque requête OC Maker coûte 1 token GoEnhance pour l'ensemble des deux étapes de traitement.

$0.02 par requête

L'équivalent en USD actuellement documenté est de $0.02 pour une requête OC Maker complète.

Tâches échouées remboursées

La documentation précise qu'un échec dans l'une ou l'autre étape fait échouer toute la tâche et rembourse les tokens.

Intégrer l'API OC Maker en quatre étapes

1

1. Rédiger le prompt de l'étape texte

Demandez au modèle de ne renvoyer qu'un JSON analysable contenant oc_prompt. Ajoutez les champs de personnage dont votre application a besoin.
2

2. Configurer le rendu

Envoyez en POST model: oc-maker, votre prompt et le champ obligatoire image_render_model. Vous pouvez aussi définir le ratio de sortie, le modèle de texte, le prompt système ou l'URL de callback.
3

3. Suivre la tâche et lire les deux résultats

Validez la réponse de soumission et conservez data.img_uuid avec votre propre enregistrement de tâche. Interrogez GET /api/v1/jobs/detail ou traitez les callbacks jusqu'à l'état final, puis lisez l'objet structuré dans l'entrée JSON et l'URL de l'asset dans l'entrée image.
Créer une clé API
Exploitez les données de personnage structurées et le visuel associé lorsque les deux sorties servent le même workflow produit.

Cas d'usage de l'API OC Maker

Créateurs de personnages de jeu de rôle

Générez un profil de personnage et un visuel correspondant, à consulter directement dans un outil de jeu de rôle.

Pipelines de conception de jeu

Transformez des briefs structurés en fiches de personnage préliminaires et en images pour un processus de conception piloté par des humains.

Outils d'écriture narrative

Créez des champs d'apparence, de personnalité et d'histoire accompagnés d'une référence visuelle pour les auteurs.

Parcours de création d'avatar

Recueillez les choix de l'utilisateur, composez un prompt maîtrisé et renvoyez un portrait de personnage ou un rendu en pied.

Applications de prototypage créatif

Testez des idées de personnage tout en conservant des données structurées exploitables par des interfaces d'édition ou de validation.

Workflows d'assets automatisés

Reliez la fin de la tâche à la modération, au stockage, à la relecture et aux systèmes de contenu en aval.
Réponses aux questions courantes sur les tarifs, les prompts, le rendu et l'intégration.

FAQ sur l'API OC Maker

Quel est le tarif de l'API OC Maker ?

GoEnhance documente actuellement le tarif de l'API OC Maker à 1 token, soit $0.02, par requête. Ce tarif couvre à la fois l'étape texte et l'étape image.

Que doit renvoyer le prompt ?

Votre prompt doit demander au modèle de texte de renvoyer un JSON analysable contenant un champ oc_prompt. La tâche échoue si ce champ est absent ou si la sortie ne peut pas être analysée en JSON.

Quels modèles de rendu sont disponibles ?

Réglez le champ obligatoire image_render_model sur seedream ou gpt-image-2.

La réponse peut-elle inclure une fiche de personnage ?

Oui. Vous pouvez demander des champs comme le nom du rôle, l'apparence, la personnalité et l'histoire. Le résultat final contient l'objet JSON généré complet ainsi que l'entrée de l'image rendue.

La requête initiale renvoie-t-elle l'image finie ?

Non. Une soumission réussie renvoie img_uuid. Interrogez l'endpoint de détail de la tâche ou fournissez une URL de callback HTTPS publique, puis lisez l'image dans l'entrée de résultat de type: image.

Comment fonctionne le choix du ratio ?

Un ratio au niveau de la requête remplace le oc_ratio du JSON généré. En l'absence des deux, la valeur par défaut documentée est 3:4.

Développez avec l'API OC Maker