Skip to main content

User Guide for ShiNyP v1.2.0: 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

Note: Your AI model and API key are now managed globally. Please ensure you have configured them on the Home page under the AI Activation section before proceeding.

  1. Define the task for the AI model.

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

  3. Select the report language.

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

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

🤖 AI models

🆕 For ShiNyP v1.2.0, we support 8 AI models:

a Price (USD) per 1M Tokens (Input / Output) ⚡ We recommend using Google AI models (https://ai.google.dev/gemini-api/docs/models?hl=zh-tw) It is free to get API key & use (see below). 💸 If you have paid API access from OpenAI, we recommend using GPT-5 for high-quality performance. Please note that GPT-5 mini is extremely fast and cost-effective.
Models Developer Price a
DeepSeek-V3 DeepSeek $0.14/$0.28
🆕 Gemini 3 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
🆕 GPT-5.5 OpenAI $10.00/$30.00
🆕 GPT-5 OpenAI $5.00/$15.00
🆕 GPT-5 mini OpenAI $0.15/$0.60
GPT-4.1 OpenAI $2.00/$8.00

✨ 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: ‘curl_modify_url’ is not an exported object from ‘namespace:curl’`

This error indicates that your environment is loading an outdated version of the curl package that lacks the `curl_modify_url()` helper required by the AI Report module. To resolve this error:

  1. Restart the R session.
  2. Update the curl package in your R session to the latest release.
  3. Re-launch ShiNyP and click Get Report again.
⚠️ 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.