User Guide

English, non-technical. Generating content in under 5 minutes. Developer? See the API Reference →

What is content-api?

You've got ideas. You've got a deadline. You need content written. content-api helps you generate polished social posts, emails, landing pages, and articles in seconds. No AI jargon. Just pick your topic, choose a few options on a form, and get back a ready-to-use draft.

This guide walks you through the basics. You'll be generating content in under 5 minutes.

Key Terms (Read This Once)

A few terms you'll see throughout this guide. Skim once now and the rest will read smoothly:

Quick Start in 3 Steps

Step 1: Create Your Account (1 minute)

1. Go to /register on this site
2. Enter your email
3. Click the link in the email we send you
4. Copy your API key somewhere safe (you'll see it once)
5. Done — you're on the Free plan with 10 generations/month (your monthly quota)

Step 2: Open the Playground (30 seconds)

Instead of messing with terminal commands or APIs, just click /playground from the top menu. This is where non-technical users do 99% of their work.

Step 3: Generate Your First Piece (2 minutes)

1. In the playground form on the left, pick what you want to write:
   • Content type — caption, marketing, email, blog, article, or landing page
   • Topic — what's it about? "AI in HR: opportunity or threat?" or "5 reasons to switch to async"
   • Brief (optional) — who reads this? what's the goal? any key points to hit?
   • Voice mode — how should it sound? (more on this below)
2. Click Generate
3. Watch the timer. Your content arrives in seconds (captions are fastest ~10s, longer pieces take a minute)
4. Check the quality score. If it's green (APPROVED), copy the content and use it

Understanding the Form Options

Content Type — What Are You Writing?

Pick based on what you need and how much time you have. Free users get 10 generations/month (monthly quota), so choose wisely.

Voice Mode — What "Personality" Should It Have?

The system can write the same topic three ways:

• Mode A — Story (Default) Personal, narrative-driven. Uses real examples. Best for warm audiences (community, loyal followers).
• Mode B — Principle Same quality writing, different angle. More structured, principle-focused. Best for thought leadership.
• Mode C — Viral Analysis Forces a deeper quality review. Best when you want thorough fact-checking and edge-case thinking.

Example — same topic, three modes:

Topic: "Why async communication works"

• A: "I remember when our team was drowning in meetings..."
• B: "Async communication has three core benefits: reduced context switching, documented decisions, distributed team support..."
• C: "Research shows async reduces meeting time by 40%. But here's what most teams get wrong..."

Pick A (story) if you want warmth. Pick B (principle) if you want authority. Pick C if you want deep thinking (slower — use when time allows).

Tier — How Much Quality Do You Want?

Tiers control how much thinking the AI does behind the scenes:

• basic — Fast, correct. Good for captions.
• upgrade — Better voice matching, more nuance. Good for marketing copy.
• pro — Maximum quality, deepest thinking. Good for articles and landing pages.

The system auto-chooses the best tier for your content type: caption → basic, marketing + email → upgrade, blog + article + landing → pro. Leave it on "auto (recommended)" unless you know what you're doing. The system picks right.

Voice Profile (Paid Feature)

If you upgrade to a paid plan, you can upload custom voice profiles — Starter: 1 voice, Pro: up to 5 voices. A voice profile is a set of 1–10 writing samples (3–5 recommended for best results) — your posts, emails, or articles. The AI learns your style and writes like you.

When to create a voice:

• You've been writing for 6+ months and have a recognizable style
• You want all your AI-generated content to sound like you, not like a generic "AI voice"
• You're on Starter or Pro plan

How to create one: Go to /dashboard → "Voice Profiles". Give it a name, paste 3–5 samples, optionally add hard rules ("no emoji", "no em-dashes", "always use contractions"), then save.

Topic & Brief — What Should It Say?

Topic (required) — Keep it short and specific. Good: "Why remote work is better for parents". Bad: "remote work" (too vague).

Brief (optional) — If you have more to say, tell the AI: who reads this, what's the goal, any hard requirements (must mention X, avoid Y, include CTA to Z), tone notes (funny, serious, casual, formal).

Example brief: "Audience: marketing managers at agencies. Goal: convince them async is better. CTA: try our tool free for 30 days. Tone: practical, not preachy."

Reading the Result

When your content is done, you see:

1. Verdict pill (top left) — Either APPROVED (green) or REJECTED (red). APPROVED means the review passed quality check — safe to use. REJECTED means the AI found issues (hallucinations, off-topic, etc.) — doesn't count toward your quota; try again.
2. Quality score — 0–10. Higher is better. A score of 6/10 or above is required for APPROVED status. If the reviewer also flags serious issues, the job may still be rejected even with a high score.
3. Content — The actual text. Click Copy to copy to clipboard.
4. Reviewer notes (if shown) — Any suggestions or things the AI flagged ("consider shortening the intro", "verify this claim").
5. Metadata (top right) — What tier and voice mode was used.

When to Upgrade to Custom Voice

Custom Voice — Write in Your Voice (Paid)

Once you upgrade, you can create custom voices. Here's how:

How to Create One

1. Gather 1–10 samples of your best writing (posts, emails, articles) — 3–5 recommended for best results
2. Go to /dashboard → "Voice Profiles" → "Create"
3. Give it a name: "Newsletter voice", "Product docs style", etc.
4. Paste the samples as-is
5. (Optional) Add hard rules to enforce style constraints:
   • "no emoji" — don't use any emoji
   • "no emdash" — use hyphens instead of — dashes
   • "contractions" — use "don't" instead of "do not"
   • "oxford comma" — always use the oxford comma
   • "numbers as words" — spell out numbers < 10

Hard Rules Language

Rules are written in plain English. Real examples:

• "no emoji, no em-dash, use contractions only"
• "formal tone, spell numbers above 5, oxford comma always"
• "short sentences (avg 12 words), no jargon, explain any acronym first use"

You can mix as many as you want.

Using Your Custom Voice

Once created, it shows up in the playground as an option. Select it when generating content and the AI writes in that voice. Each voice works with any of the three modes (A/B/C).

Pricing & Quota

Different plans give you different monthly limits and features.

Important: Failed or rejected jobs do NOT count toward your monthly quota. You only use quota for content you actually receive.

How to upgrade: /pricing page has a button. Choose your plan, complete payment, and your limits update instantly.

FAQ

Upgrading & Changing Plans

Go to /dashboard → "Billing". You can:

• Upgrade from Free to Starter/Pro anytime
• Switch between Starter ↔ Pro anytime
• Cancel (takes effect next cycle)
• View your usage

All changes take effect instantly.

For Developers: Integrating Via API

If you want to integrate content-api into your own app, script, or IDE, we support three integration paths:

• REST API — HTTP requests, any language
• MCP — Claude Desktop, VS Code, Cursor plugins
• CLI — npm install -g @content-agent/cli (binary: content-agent)

CLI Quick Start (60 seconds)

If you prefer the terminal, the CLI is live on npm. Three commands and you're generating:

# 1. Install
npm install -g @content-agent/cli

# 2. Save your API key (one-time)
content-agent auth set capi_your_key

# 3. Write something
content-agent write "Why async beats sync meetings" --type blog

The output prints to stdout with the quality score and remaining monthly quota on the last line. Use --out file.md to save instead of printing. Full command reference (auth, write, status, usage, env vars) is in the API Reference → CLI section.

Read the full API Reference →

The API docs have curl examples, webhook setup, error codes, and everything you need.

Need Help?

• Email: taminhquan182@gmail.com
• Hotline: 0908 695 494 (Alex)
• Slack: Join our community (link on /pricing)
• Docs: You're reading them
• API Reference: /docs/api