Text Card

From 3.3 credits

Create professional text overlays and title cards with typography, colors, and animation chosen automatically.

Text

Background(optional)

Click to upload image

or drag and drop

Browse library

Instructions(optional)

Still needed: Text

Runs on

1 models

Google
- Nano Banana 2

How to use Text Card

A compact decision guide for placing this pipeline in a workflow.

Best for

Title cards and section headers for videos
Lower-third text overlays on background images
Statistics, quotes, or key facts displayed on screen
Chapter dividers between video sections

Tips

Keep text SHORT, 3-8 words for titles, 10-15 for facts
Provide a background image or video that relates to the text topic
The AI picks font, size, color, alignment, and effects automatically
For chapter cards: generate a themed background with image-generator first

Text Card API

Call this pipeline from your own code. One request dispatches a run; the model is an input field, not a separate endpoint.

Get an API token

inputs: 3
required: 1
Pricing: 3.3 credits

Language

TypeScript Python Go CLI

bun add @pipe2-ai/sdk

Run a pipeline

import { createClient } from "@pipe2-ai/sdk";

const client = createClient(process.env.PIPE2_TOKEN!);

const { run_pipeline } = await client.RunPipeline({
  pipeline_slug: "text-card",
  input: {
    text: "The best time to plant a tree was 20 years ago.",
  },
});

pip install pipe2

Run a pipeline

import asyncio
import os

from pipe2 import Pipe2Client

client = Pipe2Client(token=os.environ["PIPE2_TOKEN"])

run = asyncio.run(client.run_pipeline(
    pipeline_slug="text-card",
    input={
        "text": "The best time to plant a tree was 20 years ago.",
    },
))

go get github.com/pipe2-ai/sdk-go

Run a pipeline

client := pipe2.NewClient(os.Getenv("PIPE2_TOKEN"))

input := json.RawMessage(`{
  "text": "The best time to plant a tree was 20 years ago."
}`)

run, err := pipe2.RunPipeline(context.Background(), client, "text-card", input)
if err != nil {
    log.Fatal(err)
}

brew install pipe2-ai/tap/pipe2

Run a pipeline

pipe2 pipelines run \
  --pipeline text-card \
  --input-json '{"text": "The best time to plant a tree was 20 years ago."}' \
  --wait

Per page

Input	Type	default	Description
`text`required	string	default—	Text to typeset on the card. Short lines read best.
`background_url`	string	default—	Public URL of a background image or video. The Generate form accepts an image; API callers may pass a video. Leave unset for a generated background.
`instructions`	string	default—	Styling hints. For videos up to 60 seconds, request timed labels, moving arrows, dots or drops; specify beat times and keep captions clear.

Point any MCP client at pipe2 and your agent gets these tools. It finds this pipeline, reads the same schema above, then runs it.

list_pipelines
get_pipeline_schema
run_pipeline
get_pipeline_run_status
request_upload

https://mcp.pipe2.ai/mcp

{
  "mcpServers": {
    "pipe2ai": {
      "url": "https://mcp.pipe2.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

MCP setup

Full API reference CLI reference

Recipes using this pipeline

Show all recipes

Frequently Asked Questions

How does the AI decide the typography?

AI analyzes your background and instructions to pick font family, weight, size, color, position, shadow, and box style. It considers readability, content tone, and visual space.

Can it create subtitles?

Yes, if your text has a natural break (like a title and tagline), AI splits it into a title + subtitle with different sizing and color.

What fonts are available?

Sans (modern/clean), Serif (formal/elegant), and Mono (technical), each in Bold, Regular, Italic, and Bold Italic.

What styles can I request?

Try instructions like: 'documentary serif title', 'news lower third banner', 'modern left-aligned', 'elegant italic quote', 'tech monospace'.

Does it work on videos?

Yes, video backgrounds get text overlay with fade-in animation. Audio is preserved.