GPT-Image 2.6 Flare ve Sunburst yayındaGörsel başına $0.025 ile başlar

Açık kaynak · Geliştirici araçları

OmniaKey MCP:Modeller ajanınızda

Uzak MCP adresi ve tarayıcı yetkilendirmesiyle yapay zekâ asistanınızı OmniaKey'e bağlayın.

Başlayın
Streamable HTTP · OAuth · özel API anahtarıKaynağı görüntüle

01

Limitli bir API anahtarı hazırlayın

Panelde MCP için ayrı bir anahtar oluşturun. Sınırsız kotayı kapatın, düşük bir harcama limiti ve son kullanma tarihi belirleyin, gerekli modelleri seçin.

API anahtarı alın
Streamable HTTP · OAuth
https://api.omniakey.com/mcp

Bu adresi aynen MCP istemcisine girin ve HTTP ile OAuth kullanın. Sonu /mcp/ olan adres yardım sayfasıdır; protokol uç noktası değildir.

02

OmniaKey'i istemciye ekleyin

İstemcinizi seçip ayarları kopyalayın. omniakey kaydı zaten varsa önce eski kaydı değiştirin. Komutlara veya ayar dosyalarına anahtar eklemeyin.

terminal
codex mcp add omniakey --url https://api.omniakey.com/mcp
codex mcp login omniakey

Komutları Codex CLI kurulu terminalde çalıştırın. login tarayıcı yetkilendirmesini açar. Ardından Codex'e dönüp bağlantıyı yenileyin veya yeni oturum başlatın.

İstemcilerin resmî kılavuzları

03

Tarayıcıda yetki verin

İstemci api.omniakey.com/mcp/oauth/authorize adresini açar. Özel anahtarı girmeden önce adresi ve dönüş hedefini kontrol edin.

  1. Anahtarı yalnızca yetkilendirme sayfasının parola alanına yapıştırın. Hizmet anahtarı şifreler; asistana ayrı bir OAuth belirteci verir.
  2. İlk bağlantıyı salt okunur bırakın. Ücretli üretimi ve iptali işaretlemeyin.
  3. İlk kontrol için bir saat seçip Connect'e tıklayın. Daha sonra üretimi açarken günlük istek sınırı da belirleyin; bu sınır anahtarın harcama bütçesinden ayrıdır.

04

Üretim yapmadan doğrulayın

İstemciye dönüp bu isteği gönderin. Model ve şema sorguları üretim görevi başlatmaz.

Agent
OmniaKey MCP veya CLI bağlantısının hazır olduğunu doğrula. Erişilebilir modelleri listele ve ortak medya isteği şemasını oku. Üretim görevi gönderme.

Salt okunur bağlantı omniakey_models, omniakey_schema, omniakey_get_task ve omniakey_wait_task araçlarını gösterir. Model listesinin gerçekten döndüğünü doğrulayın; bağlı göstergesi tek başına yeterli değildir.

Üretimi açın veya erişimi kaldırın

Üretim izniyle yeniden bağlanıp önce fiyatı kontrol edin. Metin için 1–4096 arası max_tokens veya max_completion_tokens gerekir. Aynı anahtarla bağlantıları yönetin. Erişimi kaldırmak yeni çağrıları durdurur; gönderilmiş görevler tamamlanabilir.

Bağlantıları yönetin veya kaldırın
01

Modelinizi bulun

API anahtarınızın erişebildiği modelleri sorgulayın, ardından belgelenen özelliklerini ve güncel fiyatlarını kontrol edin.

02

Bir istek gönderin

Metin ve asenkron görsel, video veya ses görevleri için aynı OmniaKey API'sini kullanın.

03

Kaldığınız yerden sürdürün

Görev id değerini saklayın ve sorgulamaya devam edin. Yerel zaman aşımı ikinci bir üretim başlatmaz.

Girdiden sonuca bir görev

Üretimi açtıktan sonra model ve girdileri kontrol edip tek bir ücretli görev gönderin. Sonucu almak için dönen ID'yi saklayın.

Agent
Anahtarımla kullanılabilen bir görsel modeli bul, zorunlu girdileri ve güncel fiyatı göster. Bir görsel üretmeden önce onayımı bekle. Sabit idempotency anahtarıyla bir kez gönder, görev ID'sini sakla ve ilerlemeyi bu ID ile sorgula. Bekleme süresi dolarsa yeniden gönderme.

05

Sunucunun sunduğu araçlar

Uzak bağlantı yalnızca izin verdiğiniz araçları gösterir. Model, şema ve görev sorguları okuma; üretim ve iptal ise ayrı izinler gerektirir.

