ส่วนลด 30% แผน Proรับเลย
API Documentation Background
🧬เอกสารสำหรับนักพัฒนา

AlphaGenome API

คู่มือนักพัฒนาฉบับสมบูรณ์

ผสานรวมการวิเคราะห์ลำดับ DNA และการทำนายผลกระทบของตัวแปรที่ทรงพลังเข้ากับแอปพลิเคชันของคุณด้วย Python SDK และ REST API ของเรา

11ประเภทเอาต์พุต
PythonSDK
RESTAPI

เริ่มต้นอย่างรวดเร็ว

เริ่มใช้งาน AlphaGenome ได้ในไม่กี่นาที

1

ติดตั้ง SDK

ติดตั้งแพ็คเกจ Python โดยใช้ pip

pip install dr7-alphagenome
2

ตั้งค่า API Key

กำหนดค่าข้อมูลรับรองการยืนยันตัวตนของคุณ

export DR7_API_KEY=your_key
3

รันการทำนาย

ทำการทำนายครั้งแรกจากบรรทัดคำสั่ง

alphagenome predict seq.fa
ตัวอย่าง Python ฉบับสมบูรณ์Python
from dr7_alphagenome import AlphaGenome

# Initialize the client
client = AlphaGenome(api_key="your_api_key")

# Predict from DNA sequence
sequence = "ATCGATCG..." * 125000  # 1Mb sequence
results = client.predict(
    sequence=sequence,
    modalities=["CAGE", "ATAC", "ChIP"],
    cell_types=["K562", "HepG2"]
)

# Get variant effect predictions
variant_effect = client.score_variant(
    chromosome="chr1",
    position=12345,
    ref="A",
    alt="G"
)

print(f"Variant effect score: {variant_effect.score}")
print(f"Affected tracks: {variant_effect.top_affected_tracks}")

ความสามารถหลักของ API

Endpoint ที่ทรงพลังสำหรับการวิเคราะห์จีโนมิกส์ที่ครอบคลุม

🧬

การทำนายลำดับ

POST /v1/alphagenome/predict

ทำนายผลกระทบเชิงหน้าที่จากลำดับ DNA ดิบ ส่งคืนการทำนายใน 5,930 แทร็กที่ครอบคลุมการแสดงออกของยีน ความสามารถในการเข้าถึงโครมาติน และอื่นๆ

พารามิเตอร์:

  • sequence: ลำดับ DNA (สูงสุด 1Mb)
  • modalities: รายการประเภทเอาต์พุต (CAGE, ATAC ฯลฯ)
  • cell_types: ประเภทเซลล์/เนื้อเยื่อเป้าหมาย
  • output_format: json, bigwig หรือ bedgraph
🔬

การให้คะแนนตัวแปร

POST /v1/alphagenome/variant

ให้คะแนนผลกระทบเชิงหน้าที่ของตัวแปรทางพันธุกรรม เปรียบเทียบการทำนายอัลลีลอ้างอิงและอัลลีลทางเลือกเพื่อวัดปริมาณผลกระทบของตัวแปร

พารามิเตอร์:

  • chromosome: ชื่อโครโมโซม (chr1-chr22, chrX, chrY)
  • position: ตำแหน่งจีโนม (hg38)
  • ref: อัลลีลอ้างอิง
  • alt: อัลลีลทางเลือก
  • window_size: หน้าต่างบริบท (ค่าเริ่มต้น 100kb)
📊

การประมวลผลแบบแบตช์

POST /v1/alphagenome/batch

ประมวลผลลำดับหรือตัวแปรหลายรายการในคำขอเดียว เหมาะสำหรับไฟล์ VCF หรือการศึกษาระดับจีโนม

พารามิเตอร์:

  • variants: รายการตัวแปรหรือไฟล์ VCF
  • parallel: เปิดใช้งานการประมวลผลแบบขนาน
  • callback_url: Webhook สำหรับการแจ้งเตือนเมื่อเสร็จสิ้น
  • output_format: รูปแบบไฟล์เอาต์พุต
🗺️

การสืบค้นภูมิภาค

GET /v1/alphagenome/region

สืบค้นการทำนายสำหรับภูมิภาคจีโนมเฉพาะ มีประโยชน์สำหรับการแสดงผลการทำนายในเบราว์เซอร์จีโนม

