SemanticPen Ruby SDK

gem 'semantic_pen'

require 'semantic_pen'

# Initialize the client
client = SemanticPen::Client.new(api_key: 'your-api-key')

# Generate an article
response = client.generate_article('AI in healthcare', project_name: 'Medical Blog')

if response.success? && response.has_article_ids?
  article_id = response.first_article_id
  
  # Check article status
  article = client.get_article(article_id)
  puts "Status: #{article.status} (#{article.progress}% complete)"
end

client = SemanticPen::Client.new(api_key: 'your-api-key')

client = SemanticPen::Client.new(
  api_key: 'your-api-key',
  base_url: 'https://api.semanticpen.com',
  timeout: 120  # 2 minutes
)

SemanticPen.configure do |config|
  config.api_key = 'your-api-key'
  config.base_url = 'https://www.semanticpen.com'
  config.timeout = 60
end

client = SemanticPen::Client.new(
  api_key: ENV['SEMANTIC_PEN_API_KEY'],
  base_url: ENV['SEMANTIC_PEN_BASE_URL']
)

response = client.generate_article('target keyword', project_name: 'My Project')

article = client.get_article('article-id')

article = client.get_article('article-id')

# Properties
article.id              # Article ID
article.title           # Article title
article.content         # Article content
article.status          # Current status
article.progress        # Progress percentage (0-100)
article.target_keyword  # Target keyword
article.project_name    # Project name
article.created_at      # Creation timestamp
article.updated_at      # Last update timestamp

# Status methods
article.completed?      # true if status is 'completed'
article.in_progress?    # true if status is 'in_progress' or 'processing'
article.failed?         # true if status is 'failed' or 'error'

# Convert to hash
article.to_h

response = client.generate_article('keyword')

# Properties
response.message        # Response message
response.success        # Boolean success status
response.article_ids    # Array of generated article IDs

# Methods
response.success?           # true if generation was successful
response.has_article_ids?   # true if article IDs are present
response.first_article_id   # First article ID (convenience method)

# Convert to hash
response.to_h

begin
  response = client.generate_article('keyword')
rescue SemanticPen::ValidationError => e
  puts "Validation Error: #{e.message}"
rescue SemanticPen::AuthenticationError => e
  puts "Authentication Error: #{e.message}"
rescue SemanticPen::NotFoundError => e
  puts "Not Found Error: #{e.message}"
rescue SemanticPen::RateLimitError => e
  puts "Rate Limit Error: #{e.message}"
rescue SemanticPen::NetworkError => e
  puts "Network Error: #{e.message}"
rescue SemanticPen::ApiError => e
  puts "API Error: #{e.message} (HTTP #{e.http_status_code})"
rescue SemanticPen::Error => e
  puts "SemanticPen Error: #{e.message}"
end

response = client.generate_article('AI trends 2025')

if response.success? && response.has_article_ids?
  article_id = response.first_article_id
  
  # Poll for completion
  poller = SemanticPen::Models::StatusPoller.new(
    client, 
    article_id, 
    max_attempts: 60,  # Maximum polling attempts
    delay: 5           # Delay between attempts (seconds)
  )
  
  article = poller.wait_for_completion
  
  if article.completed?
    puts "Article ready: #{article.title}"
  else
    puts "Article failed to complete"
  end
end

keywords = ['AI in healthcare', 'machine learning', 'data science']
articles = []

keywords.each do |keyword|
  begin
    response = client.generate_article(keyword, project_name: 'Tech Blog')
    articles << response.first_article_id if response.success?
    sleep(1)  # Rate limiting
  rescue SemanticPen::Error => e
    puts "Failed to generate article for #{keyword}: #{e.message}"
  end
end

# Check status of all articles
articles.each do |article_id|
  article = client.get_article(article_id)
  puts "#{article.target_keyword}: #{article.status} (#{article.progress}%)"
end