Parameters
| Name | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | ID de la marque depuis ocoya_list_brands. |
prompt | string | Yes | Sujet du post. Minimum 10 caractères. |
tone | string | No | Ton de la légende. L’une des valeurs suivantes : professional, friendly, educational, bold, founder_led. Par défaut : professional. |
postLength | string | No | Longueur de la légende. L’une des valeurs suivantes : short, medium, long, extra_long. Par défaut : medium. |
socialProfileIds | string[] | No | IDs des profils sociaux connectés à associer au brouillon. |
hashtagLibraryId | string | No | ID de la bibliothèque de hashtags depuis ocoya_list_hashtag_libraries. |
generateImage | boolean | No | Indique s’il faut générer des médias image carrés pour le brouillon. |
imageCount | number | No | Nombre d’images générées lorsque generateImage vaut true. Utilisez 1 pour une seule image ou 2-10 pour un carrousel. |
referenceUrls | string[] | No | URLs d’images à utiliser comme références visuelles lorsque generateImage vaut true. |
referenceDesignIds | string[] | No | IDs de designs Studio depuis ocoya_list_studio_templates à utiliser comme références visuelles lorsque generateImage vaut true. |
Request example
{
"name": "ocoya_create_ai_post",
"arguments": {
"brandId": "cmayvq3hk00017apshay5qezu",
"prompt": "Create a LinkedIn post announcing our new analytics dashboard for ecommerce brands.",
"tone": "professional",
"postLength": "medium",
"socialProfileIds": ["clh49poxf008x8kov4ncbjty9"],
"hashtagLibraryId": "cmayw7l5200067apsmz2tv7e8",
"generateImage": true,
"imageCount": 3,
"referenceDesignIds": ["design_123"]
}
}Returns
Renvoie les détails de l’action de post, comme l’ID du groupe de posts, le statut et la planification. Le statut commence à GENERATING ; récupérez le post plus tard pour voir le brouillon finalisé.
Le post généré est enregistré comme un brouillon Ocoya modifiable une fois la génération en arrière-plan terminée, sauf si la génération échoue et que le post passe à ERROR.