TR ▾

OCR son işlemi için sansürsüz LLMhttps://api.llmocrapi.com/v1

llmocrapi.comKılavuz

OCR API Dokümantasyonu: Uç Noktalar, Modlar ve Limitler

Bu sayfa, geliştiricilerin tam yüzeyi tek bir yerde bulması için OCR API dokümantasyonu olarak çalışır: iki uç nokta, dört istek modu, limitler ve hatalar. API, bir OCR motoru tarafından zaten üretilmiş metni temizler; görüntüleri okumaz.

güncellendi

API dokümantasyonu modlarını temsil eden akış düğümleri, nokta akışı ve bir parantez şekliyle yüzen referans panelleri

Temel noktalar

  • İki yöntem vardır: POST /v1/chat/completions ve GET /v1/models, bir Bearer anahtarıyla kimlik doğrulaması yapılır.
  • Akış, JSON modu ve fonksiyon çağırma, model kimliği uncensored olan OpenAI sohbet formatını izler.
  • Limitler: Tam anahtar için eşzamanlı 8 istek ve dakikada 300, deneme anahtarı için 2 ve 60, 8 MB gövde.
  • Aşırı yüklenmedeki hatalar, yavaşlamanız veya paralelliği azaltmanız gerekip gerekmediğini belirten bir kodla birlikte HTTP 429'dur.

Genel bakış ve kimlik doğrulama

Hizmet, barındırılan bir OpenAI uyumlu metin API'sidir. Bu sitedeki amacı bir OCR işinin ikinci yarısıdır: bir OCR motorunun ürettiği ham dizgiyi alır ve temiz metni, yapılandırılmış alanları veya işaretlenmiş satırları döndürür. Giriş yalnızca metindir. Görüntü, ses veya video girişi veya çıktısı, embedding ve ince ayar (fine-tuning) yoktur.

Her şey https://api.llmocrapi.com/v1 temel URL'sinin altındadır. Kimlik doğrulama standart bir Bearer başlığıdır: Authorization: Bearer YOUR_KEY. Anahtarınızı Google ile veya e-posta ve şifre ile kaydolduktan sonra API anahtarı sayfasında oluşturursunuz. Uç noktanın arkasındaki model, bağımsız bir sağlayıcı tarafından yürütülen tek bir açık ağırlıklı modeldir. Bu, herhangi bir model satıcısının resmi API'si değildir ve satıcılar arasında bir yönlendirici değildir. Model kimliği her zaman uncensored'dir.

Bir referans yerine uygulamalı bir anlatım için, dokümantasyon bölümündeki hızlı başlangıç, ilk isteği adım adım kapsar.

Uç noktalara genel bakış

Yöntem ve yolAmaç
GET /v1/modelsKullanılabilir modelleri listeler. Bu uç noktayı bir anahtar kontrolü olarak kullanın.
POST /v1/chat/completionsBir mesaj listesi üzerinde modeli çalıştırır. Akış, JSON modu ve araçları destekler.

Bu tüm yüzeydir. OpenAI iletişim formatıyla eşleştiğinden, temel URL ve anahtar ayarlamanıza olanak tanıyan herhangi bir istemci kütüphanesi çalışacaktır. En hızlı doğrulama şudur:

curl https://api.llmocrapi.com/v1/models \
  -H "Authorization: Bearer $LLMOCR_API_KEY"

Geçerli bir anahtar, uncensored içeren bir model listesi döndürür. Yanlış bir anahtar, sorunun anahtarınızda olduğunu ve istek gövdenizde olmadığını belirten bir kimlik doğrulama hatası döndürür.

İstek parametreleri

Bir sohbet tamamlama isteği model ve messages gerektirir. Aşağıdaki isteğe bağlı alanlar modele iletilir.

  • temperature ve top_p: örnekleme kontrolleri. OCR onarımı için temperature 0 kullanın, böylece aynı giriş aynı çıktıyı verir.
  • max_tokens: isteğe bağlı. Belirtmezseniz, tamamlama, isteminizden sonra kalan 100.000 token penceresinin ne kadarı varsa onu kullanabilir. Çağrı başına maliyet için bir üst sınır istediğinizde ayarlayın.
  • stop: oluşturmayı sonlandıran dizgiler. İşaretleyiciler arasında çıktı istediğinizde kullanışlıdır.
  • seed: çalışmalar arasında tekrarlanabilirliği artırır.
  • presence_penalty ve frequency_penalty: iletilir. Temizleme için bunları sıfırda bırakın; çünkü cezalar modeli tablo başlıkları gibi tekrarlanan geçerli kelimeleri değiştirmeye itebilir.
  • stream, response_format, tools ve tool_choice: sonraki üç bölümde ele alınmıştır.