พารามิเตอร์:

  • chromosome: โครโมโซมเป้าหมาย
  • start: ตำแหน่งเริ่มต้น
  • end: ตำแหน่งสิ้นสุด (ช่วงสูงสุด 1Mb)
  • tracks: แทร็กเฉพาะที่ต้องการส่งคืน

ตัวอย่างโค้ด

เรียนรู้จากตัวอย่างกรณีการใช้งานทั่วไป

การทำนายลำดับพื้นฐาน

from dr7_alphagenome import AlphaGenome

client = AlphaGenome()

# Load sequence from FASTA file
results = client.predict_from_fasta(
    "input.fa",
    modalities=["CAGE", "ATAC", "DNase", "H3K27ac"],
    output_format="bigwig"
)

# Results are saved as BigWig files for visualization
for track in results.tracks:
    print(f"Saved: {track.output_path}")

การให้คะแนนผลกระทบของตัวแปร

from dr7_alphagenome import AlphaGenome

client = AlphaGenome()

# Score a single variant
effect = client.score_variant(
    chromosome="chr17",
    position=7674220,  # Near TP53 gene
    ref="G",
    alt="A",
    window_size=100000  # Context around variant
)

print(f"Overall effect score: {effect.score:.4f}")
print(f"Gene expression change: {effect.expression_delta:.4f}")
print("Top affected cell types:")
for ct in effect.top_cell_types[:5]:
    print(f"  {ct.name}: {ct.score:.4f}")

การประมวลผล VCF แบบแบตช์

from dr7_alphagenome import AlphaGenome

client = AlphaGenome()

# Score variants from VCF file
results = client.score_vcf(
    "variants.vcf",
    reference="hg38",
    output_file="scored_variants.tsv",
    include_tracks=["CAGE", "enhancer_activity"],
    parallel=True
)

print(f"Scored {results.total_variants} variants")
print(f"High-impact variants: {results.high_impact_count}")

# Filter for regulatory variants
regulatory = results.filter(
    min_score=0.5,
    affected_elements=["enhancer", "promoter"]
)
regulatory.to_dataframe().to_csv("regulatory_variants.csv")

REST API ด้วย curl

# REST API Example with curl

# Predict from sequence
curl -X POST https://api.dr7.ai/v1/alphagenome/predict \
  -H "Authorization: Bearer $DR7_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sequence": "ATCGATCG...",
    "modalities": ["CAGE", "ATAC"],
    "cell_types": ["K562"]
  }'

# Score variant
curl -X POST https://api.dr7.ai/v1/alphagenome/variant \
  -H "Authorization: Bearer $DR7_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chromosome": "chr1",
    "position": 12345,
    "ref": "A",
    "alt": "G"
  }'

ต้องการความช่วยเหลือเกี่ยวกับ API?

ขอความช่วยเหลือจากผู้ช่วย AI ของเราเกี่ยวกับตัวอย่างโค้ด การแก้ไขปัญหา หรือคำถามเกี่ยวกับการผสานรวม

AlphaGenome API Assistant การสนับสนุนทางเทคนิค API

สัมผัส AI จีโนมิกส์

0/3 ข้อความ

ผู้ช่วย AlphaGenome API

ถามฉันเกี่ยวกับการใช้งาน API ตัวอย่างโค้ด การแก้ไขปัญหา หรือคำถามเกี่ยวกับการผสานรวม

แนวทางปฏิบัติที่ดีที่สุด

เพิ่มประสิทธิภาพการใช้งาน AlphaGenome API ของคุณ

การเพิ่มประสิทธิภาพความยาวลำดับ

สมดุลความยาวบริบทกับเวลาการประมวลผลเพื่อผลลัพธ์ที่เหมาะสมที่สุด

  • ใช้หน้าต่าง 100kb-500kb สำหรับแอปพลิเคชันส่วนใหญ่
  • บริบทเต็ม 1Mb สำหรับการวิเคราะห์การควบคุมระยะไกล
  • หน้าต่างเล็กกว่า (50kb) สำหรับการให้คะแนนตัวแปรปริมาณสูง

การเลือกประเภทเซลล์

