Headline writes a title and a one-sentence description for any text: a blog draft, a support ticket, a commit, a document, a chat thread. You also get a URL slug made from the title.
Titles name the subject instead of teasing it, in the text's own language. Add a style like "sentence case, under 6 words" to match your app.
Use it
curl https://labs.greatwork.company/v1/run \
-H "Authorization: Bearer $GWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "headline-1",
"input": "We moved our nightly database backups from a cron script on the app server to a managed job that snapshots every SQLite file, verifies it with an integrity check, copies it off the box, and runs a weekly restore drill so we know the backups actually work."
}'const res = await fetch("https://labs.greatwork.company/v1/run", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.GWL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "headline-1",
"input": "We moved our nightly database backups from a cron script on the app server to a managed job that snapshots every SQLite file, verifies it with an integrity check, copies it off the box, and runs a weekly restore drill so we know the backups actually work."
}),
});
const { output, usage } = await res.json();import os, requests
res = requests.post(
"https://labs.greatwork.company/v1/run",
headers={"Authorization": f"Bearer {os.environ['GWL_API_KEY']}"},
json={
"model": "headline-1",
"input": "We moved our nightly database backups from a cron script on the app server to a managed job that snapshots every SQLite file, verifies it with an integrity check, copies it off the box, and runs a weekly restore drill so we know the backups actually work."
},
)
output = res.json()["output"]Set GWL_API_KEY to a key from your dashboard. The bare name headline works too and follows new versions.
Options
input: The text to title (string or array of up to 8, up to 6,000 characters each).
| Name | Type | Default | What it does |
|---|---|---|---|
style | string | Optional style note, e.g. "sentence case, under 6 words" or "like a changelog entry". |
Output
| Field | Type | Meaning |
|---|---|---|
title | string | The title (90 characters max). |
description | string | One sentence (220 characters max). |
slug | string | URL slug from the title. |
Every response wraps this in {"id", "model", "output", "usage": {"units", "unit", "cost_usd"}, "latency_ms"}. Send an array as input and output is an array in the same order.
Examples
Engineering note
{
"model": "headline-1",
"input": "We moved our nightly database backups from a cron script on the app server to a managed job that snapshots every SQLite file, verifies it with an integrity check, copies it off the box, and runs a weekly restore drill so we know the backups actually work."
}{
"title": "Database Backup Process Transformation",
"description": "A detailed explanation of the transition from a cron script to a managed job for nightly database backups.",
"slug": "database-backup-process-transformation"
}Captured on our production servers: 4019 ms, 1 text, $0.0002.
Support thread
{
"model": "headline-1",
"input": "Customer can't log in after changing their email. Password reset emails go to the old address. Confirmed the old address still shows on the account page.",
"style": "sentence case, under 8 words"
}{
"title": "Customer Can't Log In After Changing Email",
"description": "Confirmed old address still shows on account page after password reset",
"slug": "customer-can-t-log-in-after-changing-email"
}Captured on our production servers: 3026 ms, 1 text, $0.0002.
Good for
- Name chat threads and conversations
- Title support tickets from the first message
- Suggest blog titles and meta descriptions
- Label uploaded documents
Limits and caveats
- Plain titles by design: it won't write clickbait even if asked.
Pricing
$0.20 per 1,000 texts. One unit per started 2,000 characters of input. Failed calls aren't charged, and a call never costs more than its estimate (POST /v1/estimate tells you before you run it).
Built on
Qwen/Qwen3-0.6B (with JSON-schema constrained decoding), 0.6B parameters. License: Apache-2.0. We run it on our servers with JSON-schema constrained decoding, so every answer parses.