Skip to main content

User Guide for ShiNyP: SNP Analysis and Visualization Platform

8 AI Report

➡️ This page is designed to generate the preliminary results from prior analysis, select an AI model, input the API key, and get an AI-driven report. Powered by the ellmer package.

📋 Your AI report is almost ready!

Step 1: Preliminary Results

  1. Enter the species name for your current analysis.
  2. Click Auto-generate button to obtain Preliminary Results.

Note: You can download the Preliminary Results as a .txt file, edit it as needed, and upload it again for ‘AI-driven Report’ use.

Step 2: AI-Driven Report

  1. Select an AI model.

  2. Define the task for the AI model.

  3. Select the conversation mode (Single-Turn: one request; Multi-Turn: up to five requests).

  4. Select the report language.

  5. Upload your AI API key: Provide a .txt file containing your API key (e.g., sk-…).
    💡Model: “Gemini 2.5 Flash (API Free)” — no API required!

    ▼ Example of API key file.

  6. Click Get Report to obtain AI-driven Report.

  7. Download the .docx (Word) file with a fully styled, professional layout.

🤖 AI models

🆕 For ShiNyP v1.1.0, we support 11 AI models:

a Price (USD) per 1M Tokens (Input / Output)
⚡ We recommend using Google Gemini 2.5 Flash—the flagship model—for generating AI reports. It is free to get API key & use (see below).
💸 If you have paid API access from OpenAI, we recommend using GPT-4.1 for stable performance. Please note that o4-mini and o3-mini are more suitable for “Idea Expansion” task within single-turn conversation.
Models Developer Price a
DeepSeek-V3 DeepSeek $0.07/$1.10
Gemini 2.0 Flash Google Free or $0.10/$0.40
🆕 Gemini 2.5 Flash Google Free or $0.30/$2.50
🆕 Gemini 2.5 Flash-Lite Google Free or $0.10/$0.40
o4-mini OpenAI $1.10/$4.40
o3-mini OpenAI $1.10/$4.40
GPT-4.1 OpenAI $2.00/$8.00
GPT-4.1 mini OpenAI $0.40/$1.60
GPT-4.1 nano OpenAI $0.10/$0.40
GPT-4o OpenAI $2.50/$10.00
GPT-4o mini OpenAI $0.15/$0.60

✨ Tasks for AI

  • Summary Request: Provide a clear, structured overview of key SNP analysis results.

  • Data Interpretation: Clarify findings and highlight key insights into population genetics.

  • Report Structuring: Create a framework for presenting SNP analysis results in a scientific report.

  • Idea Expansion: Propose future research directions informed by SNP findings.

  • 🆕 Custom Template: You can upload a template (.txt file) tailored to specific project, and AI will automatically fill in the analysis results.

    This reports fully comply with designated standards, enabling truly automated and standardized report generation for your lab. Only single-turn conversation is supported.

    Download an example of Custom Template (TXT).

🔑 How to get the API key

1️⃣ Sign Up or Log In:

2️⃣ Generate Your API Key:

3️⃣ Save Your API Key:

  • Copy the generated key and paste it into a Notepad file.
  • Save the file as .txt for ShiNyP use.

4️⃣ Manage Billing & Payments:

Note: Costs vary depending on the model, conversation mode, and the AI task requested.

❌ Encountered an error? Let’s fix it!

⚠️ Error: HTTP 401 Unauthorized

This error message indicates that your authentication credentials are invalid. This could happen for several reasons, such as:

  1. You are using a revoked API key.
  2. You are using a different API key than one under the requesting organization.
  3. You are using an API key that does not have the required permissions for the endpoint you are calling.

To resolve this error, first check that you are using the correct API key and organization ID in your request header.

⚠️ Error: Failed to Perform HTTP Request

This error may indicate that the request timed out, possibly due to an excessive input token count, which prevents the AI model from completing the task within the allotted time.