AraçNe yaparGerekli izin
omniakey_modelsAPI anahtarınız için kullanılabilir modelleri isteğe bağlı arama ve sonuç sınırıyla listeler.Salt okunur
omniakey_schemaAğ isteği yapmadan ortak sohbet veya medya istek zarfını döndürür.Salt okunur
omniakey_chatAkışsız bir sohbet tamamlama çalıştırır. Yalnızca kullanıcı üretim istediyse kullanın.Ücretli üretim
omniakey_submit_taskKararlı bir idempotency anahtarıyla ücretli görsel, video veya ses görevi gönderir.Ücretli üretim
omniakey_get_taskBir görevi id ile okur ve başarılıysa taze imzalı varlık URL'leri ekler.Salt okunur
omniakey_wait_taskBir görevi en fazla 45 saniye bekler; yerel zaman aşımı görevi iptal etmez veya yeniden göndermez.Salt okunur
omniakey_cancel_taskVar olan bir görevin iptalini ister. İptal süreçte kalabilir, doğrulamak için durumu sorgulayın.İptal isteği

06

stdio ile yerel çalıştırma

Yerel bağlantı için Node.js 22+, npm ve Git gerekir. İstemci sunucuyu başlatır ve anahtarı ortamından okur.

Yerel ayarları ve ortam değişkenlerini göster

Aşağıdan istemcinizin yapılandırmasını seçin. Sunucu yerel stdio kullanır; ortamı yapılandırdıktan sonra istemciyi yeniden başlatın.

~/.codex/config.toml
[mcp_servers.omniakey]
command = "npx"
args = ["--yes", "github:omniakey-com/omniakey-devtools#v0.1.0", "mcp"]
env_vars = ["OMNIAKEY_API_KEY"]

Anahtarı terminaldeki gizli girişe yapıştırıp Enter tuşuna basın. Ajanı bu ortamdan başlatın; anahtarı isteme veya depoya yazmayın.

Bash / zsh
read -s OMNIAKEY_API_KEY
export OMNIAKEY_API_KEY

MCP bağlantısını yenileyip ajandan salt okunur kontrol isteyin. Anahtar eksikse istemci ortam değişkenini almamıştır.

07

Sorun giderme

Tekrar denemeden önce bağlantı türünü, yetkiyi ve anahtar sınırlarını kontrol edin.

Anahtarım reddediliyor

Sınırsız kotayı kapatıp son kullanma tarihi belirleyin ve anahtarın etkinliğini kontrol edin. Model ve IP kısıtlamaları uzak Worker isteklerine izin vermelidir.

401 görüyorum veya bağlanamıyorum

/mcp adresini OAuth olmadan açmak normalde 401 döndürür. İstemciden bağlanıp yetkilendirin. 403 veya HTML gelirse adresi ve olası kenar ağı engellerini kontrol edin.

Üretim araçları görünmüyor

Salt okunur bağlantıda dört araç vardır. Yeniden bağlanıp ücretli üretimi açarak metin ve medya araçlarını ekleyin. İptal için ayrı izin gerekir.

İstek veya bağlantı süresi doldu

Görev ID'sini saklayıp yeni görev oluşturmadan sorgulamaya devam edin. Süresi dolan bağlantıyı yeniden yetkilendirin. Sızan anahtarı panelden devre dışı bırakın.

08

Bu araç hakkında

Streamable HTTP · OAuth

Uzak MCP'yi OmniaKey barındırır. Yerel CLI/stdio örnekleri v0.1.0 sürümünü kullanır. İki yöntem de aynı genel model ve görev API'lerini çağırır.

Lisans
MIT
Mimari
MCP → OAuth → api.omniakey.com/v1
Testler
Protokol ve güvenlik testleri örnek yanıtlar kullanır; gerçek ücretli üretim yapmaz.
Anahtar işleme
Bu kılavuz anahtar toplamaz. Yalnızca API sunucusundaki yetkilendirme formu özel anahtarı alıp şifreler. İstemci ayrı ve iptal edilebilir bir belirteç alır.

Sık sorulan sorular

Model fiyatları değişir mi?

Hayır. Araçlar mevcut API anahtarınızı ve API'nin faturalandırma kurallarını kullanır. Model listeleme ve yerel şema kontrolleri üretim başlatmaz; metin ve medya üretimi ücretli olabilir.

Bekleme süresi dolarsa ne olur?

Uzak görev iptal edilmez veya yeniden gönderilmez. id değerini saklayıp task get veya task wait ile devam edin. Dosya bağlantıları sona erdiğinde yeni bağlantı için aynı görevi sorgulayın.

Barındırılan bir MCP URL'si var mı?

Evet. https://api.omniakey.com/mcp adresini Streamable HTTP ve OAuth ile kullanın. Yerel stdio ayarları da aşağıdadır.

Ajan üretilen dosyaları indirebilir mi?

Hayır. Görev araçları meta veri ve imzalı varlık URL'leri döndürür. URL'ler geçerliyken dosyaları kendi araçlarınızla indirin.

MCP sunucusu bir modelin döndürdüğü araç çağrılarını çalıştırır mı?

Hayır. OmniaKey işlemlerini istemciye sunar; hangi çağrıların yapılacağına istemci ve kullanıcı karar verir. Üretim açık bir kullanıcı isteği gerektirir.

OmniaKey kullanmanın diğer yolları