RaportAI — Yapay Zeka Destekli Radyoloji Raporlama

Dokümantasyon

Kullanım Kılavuzları

Bireysel veya kurumsal olarak kullanmaya başlamak için kılavuzlar ve API referansı.

Hesap Oluşturun

Kayıt Ol sayfasına gidin. Ad, soyad, e-posta ve şifre bilgilerinizi girin. Doğrulama e-postasındaki bağlantıya tıklayarak hesabınızı aktive edin.

Giriş Yapın

Giriş Yap sayfasından e-posta ve şifrenizle oturum açın. İlk girişte profil bilgilerinizi tamamlamanız istenebilir.

Ses Kaydı ile Rapor Oluşturun

Dashboard'da Yeni Rapor butonuna tıklayın. Mikrofon izni verin, muayene bulgularını sesli dikte edin. Yapay zeka ses kaydını yapılandırılmış tıbbi rapora çevirir.

Şablon Seçin

Tetkik türüne göre hazır şablonlar listelenir (BT toraks, MR beyin, ultrason vb.). Doğru şablon raporun bölüm yapısını ve terminolojisini otomatik ayarlar.

Raporu Düzenleyin ve Onaylayın

AI tarafından oluşturulan raporu inceleyin, gerekirse düzenleyin. Onayla butonuna tıklayarak raporu imzalayın. Onaylı raporlar arşivde saklanır.

Çıktı Alın

Onaylı rapordan tek tıkla PDF veya DOCX indirin ya da tarayıcıdan yazdırın. Paylaşılabilir bağlantı oluşturma seçeneği de mevcuttur.

Bireysel hesaplarda aylık rapor hakkı sistemi geçerlidir. Detaylar için Fiyatlandırma bölümüne bakın.

Organizasyon Hesabı Oluşturun

Kayıt Ol sayfasında Kurumsal Kayıt seçeneğini işaretleyin. Kurum adı, vergi numarası ve teknik iletişim bilgilerini doldurun.

API Anahtarı Alın

Kurumsal panelde Ayarlar → API Anahtarları bölümüne gidin. Yeni Anahtar Oluştur'a tıklayın. Anahtar rapi_ önekiyle başlar, yalnızca bir kez gösterilir.

Kimlik Doğrulama

Tüm API isteklerinde Authorization başlığı zorunludur:

Authorization: Bearer rapi_xxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

API anahtarını istemci tarafı (frontend) koduna gömmeyiniz. Sunucu tarafında environment variable olarak saklayın.

Tek Ses → Tek Rapor

Bir ses kaydından tek bir tetkike ait rapor üretir.

POST /api/v1/ai/report/unified

cURL

# Ses dosyası (WAV/MP3/OGG), şablon ID ve accession numarası gönderin
curl -X POST https://raportai.com/api/v1/ai/report/unified \
  -H "Authorization: Bearer rapi_xxxxxxxxxxxxxxxxxxxx" \
  -F "audioFile=@/kayit/muayene.wav" \
  -F "templateId=bt-toraks" \
  -F "patientRef=P-00123" \
  -F "accessionNumbers=ACC001"

JSON

{
  "ok": true,
  "mode": "single",
  "reports": [
    {
      "patientName": "Ahmet Yılmaz",
      "examType": "BT Toraks",
      "reportHtml": "<h3>TEKNİK</h3>...",
      "sutCode": "804190",
      "accessionNumber": "ACC001"
    }
  ]
}

Öne Çıkan Özellik

Tek Ses → Çoklu Rapor (Multi-Exam)

Radyolog tek ses kaydında birden fazla tetkiki art arda dikte edebilir. Sistem SUT kodları aracılığıyla tetkikleri ayırt eder ve her biri için ayrı rapor üretir. Toplu iş akışlarını önemli ölçüde hızlandırır.

POST /api/v1/ai/report/unified

cURL — Multi-Exam

# processingMode=multi-exam + virgülle ayrılmış SUT ve accession kodları
curl -X POST https://raportai.com/api/v1/ai/report/unified \
  -H "Authorization: Bearer rapi_xxxxxxxxxxxxxxxxxxxx" \
  -F "audioFile=@/kayit/coklu_diktasyon.wav" \
  -F "processingMode=multi-exam" \
  -F "sutCodes=804190,804320,804070" \
  -F "accessionNumbers=ACC001,ACC002,ACC003" \
  -F "patientRef=P-00456"

Desteklenen SUT Kodları (Seçili)

SUT Kodu	Tetkik Adı	Modalite
804190	BT Toraks	BT
804200	BT Toraks + Kontrast	BT
804320	MR Beyin	MR
804330	MR Beyin + Kontrast	MR
804070	USG Abdomen	USG
804080	USG Tiroid	USG
804410	MR Lumbar Omurga	MR
804050	Direkt Grafi Göğüs	Grafi

Her tetkikin accession number'ını virgülle ayrılmış olarak accessionNumbers parametresiyle gönderin. Raporlar accession number ile etiketlenerek döner.

