Learn how to use the Senso generate API to create new content based on your existing knowledge base.
What You’ll Learn
This guide covers:
- Using the
/generate endpoint to create content
- Filtering generation by categories and topics
- Saving generated content for future use
- Understanding source attribution
How Generation Works
The generate API:
- Searches your knowledge base for relevant content
- Uses AI to synthesize information from multiple sources
- Creates new content following your instructions
- Optionally saves the result as new content
Basic Content Generation
const API_URL = 'https://sdk.senso.ai/api/v1';
const API_KEY = 'YOUR_API_KEY';
async function generateContent() {
try {
// Generate a product overview
const overviewResponse = await fetch(`${API_URL}/generate`, {
method: 'POST',
headers: {
'X-API-Key': API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
content_type: 'product features and benefits',
instructions: 'Create a comprehensive product overview suitable for new customers',
max_results: 10, // Use up to 10 source chunks
save: false // Don't save this generation
})
});
const overview = await overviewResponse.json();
console.log('Generated Content:');
console.log(overview.generated_text);
console.log('\nBased on', overview.sources.length, 'sources');
// Generate and save FAQ content
const faqResponse = await fetch(`${API_URL}/generate`, {
method: 'POST',
headers: {
'X-API-Key': API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
content_type: 'common customer questions',
instructions: 'Generate a FAQ section with at least 10 questions and detailed answers',
save: true // Save this as new content
})
});
const faq = await faqResponse.json();
console.log('\nFAQ Generated and Saved!');
console.log('Content ID:', faq.content_id);
console.log('Preview:', faq.generated_text.substring(0, 200) + '...');
} catch (error) {
console.error('Error generating content:', error);
}
}
generateContent();
Filtered Generation
Generate content from specific categories or topics:
// Generate content from a specific category
const categoryResponse = await fetch(`${API_URL}/generate`, {
method: 'POST',
headers: {
'X-API-Key': API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
content_type: 'technical specifications',
instructions: 'Create a technical datasheet with all specifications in a structured format',
category_id: 'tech-docs-category-id',
max_results: 20
})
});
const categoryContent = await categoryResponse.json();
// Generate content from a specific topic
const topicResponse = await fetch(`${API_URL}/generate`, {
method: 'POST',
headers: {
'X-API-Key': API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
content_type: 'installation procedures',
instructions: 'Write step-by-step installation instructions for beginners',
topic_id: 'installation-topic-id',
save: true
})
});
const topicContent = await topicResponse.json();
Advanced Generation Examples
Email Template Generation
email_response = requests.post(
f'{API_URL}/generate',
headers={'X-API-Key': API_KEY},
json={
'content_type': 'product announcement information',
'instructions': '''Create a professional email template for announcing our new product.
Include: subject line, greeting, key benefits (3-5 points),
call-to-action, and sign-off.''',
'save': True
}
)
email_template = email_response.json()
Comparison Chart
comparison_response = requests.post(
f'{API_URL}/generate',
headers={'X-API-Key': API_KEY},
json={
'content_type': 'product features across different tiers',
'instructions': 'Create a comparison table showing features available in Basic, Pro, and Enterprise tiers',
'max_results': 15
}
)
comparison = comparison_response.json()
Training Material
training_response = requests.post(
f'{API_URL}/generate',
headers={'X-API-Key': API_KEY},
json={
'content_type': 'user guide and best practices',
'instructions': 'Develop a training module for new users covering basic operations and tips',
'category_id': 'user-docs-category',
'save': True
}
)
training = training_response.json()
Understanding the Response
The generate API returns detailed information about the generation:
{
"content_type": "product features and benefits",
"instructions": "Create a comprehensive product overview...",
"generated_text": "# Product Overview\n\nOur product offers...",
"content_id": "550e8400-e29b-41d4-a716-446655440000",
"sources": [
{
"content_id": "abc123",
"version_id": "def456",
"chunk_index": 2,
"chunk_text": "Key features include...",
"score": 0.89,
"title": "Product Documentation"
}
],
"processing_time_ms": 1250
}
Best Practices
- Be specific with content_type: Describe exactly what kind of content you’re looking for
- Clear instructions: Provide detailed instructions for better results
- Optimize max_results: More sources provide comprehensive content but take longer
- Save strategically: Only save generated content you’ll reuse
- Review sources: Check which content was used to ensure accuracy
Error Handling
try:
response = requests.post(
f'{API_URL}/generate',
headers={'X-API-Key': API_KEY},
json={
'content_type': 'technical specs',
'instructions': 'Create a spec sheet'
}
)
result = response.json()
if response.status_code == 400:
print(f'Invalid parameters: {result.get("error")}')
elif response.status_code == 404:
print('No relevant content found')
else:
print(f'Generated: {result["generated_text"]}')
except Exception as error:
print(f'Error: {error}')
Use Cases
Dynamic Documentation
Generate up-to-date documentation that reflects your latest content:
docs_response = requests.post(
f'{API_URL}/generate',
headers={'X-API-Key': API_KEY},
json={
'content_type': 'API endpoints and parameters',
'instructions': 'Create comprehensive API documentation with examples',
'category_id': 'api-docs',
'save': True
}
)
docs = docs_response.json()
Content Summarization
Create executive summaries from detailed content:
summary_response = requests.post(
f'{API_URL}/generate',
headers={'X-API-Key': API_KEY},
json={
'content_type': 'quarterly reports and analyses',
'instructions': 'Summarize key findings and metrics in 5 bullet points',
'max_results': 20
}
)
summary = summary_response.json()
Next Steps