Bağlam penceresi, istem ve tamamlamayı birlikte 100.000 token olarak sayar ve istek gövdesi 8 MB'a kadar olabilir. Pratikte token limiti önce gelir.

Akış yanıtları

"stream": true ayarlayın; API metin oluşturulurken Server-Sent Events gönderir. Akış, bir kişinin temizlenmiş bir paragrafın belirdiğini izlediği editör gibi etkileşimli araçlara yardımcı olur. Token kullanımı akışın sonunda bildirilir, böylece maliyeti kaydedebilirsiniz.

import os
from openai import OpenAI

client = OpenAI(base_url="https://api.llmocrapi.com/v1", api_key=os.environ["LLMOCR_API_KEY"])

stream = client.chat.completions.create(
    model="uncensored",
    stream=True,
    messages=[{"role": "user", "content": "Fix this OCR text: th1s is a sam-\nple."}],
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if getattr(chunk, "usage", None):
        print("\ntokens:", chunk.usage.prompt_tokens, chunk.usage.completion_tokens)

Bir detay verimi (throughput) etkiler. Akışlı bir istek, akış sona erene kadar eşzamanlılık yuvasını işgal eder. Kodunuz yarıda okumayı bırakır ve bağlantıyı açık bırakırsa, bu yuva meşgul kalır. Akışı açıkça kapatın veya sonuna kadar tüketin.

JSON modu

JSON modu, modelin metin yerine bir JSON nesnesiyle yanıt vermesini ister. response_format ile etkinleştirin ve talimatlarınızdaki anahtarları tanımlayın.

{
  "model": "uncensored",
  "temperature": 0,
  "response_format": {"type": "json_object"},
  "messages": [
    {"role": "system", "content": "Return JSON with keys 'text' (cleaned string) and 'uncertain_lines' (array of integers)."},
    {"role": "user", "content": "line one\nl1ne two\nline thr3e"}
  ]
}

Ayrıştırırken temkinli olun. JSON modu çıktıyı şekillendirir, ancak veritabanınıza girmeden önce anahtarları ve türleri doğrulamaya devam etmelisiniz. Bir yanıt max_tokens tarafından kesildiyse, JSON eksik olabilir; bu nedenle limiti artırın veya daha küçük parçalar gönderin.

Fonksiyon çağırma

Fonksiyon çağırma, modelin metin yazmak yerine kodunuzdan bir şey yapmasını sağlar. OCR işleri için yaygın bir kullanım yapılandırılmış düzeltmeler döndürmektir: model, satır numarası ve değiştirme ile bir fonksiyonu çağırır ve kodunuz bunu uygular. Araçları tools dizisinde tanımlayın, davranışı tool_choice ile seçin ve sonuçları role: "tool" ile mesaj olarak döndürün. Akış sırasında, fonksiyon çağrıları tool_calls farkları olarak artımlı olarak gelir.

tools = [{
    "type": "function",
    "function": {
        "name": "replace_line",
        "description": "Replace one line of the OCR text with a corrected version.",
        "parameters": {
            "type": "object",
            "properties": {
                "line": {"type": "integer"},
                "text": {"type": "string"},
            },
            "required": ["line", "text"],
        },
    },
}]

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "1: The inven-\n2: tory was com1leted."}],
    tools=tools,
    tool_choice="auto",
)
for call in resp.choices[0].message.tool_calls or []:
    print(call.function.name, call.function.arguments)

Bağımsız değişkenler bir JSON dizgesi olarak döner. Bunları ayrıştırın, değişikliği uygulayın ve konuşmaya devam ederseniz, eşleşen tool_call_id ile bir role: "tool" mesajını ekleyin. Bu desen, modelin yalnızca değiştirdiği satırları döndürdüğü için çıktı tokenlarını düşük tutar.

Metin temizlemeye uygun ayarlar

