Bilgi tabanı / Geliştirici

Ateş Görüntüsü

Uygulamada kullandığınız modeller, jeneratörler ve dengeler, kendi kodunuzdan. API, OpenAI ve Anthropic biçimlerini konuşur, bu nedenle çoğu araç ve SDK, temel bir URL ve anahtarı değiştirerek çalışır.

Bu sayfa kolaylık sağlamak amacıyla makine tarafından çevrilmiştir. İngilizce orijinali geçerli olan versiyondur.

Ateş nedir ne demek

HTTP API için nymbot.ai OpenAI veya Anthropic istemcisi tarafından gönderilen aynı talepleri yanıtlar.

• Chat TamamlandıVe o Cevap Ateş Ve antropolojik mesajlar, akış, araçlar, resimler, mantık ve web arama ile, her model için Kataloğu Ve Nymbot'un kendi otomatik yönlendirmesi için.
• Fotoğraflar, Videoları, Konuşma, Transkripsiyon Ve Embeddedler.
• Senin dengesi, Şimşek Top-ups, Cüzdanınızdan otomatik top-up ve a Tarihi Her bir talep maliyeti ne kadar.

Aynı 2 kişiden ödeniyor dengeleri Uygulama gibi, aynı fiyata. API'de abonelik ve ücretsiz indirim yok: her isteğiniz satın aldığınız kredilerden ödenir.

API'nin yapmadığı şey, Nymbot'un kendisinden herhangi bir şey eklemektir. iletileriniz onları gönderdiğinizde modeline gidiyor: Nymbot sistem talimatı yok, bellek yok, tarih veya dil ipuçları yok. geri gelen şey modelin cevabı ve maliyeti hakkında bir not.

Temel URL

Her son nokta altında yaşıyor /api/v1/Bilinmeyen bir yol geri dönüyor 404 Yanlış yöntemle adlandırılan bir yol geri döner. 405Her ikisi de JSON.

API, herhangi bir siteden gelen çapraz kaynak taleplerine yanıt verir, böylece bir tarayıcı sayfasında arama yapabilir. bir tarayıcıya gönderdiğiniz her şey, açan herkes tarafından okunabilir, bu yüzden sadece küçük bir anahtarı olan bir anahtarla yapın. KapıNymbot ile imzalanan son noktalar ( anahtarlar, hesap özetleri, NWC otomatik top-up ve iade ödemesi) istisnadır: bir tarayıcıda sadece Nymbot'un kendi sitelerine cevap verirler. Hesap Başvuru Formu.

Her JSON Vücudu Content-Type: application/jsonHerhangi bir diğer tip reddedilir 415Bir HTML formatında veya bir text/plain Başka bir siteden gelen talep API'ye ulaşamıyor. cURL ile, geçin -H "Content-Type: application/json" ile birlikte -d.

Ateş anahtarları

Anahtarlar uygulamada yapılır. açılır Ateş Web uygulamasının yan çubuğunda veya Android ve iOS'ta menüde ve Anahtar oluşturmaİsterseniz bir isim ve bir kapak ve bir sona erme tarihi verin.

Anahtar bir kez görüntülenir. sayfa kapatmadan önce güvenli bir yere kopyalayın: Nymbot sadece bir parmak izi tutar, böylece size tekrar gösteremez. kayıp bir anahtar kurtarılamaz; iptal edin ve başka bir anahtar oluşturun.

Bir anahtar görünüyor sk-nymbot- 43 harfleri, rakamları, rakamları ve alt notları takip eder. uygulama her anahtarı adını ve kısa bir ipucu ile listeler: sk-nymbot-Qm7x…c2Lw.

• Bir anahtar size aittir. Anahtarınızı harcıyor ve sadece anahtarınızı yapabilir, değiştirebilir veya iptal edebilir. anahtarı olan herkes onunla harcıyor, bu yüzden bir şifre gibi davranın.
• Kapaklar bahis yapıyor. Bir anahtar bir harcama kapısı olabilir ve kapı her gün, her hafta (Pazartesi) veya her ay (ilk), 00:00 UTC'de yeniden ayarlanabilir. Her iki dengeyi sayar, standart bir kredi 10 sats ve bir Pro kredi 100 olarak, bu nedenle bir talep harcadığı bilançoya bakılmaksızın aynı anlamına gelir. Bir talep çalışmadan önce, maliyeti en fazla (tüm kredilere yuvarlanarak) kapının kalanına karşı ayarlanır. 403 key_limit_reached, cevabı kapak altında bile gelseydi; hata ne kadar kaldığını ve kapak ne zaman yeniden ayarlandığını gösterir. max_tokens Bir talep, gerçekte maliyeti ne kadar ve bu kapıya karşı sayılır olarak ücretlendirilir, bu nedenle, sağlayıcı, bıraktığından daha fazla token bildirirse, en son uygun olan talep anahtarı kapının biraz ötesinde alabilir; sonraki birini reddedilir.
• Sadece harcamayı durdurmak için harcanan bir kap. Kapaklı bir anahtar hala dengesini kontrol edebilir, geçmişini okuyabilir, modellerini listeleyebilir, tokenleri sayabilir, üst üste ve zaten başlattığı bir videoda kontrol edebilir.
• Expiry seçeneğidir. Ayarladığınız tarihten sonra anahtar çalışmayı durdurur.
• İptal hemen ve nihai olacaktır. İptal edilmiş bir anahtar bir sonraki isteğiyle başarısız olur. listede kalır, iptal edilmiş olarak işaretlenir, bu nedenle harcama geçmişi hala mantıklıdır.
• Her anahtarın kendi adı vardır ve en fazla 25 aktif anahtarı olabilir. anahtarın yeniden ayarlanma süresini değiştirmek yeni bir döneme sıfırdan başlar.

