write_caption

Write a caption

Write a caption and hashtags for an image, clip or set already in the account (generation_id or upload_id), sized for the smallest of the platforms named, in the locale given (en, fr, …). Writes nothing and costs no credits; pass the result to schedule_post.

Scope

social.write — Drafts, schedules, edits and withdraws posts.

Behaviour

Read-only: Reads the caller's own account and changes nothing.
Reaches outside: Shows the post's pictures to a vision model to write the caption.

Credits

What the tool's description says about credits, verbatim.

Writes nothing and costs no credits; pass the result to schedule_post.

Inputs

platformsarray of string · required
at least 1 item
localestring · required
at least 2 characters · at most 10 characters
generation_idstring · optional
uuid
upload_idstring · optional
uuid

Example call

A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_caption",
    "arguments": {
      "platforms": [
        "tiktok"
      ],
      "locale": "<locale>"
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "generation_id": {
      "type": "string",
      "format": "uuid"
    },
    "upload_id": {
      "type": "string",
      "format": "uuid"
    },
    "platforms": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "tiktok",
          "instagram",
          "youtube",
          "x"
        ]
      },
      "minItems": 1
    },
    "locale": {
      "type": "string",
      "minLength": 2,
      "maxLength": 10
    }
  },
  "required": [
    "platforms",
    "locale"
  ],
  "additionalProperties": false
}

Related tools

schedule_post
With post_id and remove: true, remove a finished or canceled post from Kuro's calendar and Needs attention only.

Every tool· This page as Markdown