خصم 30% خطة Proاحصل عليه الآن
API Documentation Background
🧬توثيق المطور

AlphaGenome API

دليل المطور الكامل

قم بدمج تحليل تسلسل الحمض النووي القوي وتوقع تأثير المتغيرات في تطبيقاتك باستخدام Python SDK و REST API الخاص بنا.

11أنواع المخرجات
PythonSDK
RESTAPI

البدء السريع

ابدأ العمل مع AlphaGenome في دقائق

1

تثبيت SDK

قم بتثبيت حزمة Python باستخدام pip

pip install dr7-alphagenome
2

تعيين مفتاح API

قم بتكوين بيانات اعتماد المصادقة الخاصة بك

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 الأساسية

نقاط نهاية قوية لتحليل جينومي شامل

🧬

توقع التسلسل

POST /v1/alphagenome/predict

توقع التأثيرات الوظيفية من تسلسلات الحمض النووي الخام. يُرجع تنبؤات عبر 5,930 مساراً تغطي التعبير الجيني وإمكانية الوصول إلى الكروماتين والمزيد.

المعلمات:

  • sequence: تسلسل الحمض النووي (حتى 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؟

اطلب من مساعد الذكاء الاصطناعي المساعدة في أمثلة الكود أو استكشاف الأخطاء أو أسئلة التكامل

AlphaGenome API Assistant الدعم الفني لـ API

جرب الذكاء الاصطناعي للجينوم

0/3 رسائل

مساعد AlphaGenome API

اسألني عن استخدام API أو أمثلة الكود أو استكشاف الأخطاء أو أسئلة التكامل

أفضل الممارسات

حسّن استخدامك لـ AlphaGenome API

تحسين طول التسلسل

وازن بين طول السياق ووقت المعالجة للحصول على نتائج مثالية.

  • استخدم نوافذ 100kb-500kb لمعظم التطبيقات
  • سياق كامل 1Mb لتحليل التنظيم طويل المدى
  • نوافذ أصغر (50kb) لتقييم المتغيرات عالي الإنتاجية

اختيار نوع الخلية

اختر أنواع الخلايا ذات الصلة لتركيز تحليلك.

  • اختر أنواع الخلايا المطابقة لسؤالك البيولوجي
  • استخدم أنواع الخلايا المطابقة للأنسجة لدراسات الأمراض
  • استعلم عن أنواع الخلايا المتاحة باستخدام /v1/alphagenome/cell-types

استراتيجية المعالجة الدفعية

معالجة مجموعات البيانات الكبيرة بكفاءة باستخدام نقاط نهاية الدفعات.

  • جمّع المتغيرات حسب الكروموسوم للمعالجة الفعالة
  • استخدم callbacks غير متزامنة للمهام الكبيرة (>1000 متغير)
  • ضع في اعتبارك تنسيق المخرجات بناءً على التحليل اللاحق

معالجة الأخطاء

ابنِ تطبيقات قوية مع معالجة صحيحة للأخطاء.

  • نفّذ التراجع الأسي لحدود المعدل
  • تحقق من صحة التسلسلات قبل الإرسال
  • تحقق من مواقع المتغيرات مقابل الجينوم المرجعي

هل أنت مستعد لتوسيع نطاق تحليلك الجينومي؟

احصل على وصول API مع حدود معدل أعلى ودعم أولوي وميزات متقدمة.

+100K
طلبات API شهرية
أولوية
الدعم الفني
99.9%
SLA وقت التشغيل
احصل على وصول API

الأسئلة الشائعة حول API

أسئلة تقنية شائعة حول AlphaGenome API

ما هي حدود المعدل؟

الخطة المجانية: 100 طلب/يوم. Standard: 10,000 طلب/يوم. Pro: 100,000 طلب/يوم. Enterprise: حدود مخصصة متاحة. يتم تضمين رؤوس حدود المعدل في جميع استجابات API.

ما هي تنسيقات الإدخال المدعومة؟

تقبل API تسلسلات الحمض النووي الخام (أحرف A، T، C، G)، وتنسيق FASTA، والإحداثيات الجينومية (hg38)، وملفات VCF لتقييم المتغيرات الدفعي. يمكن أن تصل التسلسلات إلى 1Mb طولاً.

كيف أتعامل مع التسلسلات الطويلة؟

للتسلسلات الأطول من 1Mb، قسّمها إلى نوافذ متداخلة واجمع التنبؤات. يوفر SDK دالة مساعدة sliding_window() تتعامل مع هذا تلقائياً.

ما هي تنسيقات المخرجات المتاحة؟

JSON (الافتراضي) للوصول البرمجي، BigWig للتصور في متصفح الجينوم، BedGraph للتحليل النصي، و TSV للمخرجات الجدولية. يمكن لمهام الدفعات أيضاً إخراج ملفات مضغوطة.

كيف أقوم بالمصادقة؟

استخدم مصادقة Bearer token مع مفتاح API الخاص بك. عيّن متغير البيئة DR7_API_KEY أو مرره مباشرة إلى مُنشئ العميل. يمكن إدارة مفاتيح API في لوحة تحكم Dr7.ai الخاصة بك.

هل يوجد Python SDK متاح؟

نعم! ثبّته باستخدام 'pip install dr7-alphagenome'. يوفر SDK واجهة عالية المستوى لجميع نقاط نهاية API، وإعادة المحاولة التلقائية، ودعم البث، ودوال مساعدة لسير العمل الشائعة.