Scientific Article PDF Generator

Generate publication-ready scientific articles in PDF format with AI-powered research and citations

# Paper.EvoWeb.ai Scientific Article PDF Generator

Generate scientific articles in PDF format with AI-powered content enrichment, citations, and professional formatting.

## Overview

Paper.EvoWeb.ai transforms draft text and product information into publication-ready scientific articles. The system enriches your content with research, adds proper citations, generates visualizations, and exports a professionally formatted PDF document.

**Perfect for:** Scientific papers, product research articles, white papers, technical documentation

**API Base URL:** `https://paper.evoweb.ai`

## Authentication

Get your API key at https://hub.oto.dev/app/register?utm_source=claw&utm_medium=skill&utm_campaign=paper&utm_content=v1.0.0

**Important:** After registration, user MUST confirm the email.

The API Key will be displayed in the Dashboard under the "API Key Settings" section.

Include this header in all requests:
```
Access-Token: your-api-key-here
```

## How It Works

The workflow is straightforward:

1. **Submit** - Send article parameters including title, product info, and draft text
2. **Generate** - AI enriches content with research, citations, and formatting
3. **Download** - Receive PDF file automatically

Typical generation time: **2-5 minutes**

## API Endpoints

### Generate Scientific Article PDF

**POST** `/`

Generates a scientific article in PDF format from provided text and product information. The PDF file will be returned as a binary response with automatic browser download.

**Request Headers:**
```
Access-Token: your-api-key-here
Content-Type: application/x-www-form-urlencoded
```

**Request Body (form-urlencoded):**

| Field | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| `article_title` | string | Yes | - | The main title that will appear at the top of the PDF (max 200 chars) |
| `article_subtitle` | string | No | - | Optional subtitle or author/affiliation line (max 300 chars) |
| `product_name` | string | Yes | - | The target product name that can be referenced throughout the article (max 120 chars) |
| `product_url` | string (URL) | No | - | Link to the official product page (will be cited in references) |
| `product_url_priority` | boolean | No | true | If checked, the product URL will be cited as the primary source |
| `product_facts` | string (text) | Yes | - | Key facts, descriptions, and figures verified by the client |
| `source_text` | string (text) | Yes | - | The base text draft to expand. Free-form input is accepted |
| `research_focus` | string | No | - | Optional description of the research focus to guide the output |
| `include_sources` | boolean | No | true | Include references and citations in the article |
| `enable_research` | boolean | No | false | If enabled, the system will gather sources and citations before writing the article |
| `include_charts` | boolean | No | false | Generate 1-3 data visualizations based on the research findings |

**Example Request:**
```json
{
  "article_title": "Effects of Hyaluronic Acid on Skin Hydration",
  "article_subtitle": "A Comprehensive Review",
  "product_name": "HydraGlow Serum",
  "product_url": "https://example.com/hydraglow-serum",
  "product_url_priority": true,
  "product_facts": "Contains 2% hyaluronic acid, clinically tested on 100 participants, showed 45% improvement in skin hydration after 4 weeks, dermatologist approved, suitable for all skin types",
  "source_text": "Hyaluronic acid is a naturally occurring substance in the human body that plays a crucial role in skin hydration. This study examines the effectiveness of topical hyaluronic acid applications in improving skin moisture levels and overall skin health.",
  "research_focus": "impact on skin health and hydration levels",
  "include_sources": true,
  "enable_research": true,
  "include_charts": true
}
```

**Response (200 OK):**
- **Content-Type:** `application/pdf`
- **Content-Disposition:** `attachment; filename="article-title.pdf"`
- **Body:** Binary PDF file data

The PDF file will be automatically downloaded by the browser.

**Error Responses:**
- `400 Bad Request` - Missing required fields or invalid data
- `401 Unauthorized` - Invalid or missing API key
- `402 Payment Required` - Insufficient credits on account
- `500 Internal Server Error` - Generation failed

## Instructions for AI Assistant

When a user requests a scientific article PDF, follow this workflow:

### Step 1: Gather Required Information

Ensure you have all required fields:
- **Article title** - Clear, descriptive title for the paper
- **Product name** - The product being discussed
- **Product facts** - Verified claims and data about the product
- **Source text** - The base draft text to expand

Ask the user for any missing required information.

### Step 2: Enhance Optional Fields

Encourage users to provide:
- **Article subtitle** - Add author names, affiliations, or subtitle
- **Product URL** - Official product page for citations
- **Research focus** - Specific areas to emphasize

### Step 3: Configure Generation Options

Ask about preferences:
- **Enable Deep Research Mode** (`enable_research`) - Gather external sources and citations (takes longer but more comprehensive)
- **Include Charts** (`include_charts`) - Add 1-3 data visualizations
- **Include Sources** (`include_sources`) - Add references section

**Default recommendations:**
- `include_sources: true` - Always include citations
- `enable_research: true` - For comprehensive articles
- `include_charts: false` - Only if data visualization would be valuable

### Step 4: Submit the Request

Call `POST /` with all parameters as form-urlencoded data.

**Important:** The response will be a binary PDF file. Handle it appropriately:
- Inform the user that the PDF is being generated
- The file will download automatically in their browser
- Generation typically takes 2-5 minutes

### Step 5: Inform the User

Tell them:
- PDF generation has started
- Expected completion time (2-5 minutes)
- The file will download automatically when ready

**Example message:**
```
📄 Generating your scientific article PDF now!

Title: "Effects of Hyaluronic Acid on Skin Hydration"
Product: HydraGlow Serum
Options: Deep research mode enabled, charts included

⏱️ This typically takes 3-5 minutes. The PDF will download automatically when ready.
```

### Step 6: Handle Errors

If the request fails:
- Show the error message clearly
- For `400 Bad Request` - Check required fields and data format
- For `401 Unauthorized` - Verify API key
- For `402 Payment Required` - User needs to add credits at https://paper.evoweb.ai/
- For `500 Internal Server Error` - Suggest trying again or simplifying the request

## Example Use Cases

### Product Research Article
```
User: "Create a scientific paper about our new anti-aging cream"

Required info:
- Article title: "Clinical Evaluation of Advanced Retinol Complex in Anti-Aging Treatment"
- Article subtitle: "A 12-Week Study on Wrinkle Reduction and Skin Elasticity"
- Product name: "AgeLess Retinol Cream"
- Product facts: "Contains 0.5% retinol, tested on 150 participants aged 35-65, showed 38% reduction in fine lines, 42% improvement in skin elasticity, dermatologically tested"
- Source text: "Retinol has been recognized as one of the most effective anti-aging ingredients in skincare. This clinical study evaluates the effectiveness of a novel retinol formulation..."
- Research focus: "anti-aging effects and wrinkle reduction"
- Enable research: true
- Include charts: true
```

### Product Comparison Study
```
User: "Need a paper comparing different protein supplements"

Required info:
- Article title: "Comparative Analysis of Whey Protein Isolate Formulations"
- Product name: "PureFit Whey Protein"
- Product facts: "99% protein purity, 25g protein per serving, contains all essential amino acids, lactose-free, tested for heavy metals"
- Source text: "Protein supplementation is crucial for muscle recovery and growth.