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.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
Créer une clé API
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.
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.
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 <code>oc_prompt</code>.
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 <code>image_render_model</code> sur <code>seedream</code> ou <code>gpt-image-2</code>.
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 <code>img_uuid</code>, 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.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.