Aynı sayfa, her anahtarın bu dönemde harcadığını ve en son ne zaman kullandığının toplamını, hem dengelerinizi hem de son API taleplerinizi gösterir. Anahtar Yönetimi.

Bir isteği doğrulamak

Anahtarı bu başlıklardan herhangi birine gönderin. Bunlar eşdeğerdir, bu yüzden istemcinizin varsayılan olarak gönderdiği şeyi kullanın:

Kayıp, bilinmeyen, iptal edilmiş veya sona ermiş anahtar geri dönüşleri 401Kodu ile birlikte missing_api_key, invalid_api_key, revoked_api_key veya expired_api_keyListelenen modeller, ses modelleri ve sesler ve ödeme yöntemleri anahtar gerektirmez.

Görüntüler, video, konuşma, transkripsiyon ve eklentiler aynı zamanda Lightning üzerinden anahtar olmadan bir talep için de ödenebilir: bir tane olmadan talep gönderin ve faturayı ödeyin. 402 Cevap Gönder Anahtar olmadan ödeme.

Anahtar yönetimi, hesap özetleri ve otomatik top-uplar istisnadır: anahtar yerine anahtarınızdan bir imzayı alırlar, böylece sızan bir anahtar daha fazla anahtar oluşturamaz. Hesap Başvuru Formu.

İlk talebiniz

Anahtarı bir çevre değişkenine yerleştirin, sonra bir modelden bir şey isteyin. NYMBOT_API_KEY.

cURL

export NYMBOT_API_KEY="sk-nymbot-..."

curl https://nymbot.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nymbot/auto",
    "messages": [{"role": "user", "content": "What is a Lightning invoice?"}]
  }'

Python

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://nymbot.ai/api/v1",
    api_key=os.environ["NYMBOT_API_KEY"],
)

reply = client.chat.completions.create(
    model="nymbot/auto",
    messages=[{"role": "user", "content": "What is a Lightning invoice?"}],
)
print(reply.choices[0].message.content)

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://nymbot.ai/api/v1",
  apiKey: process.env.NYMBOT_API_KEY,
});

const reply = await client.chat.completions.create({
  model: "nymbot/auto",
  messages: [{ role: "user", content: "What is a Lightning invoice?" }],
});
console.log(reply.choices[0].message.content);

nymbot/auto Nymbot'un kendi yönlendirmesi, standart dengeden ödenir. yerine bir katalog modeli kimliğini koyun, örneğin anthropic/claude-sonnet-5Bu sayede Pro Balance modelini kullanabilirsiniz. Model Listesi Herhangi bir ID verin.

Başvuru ücreti ne kadar

API, uygulamanın yaptığı gibi faturalar yapar.