Bir referans, önerilen bir başlangıç noktasıyla daha kullanışlıdır, bu nedenle parametrelerin OCR onarımı için genellikle nasıl birleştirildiği aşağıda. Bunlar ölçülmüş kıyaslamalar (benchmark) değil, görevin davranışından gelen önerilerdir.

  • Deterministik onarım: temperature 0, ceza yok, sabit bir seed. Dünkü çıktıyı yeniden üretmesini istediğiniz arşivler için bunu kullanın.
  • Alan çıkarma: temperature 0, response_format json_object olarak ayarlanmış ve beklediğiniz en büyük nesnenin biraz üzerinde bir max_tokens limiti.
  • Etkileşimli inceleme: stream true ve kısa bir sistem promptu, böylece bir editör düzeltilmiş metnin belirdiğini görebilir ve oluşturmayı erken durdurabilir.
  • Satır düzeyinde düzeltmeler: replace_line tarzında bir fonksiyonla araçlar, böylece model yalnızca değişenleri döndürür.

Mesaj rolleri yaygın kuralı izler: kalıcı talimatlar için system, OCR metni için user, çok adımlı oturumdaki önceki yanıtlar için assistant ve fonksiyon sonuçları için tool. Talimatları sistem mesajına ve ham metni kullanıcı mesajına yerleştirin. OCR metni kendisi bir talimat gibi görünen bir şey içeriyorsa (örneğin önceki metni yok sayan bir tabela), ayrım, kullanıcı mesajının onarılacak veri olduğunu ve takip edilecek bir komut olmadığını modelin anlamasını kolaylaştırır. Bunu sistem promptunda açıkça belirtin.

Her çağrı için X-Request-Id değerinin kaydını tutun. Bir sayfa yanlış gelirse ve incelenmesini isterseniz, destek bunun için tam olarak bu tanımlayıcıya ihtiyaç duyar.

Limitler, başlıklar ve hatalar

LimitTam anahtarDeneme anahtarı
Eşzamanlı istekler82
Dakikada istek30060
Maksimum gövde boyutu8 MB8 MB
Bağlam penceresi100.000 token100.000 token

Yanıtlar X-Request-Id (destek için alıntılayın), X-Balance-USD (kalan krediniz), X-RateLimit-Limit-Requests ve X-RateLimit-Limit-Concurrency içerir.

Bir limiti aştığınızda API HTTP 429 yanıtı verir. rate_limited hata kodu bir dakikada çok fazla istek anlamına gelir, bu yüzden yükü dağıtın. concurrency kodu aynı anda işlenen çok fazla istek anlamına gelir, bu yüzden worker sayısını azaltın. Retry-After: 5 başlığı taşıyan bir 429 geçici aşırı yüklenmeyi bildirir: beş saniye bekleyin ve tekrar gönderin. Başarısız ve reddedilen istekler ücretlendirilmez, bu yüzden bir yeniden deneme döngüsü güvenlidir.

Faturalandırma token başına yapılır: 1M giriş için $0.15 ve 1M çıktı için $0.50, asla sona ermeyen ön ödemeli krediden düşülür. Bakiye yükleme miktarları ve bonuslar için fiyatlandırma sayfasına bakın. İstemler eğitim için kullanılmaz. İçerik kuralı tek bir katı sınırdır: reşit olmayanların yer aldığı cinsel içerik yoktur. Politika soruları destek adresine gider.

Sorular ve cevaplar

API hangi uç noktaları sunar?

İki: Oluşturma için POST /v1/chat/completions ve model listesi için GET /v1/models. Her ikisi de aynı Bearer anahtarını kullanır.

Akış ve fonksiyon çağırma destekleniyor mu?

Evet. Sonunda kullanım bilgisiyle SSE için stream'i true olarak ayarlayın ve fonksiyon çağrıları için tools ve tool_choice kullanın; sonuçları role tool mesajları olarak döndürün.

Maksimum giriş boyutu nedir?

Bağlam penceresi, istem ve tamamlama için 100.000 token'dır ve istek gövdesi 8 MB'a kadar olabilir.

Neden 429 hatası aldım?

Dakikada istek sayısını (rate_limited), eşzamanlı istekleri (concurrency) aştınız veya geçici aşırı yüklenmeye çarptınız (Retry-After: 5 dahil). Bekleyin ve yeniden deneyin.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve temel URL'yi değiştirin. Kurulum bu kadar basit.

API anahtarı al