# Content generation

Terradium writes a complete, SEO-ready article from a title and a few keywords. A
multi-agent pipeline plans the strategy, researches the topic online, writes the
draft, and refines it — and you can watch each stage as it runs.

## Start a generation

1. Go to **Content → New**.
2. Pick a **project** (the first active project is selected for you).
3. Enter a **title or topic** and a few **keywords** (comma-separated).
4. Choose a **language** — pre-filled from the project's default, overridable here.
5. Click **Generate**.

The sidebar shows your remaining **quota** for the billing period. Each generation
consumes one credit; you can't start one without an active subscription and
remaining quota. See [Billing & quota](/docs/billing-quota).

## The pipeline

Every article runs through four agents, in order. The status updates as each one
completes:

1. **Coordinator** — sets the strategy: angle, outline, and target keywords.
2. **SEO research** — researches the topic online for facts, sources, and SERP
   context.
3. **Writer** — writes the full draft from the strategy and research.
4. **Improver** — refines the draft for clarity, flow, and on-page SEO.

If a generation fails partway, retrying resumes from the agent that failed rather
than starting over.

## The article view

Open an article to see everything in one place:

- A **pipeline timeline** showing each stage as done, active, failed, or pending,
  with a live indicator while it runs.
- The **featured image** hero (see [Featured images](/docs/featured-images)).
- The **publishing** card with the article's publish state and controls (see
  [Publishing](/docs/publishing)).
- The **draft** itself, with **Preview** and **Raw** tabs.

## Editing the draft

In the draft card you can tweak the article by hand:

- Click **Edit** to open the markdown in an editor, then **Save**.
- Switch between **Preview** (rendered) and **Raw** (markdown) at any time.

Manual edits don't use any quota.

## Regenerate & retry

- **Retry generation** appears when a generation **failed** — it resumes the
  pipeline from the failed step. This does not consume an extra credit.
- **Regenerate** rewrites a finished article from scratch, replacing the current
  draft. You'll be asked to confirm. Regenerating does **not** use a generation
  credit.

## Generation quota

Both article generation and AI image generation draw from your monthly quota;
manual edits and image uploads are free. Your remaining balance and reset date
are shown on the **New content** screen and under **Settings → Billing**. Full
details in [Billing & quota](/docs/billing-quota).