generate_reel_captions
Generate a few caption options for a reel with Gemini video understanding, for the connected user to pick from before you schedule or publish it. Sends the video to Google Gemini for analysis (see reeldrop.io/privacy).
Pass source_url the first time for a given video (same kind of link schedule_reel accepts — a direct, publicly-fetchable link, e.g. a Google Drive webContentLink shared "Anyone with the link"). To regenerate options for the SAME video (different topic/tone, or the user didn't like the first batch) pass this call's own video_token back instead of source_url — that skips re-downloading it.
The response's video_token identifies the now-uploaded video. Once the user has picked a caption, pass that video_token (not source_url again) to schedule_reel/schedule_reels_bulk along with the chosen caption text and hashtags — this reuses the same upload instead of re-fetching source_url.
Present all 3 captions as distinct choices — this is a picker, not a
single suggestion. For hashtags, hashtags is the full pool Gemini
generated (ordered most-to-least relevant, commonly 50+ for a reel);
recommended_hashtags is that same list already cut to the top 5 —
Instagram's real per-post cap, and what the web app's own composer
pre-selects. When calling schedule_reel, pass recommended_hashtags (or a
hand-picked subset no larger than 5) as its hashtags argument, not the
full hashtags list — nothing server-side trims an oversized list before
it reaches Instagram. more_hashtags holds the rest, for a user who wants
to swap one of the 5 for an alternative.
Counts against the workspace's monthly caption-generation allowance, same as the web app's caption generator.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workspace_id": "<workspace_id>"
},
"name": "generate_reel_captions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| niche | No | general | |
| topic | No | ||
| source_url | No | ||
| video_token | No | ||
| workspace_id | Yes | ||
| tone_preference | No | any |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| niche | No | ||
| captions | Yes | ||
| hashtags | Yes | ||
| reel_title | Yes | ||
| video_token | Yes | ||
| more_hashtags | Yes | ||
| comment_keyword | No | ||
| recommended_hashtags | Yes |