• Nasıl bir denge. nymbot/auto harcamak için Standartı Bilanço (10 Sats A Credit) Her Diğer Chat Modeli Pro için Standart görüntü jeneratörü ve standart ses standart krediler harcıyor; diğer tüm jeneratörler Pro harcıyor. Girişler standart krediler harcıyor. Transcription, standart bilanço bunu karşılayabildiğinde standart krediler harcıyor ve Pro kredileri başka şekilde harcıyor.
• Ne kadar Bir sohbet isteği, modelin aslında okuduğu ve yazdığı tokenlere, sağlayıcının yayınlanan oranlarına göre ölçülür. Bu fiyatın% 5 ücreti eklenir ve daha sonra 1.5 ile çoğaltılır, böylece sağlayıcının liste fiyatının 1.575 katını ödeyeceksiniz. O canlı Bitcoin fiyatına sats olarak dönüştürülür ve bir kredi binerinde ücretlendirilir. Pro resimler, video ve konuşma, nesil başına, saniyede veya karakter başına ve sesin saniyede transkripsiyonu, aynı ücret ve marjla. Standart resim bir düz 5 standart kredidir ve standart ses bir düz 3.
• En azından En az 0.05 kredi maliyeti olan her ölçülen isteğin maliyeti: standart dengede yarım, Pro'da 5 ödemedir.
• Durun ve sonra oturun. Bir talebi çalıştırmadan önce, gönderdiğiniz ve yazdığınız en çok tokenlere bağlı olarak, dengelerinizden en fazla maliyet alabilir. Basit ASCII dışındaki metin UTF-8 baytlarından büyüktür ve ASCII rakamları ve puanlamalar her bir token olarak sayılır, böylece herhangi bir senaryo, kod ve sayıdaki metin tam olarak tutulur. Kalite bütün kredilerde, en azından bir tanedir, bu nedenle herhangi bir talebin standart dengede en az 10 serbest bahis veya Pro'da 100 serbest bahis gerektirir. Başlangıç için sadece gerçek maliyet ücretlendirilir; gerisi bittiğinde serbest bırakılır. Uzun bir talebi çalıştırdığınız sürece tutar. 402 insufficient_balance Yatırım yapılırsa, ödenen tutarın tamamı ödenir, ödenen tutarın tamamı ödenir (owed_sats İçinde nymbot Konu, ve negatif bir denge). Borçlu olan ilk olarak o dengeye ulaşan sonraki kredilerden ödenir. ödenene kadar, o dengeye hiçbir şey harcanamaz: API tarafından değil, uygulamada yanıtlar, bir transfer veya bir hediye.
• Yeterli kredi yok. Eğer tutar tutarını karşılayamazsa, talep reddedilir. 402 Herhangi bir şey çalıştırılmadan önce hata, hangi denge kısa olduğunu, talep için kaç sats gerektiğini ve kaç tane ücretsiz olduğunu gösterir. max_tokens Daha küçük bir tutuklama anlamına gelir.
• Başarısızlıklar Başarısız bir talep, sağlayıcının başarısız olmadan önce yaptığı iş için fatura etmediği ya da bir web araması ya da nymbot/auto Görev kontrolü zaten çalıştı; o zaman ödediğiniz şey, en azından 0.05 kredi. Kestiğiniz bir akış, sağlayıcının bildirdiği tokenler için ücretlendirilir: Nymbot, bu sayıyı almak için ayrıldıktan sonra 25 saniye kadar sağlayıcının akışını okumaya devam eder. eğer gelmezse, ücret, gönderdiğiniz ve yazdığınız şeylerden hesaplanır ve bu sebeplerden dolayı bir model için tüm çıkış izinlerini içerir.
• Web Arama Bir arama yapıldığında, arama başına dönüştürülen bir arama $0.008 maliyeti, model o zaman yanıt verir veya başarısız olursa olsun. okuduğu sayfalar da giriş olarak modeli gönderilir, böylece tokenlerini ekler.

Her yanıtın maliyeti anlatılır.JSON yanıtları bir nymbot Ödediği tutar, kredilerde ve ödemelerde ödenen tutar ve kalanlar:

Objektif maliyet

"nymbot": {
  "balance": "pro",
  "charged_credits": 0.162,
  "charged_sats": 16.2,
  "balance_credits": 412.425,
  "balance_sats": 41242.5
}

Ücretli yanıtlar da bu başlıkları taşıyor, bu da konuşma gibi JSON olmayan bir yanıtın maliyetini aramak için:

Milyon token başına oranlar, zaten ücret ve marj dahil, Model Listesi Dolar ve Dolar’da ve Fiyat ListesiEğer Bitcoin fiyatı okunamıyorsa, ödeme talepleri iade edilir. 503 price_unavailable ile Retry-After: 60 Tahmin etmek yerine.

Hatalar

Her hata aynı şekle sahiptir, OpenAI müşterileri zaten anlıyor. code Karşılaşabileceğiniz sabit bir isimdir; message İnsanlar için geçerlidir ve değişebilir.

Vücut hatası

{
  "error": {
    "message": "This request needs up to 200 sats (2 credits) on your Pro balance, and 40 sats are free. Catalog models spend the Pro balance. Top up in the Nymbot app or with POST /api/v1/topup/create/btc-lightning.",
    "type": "insufficient_quota",
    "code": "insufficient_balance",
    "param": null,
    "balance": "pro",
    "required_sats": 200,
    "balance_sats": 40
  }
}

İki istisna var:

