Appearance
Suggestions
Suggestions are quick text transformations on existing copy. They differ from prompts (stored seeds for full generation) and inline (open-ended single-shot generation) in that they target a small, fixed set of operations.
Endpoint
POST /api/v1/ai/suggestionsRequest body:
typescript
{
text: string, // the source copy
action: "hashtags" | "shorten" | "improve",
count?: number, // for hashtags
maxLen?: number, // for shorten (default 280)
tone?: "casual" | "formal" | "engaging" | "professional",
language?: string,
modelId?: string,
}Operations
hashtags— returns up to 20 hashtag strings, one per line, parsed from the model output.shorten— returns one shortened version targetingmaxLencharacters (default 280, X-friendly).improve— returns a rewrite in the requestedtone(defaultengaging).
Cost
Not metered. Suggestions are fire-and-forget transforms — no credit debit.