SpeedContent Social

Write a social media post for a given platform and topic. The post is written to that platform's conventions, rewritten to read as human-authored, optionally scored against AI detection, and optionally illustrated with a generated image. Returns a job id immediately — poll it with check_social_job, which usually completes in 20-90 seconds. Costs credits.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "minLength": 3,
      "description": "What the post should be about."
    },
    "platform": {
      "type": "string",
      "enum": [
        "facebook",
        "instagram",
        "linkedin",
        "pinterest",
        "tiktok",
        "twitter",
        "youtube"
      ],
      "description": "Target platform. Each has its own style guide and default length."
    },
    "tone": {
      "type": "string",
      "enum": [
        "casual",
        "educational",
        "friendly",
        "humorous",
        "inspirational",
        "professional"
      ],
      "description": "Defaults to friendly."
    },
    "language": {
      "type": "string",
      "description": "Output language by name. Defaults to English."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many distinct variations to generate. Defaults to 1."
    },
    "word_count": {
      "type": "integer",
      "minimum": 10,
      "maximum": 500,
      "description": "Target length per post. Omit to use the platform default (LinkedIn 100, YouTube 150, Facebook/Pinterest 75, Instagram/TikTok 50, X 40)."
    },
    "generate_image": {
      "type": "boolean",
      "description": "Generate a matching image. Defaults to true. Adds 10 credits per post."
    },
    "detect_ai": {
      "type": "boolean",
      "description": "Score the post against AI detection and retry if it reads as machine-written. Adds 8 credits per post. Omit for automatic: runs only at 150+ words, because short posts score unreliably."
    },
    "brand_name": {
      "type": "string",
      "description": "Brand to mention where it reads naturally."
    },
    "brand_description": {
      "type": "string",
      "description": "What the business does."
    },
    "brand_tone": {
      "type": "string",
      "description": "Voice guidance, e.g. 'Direct, no jargon'."
    },
    "brand_audience": {
      "type": "string",
      "description": "Who the post should speak to."
    },
    "brand_keywords": {
      "type": "string",
      "description": "Comma-separated terms to work in."
    }
  },
  "required": [
    "topic",
    "platform"
  ],
  "additionalProperties": false
}

Look up a social post generation job by id. Returns the finished posts once the job completes, or its current progress while it runs. Costs nothing.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job id returned by generate_social_post."
    }
  },
  "required": [
    "job_id"
  ],
  "additionalProperties": false
}

List the platforms generate_social_post supports, with each one's default post length and emoji policy. Costs nothing and makes no network call.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}