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/suggestions

Request body:

{
  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 targeting maxLen characters (default 280, X-friendly).
• improve — returns a rewrite in the requested tone (default engaging).

Cost

Not metered. Suggestions are fire-and-forget transforms — no credit debit.

Related

Inline Assistance

Composer Overview

Prompts