Skip to main content

Text Completions API Overview

Simple single-shot text generation without conversation state.

Overview

The Text Completions API provides stateless text generation for one-off tasks like blog posts, social media content, and press releases. Unlike the Chat API, completions don’t maintain conversation context.

Key Features

  • Stateless - No conversation history
  • Simple - Prompt in, text out
  • Fast - No session overhead
  • Theory-Aware - Strategic framework integration
  • Cost-Effective - $0.08 per 1K tokens
  • OpenAI Compatible - Works with OpenAI SDK

Use Cases

  • Generate blog posts
  • Write social media content
  • Create press releases
  • Draft campaign slogans
  • Compose fundraising emails
  • Write organizing scripts

Model

Quick Example

Chat vs. Completions

When to use Chat:
  • Multi-turn conversations
  • Interactive Q&A
  • Context-aware responses
When to use Completions:
  • Blog posts
  • Social media content
  • Press releases
  • One-off text generation

Theory of Change Integration

Align text generation with your strategic framework:
Theory Positions:
  • Voluntarism {x: -1, y: -1} - Grassroots mobilization
  • Structuralism {x: 1, y: -1} - Policy/systems change
  • Subjectivism {x: -1, y: 1} - Cultural transformation
  • Theurgism {x: 1, y: 1} - Faith-based activism
See the Theory of Change Guide for details.

Content Presets

Blog Post

Social Media Thread

Press Release

Campaign Slogan

Fundraising Email

Pricing

Text completions are billed per token at $0.08 per 1,000 tokens. Token Estimation:
  • ~750 words = 1,000 tokens
  • Blog post (500 words): ~667 tokens = $0.05
  • Tweet (280 chars): ~70 tokens = $0.006
  • Press release (400 words): ~533 tokens = $0.04

Rate Limits

Response Format

Best Practices

1. Be Specific in Prompts

2. Control Output Length

3. Adjust Temperature for Use Case

4. Use Theory Position for Strategic Alignment

Required Scopes

Text completion endpoints require the following API key scopes:
  • text:write - Create text completions
See the Authentication Guide for more details.

Next Steps

Create Completion

Create your first text completion

Theory of Change

Align AI with your strategic approach

Chat API

Use Chat API for conversations

Error Handling

Handle errors gracefully