• /api/v1/messages Anthropic'in hatası biçiminde cevaplar verir, çünkü Anthropic müşterilerinin analiz ettiği budur: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}Tip statüsünü takip eder: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error veya overloaded_error (503).
• İlk baytından önce başarısız olan bir akış isteği, bir olay akışı değil, yukarıdaki durumla birlikte sıradan bir JSON hatası alır.

Hata iletileri hiçbir zaman başka bir hizmetin içsel ayrıntılarını içermez.Bir sağlayıcının kendi hatası size ulaşmadan önce yeniden yazılır.

Sınırları

Bir resme bağlantı, kamuya açık bir barındırmaya yönlendirilmelidir: özel veya yerel bir ağda veya Nymbot'un kendi sitelerinde bir adres reddedilir. uygulamada geçerli olan sağlayıcı temposu burada da geçerlidir, bu nedenle tek bir sağlayıcıya yapılan taleplerin patlaması başarısızlık yerine yavaşlayabilir.

Ateş ne görebilir

API, uygulamaların nasıl olduğu konusunda gizli değildir ve nasıl olduğu hakkında kesin olmak gerekir.

• Sonuç olarak şifrelenmiyor. Uygulamalarda, bir mesaj cihazınızda yalnızca Nymbot'un tuttuğu ve seyahat ettiği anahtarlara mühürlenir. Hediyelik WrapBir API isteği sıradan HTTPS'tir: Nymbot'a giden yolda şifrelenir ve Nymbot'un sunucu bunu işlemek için açık olarak okur.
• Cevaplar ve cevaplar kaydedilmez. Ne tutuluyor faturası: her isteği için zaman, model, tür, token sayısı, maliyet, denge, anahtar ve başarılı olup olmadığını, 90 gün, bu ne Tarih istiyor Aynı isteğin (zaman, tür, model, token sayısı, maliyet, süresi ve web araması kullandığı veya başarılı olup olmadığı) kullanım kaydı, uygulamanın kendisi ile birlikte 90 gün boyunca da tutulur.
• Bir nim için tutulan diğer her şey küçüktür ve burada listelenir. Ateş anahtarları bir hash olarak depolanır, asla anahtar, adları, kısa bir ipucu, harcama kapısı, yeniden ayarlama süresi, sona erme süresi ve ne zaman yapıldı ve son kullanıldı; sadece en yeni 50 iptal edilmiş anahtarlar saklanır. Otomatik Top-Up Cüzdan bağlantısı şifrelenmiş olarak depolanır, eşiği, miktarı ve son top-up sonuçları ile. Video işleri 24 saat boyunca saklanır. Çağrı başına ödenen talepler sadece 7 gün boyunca bir Lightning ödeme hash ve 30 gün boyunca bir hashed iade token bırakır, hiçbir nim ile bağlantılıdır.
• Uygulamayı silmek onu siliyor. A Cihazı Wipe Her bir API anahtarını iptal eder ve siler ve sorgu geçmişini, kullanım kayıtlarını, cüzdan bağlantısını ve video işlerini siler.
• Model sağlayıcısı talebinizi görüyorKatalog modellerinin oluşturucularında çalışması; standart rotalar ve eklentiler Cloudflare'de çalışmaktadır.
• Yayınlanan medya kamuya aittir. Bağlantı olarak gönderilen resimler ve videolar, bir dosyanın adresinin hash olduğu halka açık Blossom dosya barındırma sitelerine yüklenir. bağlantıya sahip herkes açabilir ve Nymbot tekrar indirmeyebilir. b64_json ve oluşturulan bir resim yanıtda geri gelir ve asla yüklenmez.
• Bir jeneratöre verdiğiniz fotoğraflar da öyle. yüklediğiniz bir resim Edit içinya da a olarak gönderin data: Bir jeneratörün URL'si image_url, ilk önce bir kamu Blossom barındırıcısına yüklenir, böylece jeneratör onu alabilir ve aynı şey için de geçerlidir. https:// Bir sohbet isteğindeki resimler, modelin sağlayıcısına değil, Blossom'a gidiyor.
• Bir anahtar sizin nym ile bağlantılıdır. Anahtarın harcadığı her şey anahtarın dengesinden gelir, bu yüzden API kullanımı AnonimAPI kullanımını günlük nyminizden ayrı tutmak istiyorsanız, anahtarları kendi dengesiyle ayrı bir nym'den yapın.

Uygulamaların korumasına ihtiyacınız varsa, uygulamaları kullanın. API, kendi araçlarınızda modellere ihtiyacınız olduğunda kullanılır.

Her bir sonuca

“Nym” aşağıda açıklanan Nostr anahtarınızla imzalanan bir talep anlamına gelir. Hesap Başvuru FormuBu formatları zaten konuşan araçlar için, Araçlar ve SDK'lar, ve Claude Code, Codex ve Cline gibi kodlama ajanları için, kodlama araçları.