เลือกประเภทเซลล์ที่เกี่ยวข้องเพื่อมุ่งเน้นการวิเคราะห์ของคุณ

  • เลือกประเภทเซลล์ที่ตรงกับคำถามทางชีววิทยาของคุณ
  • ใช้ประเภทเซลล์ที่ตรงกับเนื้อเยื่อสำหรับการศึกษาโรค
  • สืบค้นประเภทเซลล์ที่มีอยู่ด้วย /v1/alphagenome/cell-types

กลยุทธ์การประมวลผลแบบแบตช์

ประมวลผลชุดข้อมูลขนาดใหญ่อย่างมีประสิทธิภาพด้วย endpoint แบบแบตช์

  • จัดกลุ่มตัวแปรตามโครโมโซมเพื่อการประมวลผลที่มีประสิทธิภาพ
  • ใช้ callback แบบอะซิงโครนัสสำหรับงานขนาดใหญ่ (>1000 ตัวแปร)
  • พิจารณารูปแบบเอาต์พุตตามการวิเคราะห์ถัดไป

การจัดการข้อผิดพลาด

สร้างแอปพลิเคชันที่แข็งแกร่งด้วยการจัดการข้อผิดพลาดที่เหมาะสม

  • ใช้ exponential backoff สำหรับขีดจำกัดอัตรา
  • ตรวจสอบลำดับก่อนส่ง
  • ตรวจสอบตำแหน่งตัวแปรเทียบกับจีโนมอ้างอิง

พร้อมที่จะขยายการวิเคราะห์จีโนมิกส์ของคุณหรือยัง?

รับการเข้าถึง API พร้อมขีดจำกัดอัตราที่สูงขึ้น การสนับสนุนแบบลำดับความสำคัญ และคุณสมบัติขั้นสูง

100K+
คำขอ API รายเดือน
ลำดับความสำคัญ
การสนับสนุนทางเทคนิค
99.9%
SLA เวลาทำงาน
รับการเข้าถึง API

คำถามที่พบบ่อยเกี่ยวกับ API

คำถามทางเทคนิคทั่วไปเกี่ยวกับ AlphaGenome API

ขีดจำกัดอัตราคืออะไร?

แผนฟรี: 100 คำขอ/วัน Standard: 10,000 คำขอ/วัน Pro: 100,000 คำขอ/วัน Enterprise: ขีดจำกัดแบบกำหนดเองมีให้ใช้งาน ส่วนหัวขีดจำกัดอัตราจะรวมอยู่ในการตอบกลับ API ทั้งหมด

รองรับรูปแบบอินพุตใดบ้าง?

API ยอมรับลำดับ DNA ดิบ (ตัวอักษร A, T, C, G) รูปแบบ FASTA พิกัดจีโนม (hg38) และไฟล์ VCF สำหรับการให้คะแนนตัวแปรแบบแบตช์ ลำดับสามารถยาวได้ถึง 1Mb

จะจัดการลำดับยาวอย่างไร?

สำหรับลำดับที่ยาวกว่า 1Mb ให้แบ่งเป็นหน้าต่างที่ทับซ้อนกันและรวมการทำนาย SDK มีฟังก์ชันตัวช่วย sliding_window() ที่จัดการสิ่งนี้โดยอัตโนมัติ

มีรูปแบบเอาต์พุตใดบ้าง?

JSON (ค่าเริ่มต้น) สำหรับการเข้าถึงแบบโปรแกรม BigWig สำหรับการแสดงผลในเบราว์เซอร์จีโนม BedGraph สำหรับการวิเคราะห์แบบข้อความ และ TSV สำหรับเอาต์พุตแบบตาราง งานแบบแบตช์ยังสามารถเอาต์พุตไฟล์บีบอัดได้

จะยืนยันตัวตนอย่างไร?

ใช้การยืนยันตัวตน Bearer token กับ API key ของคุณ ตั้งค่าตัวแปรสภาพแวดล้อม DR7_API_KEY หรือส่งตรงไปยัง constructor ของ client API key สามารถจัดการได้ในแดชบอร์ด Dr7.ai ของคุณ

มี Python SDK หรือไม่?

ใช่! ติดตั้งด้วย 'pip install dr7-alphagenome' SDK มีอินเทอร์เฟซระดับสูงสำหรับ API endpoint ทั้งหมด การลองใหม่อัตโนมัติ การสนับสนุนสตรีมมิง และฟังก์ชันตัวช่วยสำหรับเวิร์กโฟลว์ทั่วไป