Tam SUT kodu listesi ve özel tetkik eşleşmeleri için teknik destek ekibiyle iletişime geçin.

Rate Limiting

İstek / Dakika (Üretim)

İstek / Dakika (Demo)

Demo Rapor Kotası

100 MB

Maks. Ses Dosyası

Limit aşıldığında API 429 Too Many Requests döner. Retry-After başlığındaki değer kadar bekleyip tekrar deneyin.

PACS / Teleradyoloji

Çoklu Tetkik API

Tek ses kaydında birden fazla tetkik diktasyonunu gönderip her tetkik için ayrı rapor alın. PACS ve teleradyoloji sistemlerine doğrudan entegrasyon için tasarlandı.

POST /api/external/v1/pacs/report

Kimlik Doğrulama

Tüm API isteklerinde Authorization başlığı zorunludur:

Authorization: Bearer rapi_xxxxxxxxxxxxxxxxxxxx

İstek Formatı

multipart/form-data olarak gönderin:

Alan	Tip	Açıklama
`audio`	Dosya	Ses dosyası (WAV, MP3, M4A, OGG, WebM — max 50 MB)
`metadata`	JSON string	Tetkik bilgileri (aşağıdaki yapıya bakın)

Metadata JSON Yapısı

JSON

{
  "patientUid": "1.2.3.4.5.6.7890",
  "patientName": "Hasta Adı",
  "exams": [
    {
      "accessionNumber": "ACC-2026-001",
      "sutCode": "803910",
      "teleCode": "R100000",
      "templateContent": "BULGULAR:\n{{BULGULAR}}\n\nSONUC:\n{{SONUC}}",
      "templateFormat": "txt"
    },
    {
      "accessionNumber": "ACC-2026-002",
      "sutCode": "804102"
    }
  ],
  "callbackUrl": "https://sizin-sunucu.com/api/callback",
  "inputLang": "tr",
  "outputLang": "tr"
}

Metadata Alanları

Alan	Tip	Zorunlu	Açıklama
`patientUid`	string	Evet	DICOM hasta UID'si
`patientName`	string	Hayır	Hasta adı
`exams`	array	Evet	Tetkik listesi (max 20)
`exams[].accessionNumber`	string	Evet	DICOM accession numarası
`exams[].sutCode`	string	Hayır	SGK SUT kodu (6-7 hane)
`exams[].teleCode`	string	Hayır	Teleradyoloji R/S kodu
`exams[].templateContent`	string	Hayır	Özel şablon (TXT, RTF veya HTML)
`exams[].templateFormat`	string	Hayır	"txt", "rtf" veya "html" (templateContent varsa zorunlu). HTML formatında bold/italic korunur.
`callbackUrl`	string	Hayır	Webhook URL (HTTPS zorunlu)
`inputLang`	string	Hayır	Giriş dili (varsayılan: tr)
`outputLang`	string	Hayır	Çıkış dili (varsayılan: tr)

Şablon Placeholder'ları

Özel şablon gönderirseniz şu placeholder'ları kullanın:

{{BULGULAR}} — Bulgular bölümü
{{SONUÇ}} / {{SONUC}} — Sonuç/izlenim
{{İZLENİM}} / {{IZLENIM}} — İzlenim
{{TEKNİK}} / {{TEKNIK}} — Teknik bilgi
{{KLİNİK}} / {{KLINIK}} — Klinik bilgi
{{KARŞILAŞTIRMA}} / {{KARSILASTIRMA}} — Karşılaştırma

Yanıt (202 Accepted)

JSON — 202 Accepted

{
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "examCount": 2,
  "estimatedSeconds": 90,
  "pollUrl": "/api/external/v1/pacs/report/550e8400-...",
  "hmacSecret": "abc123..."
}

Durum Sorgulama

GET /api/external/v1/pacs/report/{jobId}

JSON — Tamamlanmış

{
  "jobId": "550e8400-...",
  "status": "completed",
  "patientUid": "1.2.3.4.5.6.7890",
  "reports": [
    {
      "accessionNumber": "ACC-2026-001",
      "sutCode": "803910",
      "modality": "BT",
      "examName": "Beyin BT",
      "status": "completed",
      "transcript": "Beyin BT incelemesinde...",
      "reportText": "BULGULAR: Normal...",
      "reportHtml": "<p>BULGULAR: Normal...</p>",
      "filledTemplate": "BULGULAR:\nNormal...\n\nSONUÇ:\nPatoloji saptanmadı.",
      "templateUsed": "custom"
    },
    {
      "accessionNumber": "ACC-2026-002",
      "sutCode": "804102",
      "modality": "MR",
      "examName": "Lomber MR",
      "status": "completed",
      "transcript": "...",
      "reportText": "...",
      "reportHtml": "...",
      "filledTemplate": null,
      "templateUsed": "matched"
    }
  ]
}

Webhook Callback

Callback URL belirtildiyse, iş tamamlandığında POST isteği gönderilir:

Header / Body	Açıklama
`X-RaportAI-Timestamp`	ISO 8601 formatında zaman damgası
`X-RaportAI-Signature`	HMAC-SHA256 hex imzası (hmacSecret ile doğrulayın)
Body	Yukarıdaki tamamlanmış yanıt formatı

cURL Örneği

cURL

# Tek ses + birden fazla tetkik metadata'sı gönderin
curl -X POST https://api.raportai.com/api/external/v1/pacs/report \
  -H "Authorization: Bearer rapi_xxxxx" \
  -F "audio=@diktasyon.wav" \
  -F 'metadata={
    "patientUid": "1.2.3.4.5.6.7890",
    "patientName": "Mehmet Yilmaz",
    "exams": [
      {"accessionNumber": "ACC-001", "sutCode": "803910"},
      {"accessionNumber": "ACC-002", "sutCode": "804102"}
    ],
    "callbackUrl": "https://pacs.firma.com/callback"
  }'

Hata Kodları

HTTP	Kod	Açıklama
400	`INVALID_METADATA`	Metadata JSON geçersiz
400	`NO_EXAMS`	Exam listesi boş
400	`TOO_MANY_EXAMS`	Max 20 tetkik
400	`MISSING_ACCESSION`	Accession number eksik
400	`INVALID_SUT_CODE`	SUT kodu formatı hatalı
400	`INVALID_AUDIO`	Ses dosyası geçersiz
401	`UNAUTHORIZED`	API anahtarı eksik/geçersiz
402	`INSUFFICIENT_CREDITS`	Yeterli rapor hakkı yok
409	`DUPLICATE_SUBMISSION`	Aynı ses dosyası zaten gönderildi
429	`RATE_LIMIT`	İstek limiti aşıldı

Rapor Hakkı Sistemi

Düşüm birimi	Her başarılı rapor 1 hak düşer (ses başına değil)
Çoklu tetkik	1 ses dosyasında 7 tetkik varsa ve 7'si başarılıysa 7 hak düşer
Başarısız rapor	Hak düşülmez (0 hak)
Yetersiz hak	HTTP 402 — iş oluşturulmaz, API meşgul edilmez
Kalan hak	Her response'ta `remainingCredits` alanında görünür
Kullanılan hak	Tamamlanan işlerde `creditsUsed` alanında görünür

Örnek: 1 ses dosyasında 5 tetkik gönderdiniz. 4'ü başarılı, 1'i başarısız oldu → 4 hak düşer. Kalan hak: remainingCredits alanında görünür.

Rapor hakkı bittiğinde HTTP 402 {"error": "Yetersiz rapor hakkı. Kalan: 0, Gereken: 5"} döner. Ek hak için iletişime geçin.

Limitler

50 MB

Max Ses Dosyası

Max Tetkik / İstek

İstek / Dakika

~30-45 sn

İşlem Süresi / Tetkik

Desteklenen diller: Türkçe (tr), İngilizce (en), Rusça (ru), Azerice (az), Fransızca (fr), Almanca (de)

Desteklenen ses formatları: WAV, MP3, M4A, OGG, WebM

API anahtarını istemci tarafı (frontend) koduna gömmeyiniz. Sunucu tarafında environment variable olarak saklayın.

Radyolojik RaporlamadaYapay Zeka Devrimi

%95+

10K+

%99.8

7/24

Sektörel Standartlara Tam Uyum

HL7 Entegrasyonu

HIPAA Uyumlu

KVKK / GDPR

Neden RaportAI?

Akıllı Ses Tanıma

AI Destekli Düzenleme

HBYS Entegrasyonu

Güvenli ve KVKK Uyumlu

Yıldırım Hızında

Her Yerden Erişim

Nasıl Çalışır?

Sesli dikte veya manuel giris

AI duzenleme ve sablon esleme

Onay ve kalite kontrolu

HBYS, PACS ve rapor teslimi

RaportAI Nasil Kullanilir?

Bireysel Kullanim

Kurumsal Kullanim

Fiyatlandırma

Standart

₺399 100 rapor hakkı

Uzman

₺3.490 1.000 rapor hakkı

Kurumsal

₺29.900 10.000 rapor hakkı

Kullanım Kılavuzları

Hesap Oluşturun

Giriş Yapın

Ses Kaydı ile Rapor Oluşturun

Şablon Seçin

Raporu Düzenleyin ve Onaylayın

Çıktı Alın

Organizasyon Hesabı Oluşturun

API Anahtarı Alın

Kimlik Doğrulama

Tek Ses → Tek Rapor

Tek Ses → Çoklu Rapor (Multi-Exam)

Rate Limiting

Çoklu Tetkik API

Kimlik Doğrulama

İstek Formatı

Metadata JSON Yapısı

Yanıt (202 Accepted)

Durum Sorgulama

Webhook Callback

cURL Örneği

Hata Kodları

Rapor Hakkı Sistemi

Limitler

Bizimle İletişime Geçin

Radyolojik Raporlamada
Yapay Zeka Devrimi