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
- Blog posts
- Social media content
- Press releases
- One-off text generation
Theory of Change Integration
Align text generation with your strategic framework:- 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
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
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