Isi ihe ọmụma / Ndị na-arụ ọrụ

API nkọwa

The ụdị, generators na balances ị na-eji na ngwa, site na njikwa gị. The API na-ekwu OpenAI na Anthropic formats, otú ọtụtụ ngwá ọrụ na SDK na-arụ ọrụ site na ịmepụta a isi URL na a isi.

A sụgharịrị ibe a n'igwe maka ịdị mma. The English mbụ bụ ụdị nke na-emetụta.

Ọ bụ ihe API

HTTP API na nymbot.ai nke na-ekwu ugbu a chọrọ nke a OpenAI ma ọ bụ Anthropic client na-enweta. Ị ga-enweta:

• Chat NkọwaThe Ngwọta API na Anthropic ozi, na-agba ọsọ, ngwá ọrụ, foto, nchịkọta na web search, maka onye ọ bụla n'ime Katakọla na maka Nymbot onwe ya auto-routing.
• Ngwa, Ngwaahịa, nzọụkwụ, nkọwa na Ịgbado ọkụ.
• Gị Ọnọdụ, Ọgwụgwụ Top-ups, Automatic top-ups si gị wallet na a akụkọ na ihe onye ọ bụla chọrọ na-akwụ ụgwọ.

Ọ na-akwụ ụgwọ site na otu abụọ Ọnọdụ dị ka ngwa, na ugbu a price. Ọ dịghị nchịkọta na ọ dịghị free ego na API: ọ bụla nchịkọta na-akwụ ụgwọ site na credits ịzụta.

Ọ bụghị ihe API na-eme bụ na-agụnye ihe ọ bụla nke Nymbot ya onwe ya. Ihe ozi gị na-aga n'ime ụdị dị ka ị na-ere ha: ọ dịghị Nymbot usoro nkwado, ọ dịghị nchekwa, ọ dịghị ụbọchị ma ọ bụ asụsụ nkwado. Nke a na-abịa na-esonụ ụdị na a nkwado nke ihe ọ na-eri ya.

Usoro URL

Onye ọ bụla endpoint na-ahụ n'okpuru /api/v1/Ọ dịghị anya ụzọ na-atụ anya 404 na a maara ụzọ na-akpọ na usoro na-adịghị mma na-atụ anya 405dị ka JSON.

The API na-atụle cross-source chọrọ site na saịtị ọ bụla, otú a browser page nwere ike na-akpọ ya. Ihe ọ bụla ị na-agba ọsọ na a browser nwere ike ịhụ site na onye ọ bụla na-ekpuchi ya, n'ihi ya, na-eme ya naanị na a key nwere a obere ỌnọdụThe endpoints na-ekwu na gị nym (nke, akaụntụ nkọwa, NWC auto-top-up na refund redemption) bụ ihe dịghị: na a browser ha na-ekwu naanị Nymbot onwe ha na saịtị. Nkọwa akaụntụ chọrọ.

Tinye ọ bụla JSON body na Content-Type: application/jsonAny other type is refused 415, otú a dị nnọọ HTML ụdị ma ọ bụ a text/plain ajụjụ site na saịtị ọzọ nwere ike ịga API. Na cURL, -H "Content-Type: application/json" Ọzọkwa -d.

Onyinye Key

Keys na-emepụta na ngwa. Open ọkụ na sidebar nke web app, ma ọ bụ na menu na Android na iOS, na pịa Ịmepụta KeyJiri ya aha na, ma ọ bụrụ na ị chọrọ, a cap na a ikpeazụ ụbọchị.

Nyocha a na-egosi otu ugboro. Copy ya n'ebe a n'ebe a tọhapụ tupu ị na-agba ọsọ akwụkwọ: Nymbot na-agba ọsọ ọsọ nke ya, otú ọ ga-agba ọsọ ya na-egosi gị ọzọ. A na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ.

A key na-egosi sk-nymbot- na-esonụ site na 43 akara, akara, akara na akara. The ngwa na-egosi onye ọ bụla akara site na aha ya na a obere akara dị ka: sk-nymbot-Qm7x…c2Lw.

• A key bụ nke gị nym. Ọ na-agba ọsọ gị, na naanị gị nym nwere ike ime, gbanwee ma ọ bụ na-agba ọsọ ya. Onye ọ bụla na-ewe nke kacha nwere ike na-agba ọsọ ya, otú na-eme ya dị ka a password.
• Caps na-atụ aro. A key nwere ike nwere a ịkwụ ụgwọ cap, na cap nwere ike ịkwụ ụgwọ ọ bụla ụbọchị, ọ bụla izu (Monday) ma ọ bụ ọ bụla ọnwa (ụbọchị mbụ), na 00:00 UTC. Ọ na-akwụ ụgwọ abụọ ego, a na-akwụ ụgwọ dị ka 10 sats na a na-akwụ ụgwọ Pro dị ka 100, otú ọ na-ekwe nkwa otu ihe na-akwụ ụgwọ a na-akwụ ụgwọ. Tupu a na-agba ọsọ, ihe kachasị ya nwere ike na-akwụ ụgwọ (na-agba ọsọ na-akwụ ụgwọ) na-akwụ ụgwọ na ihe na-abụghị nke cap. Ọ bụrụ na ọ na-abụghị, na-akwụ ụgwọ na-abụghị. 403 key_limit_reached, ọbụna ọ bụrụ na nzọụkwụ ga-abịa n'okpuru cap; erughị na-ekwu ọ bụla na mgbe cap resets. max_tokens A chọrọ na-akwụ ụgwọ ihe ọ bụ n'ezie na ọ na-akwụ ụgwọ na nke na-akwụ ụgwọ na cap, ya mere, ma ọ bụrụ na onye na-akwụ ụgwọ na-akwụ ụgwọ tokens karịa na-akwụ ụgwọ, nke na-akwụ ụgwọ na-akwụ ụgwọ nwere ike na-ewe ihe ọ bụla karịa cap ya; ndị ọzọ na-adịghị.
• Ọ bụ ezie na a na-agba ọsọ ego na-agba ọsọ ego. A key na ya cap nwere ike na-agba ọsọ ego, ịhụ ya akụkọ ihe mere eme, na-esonụ ụdị, na-agba ọsọ tokens, na-agba ọsọ na video ọ na-agba ọsọ.
• Expiry bụ optional. Mgbe ụbọchị ị na-agba ọsọ, isi na-agba ọsọ na-arụ ọrụ.
• Nlekọta bụ ngwa ngwa na ikpeazụ. A na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ.
• Ị nwere ike ime ka 25 na-arụ ọrụ keys, onye ọ bụla nwere aha ya. Ịmepụta oge reset nke a keys na-amalite oge ọhụrụ na zero.

The otu sheet na-egosi onye ọ bụla keys na-eji oge a na n'ozuzu, mgbe ọ na-eji ya na-adịbeghị anya, na gị ego, na gị ọhụrụ API chọrọ. The endpoints n'okpuru ya na-egosi na Ngwaahịa Key.

Authenticate a chọrọ

Kpọọ isi n'ime onye ọ bụla n'ime ndị a headers. Ha bụ dịka, otú iji ihe ọ bụla ndị ahịa gị na-esonụ na-esonụ:

Ọ dịghị, unknown, revoked, or expired key returns 401N'ihi na koodu missing_api_key, invalid_api_key, revoked_api_key ọ expired_api_keyListing ụdị, audio ụdị na akụkọ, na ịkwụ ụgwọ ụzọ na-adịghị mkpa.

Pictures, video, mkpuchi, transcription na embeddings nwere ike na-akwụ ụgwọ maka otu nchịkọta na oge n'elu Lightning na-enweghị isi na-enweghị ihe ọ bụla: na-enye nchịkọta na-enweghị otu na-akwụ ụgwọ akaụntụ na 402 nzọụkwụ. See Ịkwụ ụgwọ on request na-enweghị isi.

Key management, akaụntụ nchịkọta na akpaka top-ups bụ ihe na-enweghị atụ: ha na-enweta akara site na nym gị karịa a key, otú a kpọmkwem na-enweghị ike na-eme ihe ọzọ keys. Nkọwa akaụntụ chọrọ.

gị mbụ chọrọ

Pịa isi na a gburugburu gburugburu gburugburu gburugburu gburugburu gburugburu gburugburu gburugburu gburugburu gburugburu gburugburu gburugburu gburugburu gburugburu gburugburu gburugburu 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 bụ Nymbot's onwe routing, na-akwụ ụgwọ site na standard ego. Tinye a catalog model's id n'ebe ahụ, dị ka anthropic/claude-sonnet-5, iji ụdị a site na Pro ego. Ọnụ ọgụgụ Gbanwee onye ọ bụla ID.

Olee otú ị na-akwụ ụgwọ

The API na-akwụ ụgwọ n'ụzọ zuru ezu otú app na-eme.

• Ọ bụ ezigbo. nymbot/auto Ịgbanwee nkọwa ego (10 sats a credit). Onye ọ bụla ọzọ chat model na-eji Ọnụ ego (100 sats a credit). The ọkọlọtọ image generator na ọkọlọtọ voice na-eji ọkọlọtọ credits; onye ọ bụla ọzọ generator na-eji Pro. Embeddings na-eji ọkọlọtọ credits. Transcription na-eji ọkọlọtọ credits mgbe ọkọlọtọ ego nwere ike ime ya, na ọkọlọtọ credits na-adịghị. The model list na-ekwu na ọkọlọtọ nke onye ọ bụla model na-eji.
• Ọnụ ọgụgụ A na-atụ aro na-atụ aro na tokens na ụdị na-eme na-akpọ na-ekwu, na ahịa nke ndị na-ekwu na-ekwu. Nke a price nwere 5% ụgwọ na-agba ọsọ ya na 1.5, otú ị na-akwụ ụgwọ 1.575 ugboro nke nkọwa price nke ndị na-ekwu. Ọ na-agba ọsọ na-akwụ ụgwọ na live Bitcoin price na na-akwụ ụgwọ na thousandths nke a credit. Pro foto, video na asụsụ na-akwụ ụgwọ per generation, per second ma ọ bụ per character, na transcription per second nke audio, na otu ụgwọ na margin. The ọkọlọtọ image bụ a flat 5 ọkọlọtọ credits na a standard voice a flat 3.
• Ọ dịghị ala. Onye ọ bụla na-agba ọsọ chọrọ na-agba ọsọ dịkarịa ala 0.05 credit: a nta na-atụ anya na ụkpụrụ, 5 sats na Pro. A na-agba ọsọ nke a credit na-agba ọsọ, na-adịghị na-agba ọsọ mgbe ọ bụla.
• Kpọọ, mgbe ahụ na-atụle. Tụkwasịnụ ASCII dị n'okpuru UTF-8 bytes ya, na ASCII akụkọ na-akwụ ụgwọ dị ka a token n'okpuru onye ọ bụla, otú a na-akwụ ụgwọ n'okpuru ihe ọ bụla, koodu na nọmba na-akwụ ụgwọ n'okpuru ihe ọ bụla. A na-akwụ ụgwọ na-akwụ ụgwọ n'okpuru ihe ọ bụla, n'agbanyeghị otu, otú ọ bụla na-achọ ka ọ bụla na-achọ ka ọ dịkarịa 10 na-akwụ ụgwọ free na-akwụ ụgwọ ọkọlọtọ ma ọ bụ 100 na-akwụ ụgwọ na-akwụ ụgwọ na-akwụ ụgwọ na-akwụ ụgwọ na-akwụ ụgwọ. A na-akwụ ụgwọ na-akwụ ụ 402 insufficient_balance Ọ bụrụ na ihe na-eme ka a na-eme ka a na-eme ka a na-eme ka a na-eme ka a na-eme ka a na-eme ka a na-eme ka a na-eme ka a na-eme ka a (owed_sats Na The nymbot Object, na a na-egbochi ego). Nke a na-abịa na-akwụ ụgwọ mbụ site na ndị ọzọ na-enweta ego a. Mgbe ọ na-akwụ ụgwọ, ọ dịghị ihe ọ bụla na ego a nwere ike na-eji: ọ dịghị site na API, na-akwụ ụgwọ na ngwa, a na-akwụ ụgwọ ma ọ bụ ajụjụ.
• Ọ dịghị mkpa credit. Ọ bụrụ na ego na-enweghị ike na-ekpuchi nchekwa, a na-atụ aro na 402 tupu ihe ọ bụla na-agba ọsọ. Ngwuputa na-ekwu na nke ego bụ obere, na ọtụtụ sats chọrọ na ọtụtụ bụ free. A obere max_tokens Ọ na-ekwe omume obere.
• ọsọ A chọrọ na-adịghị mma na-adịghị mma, ma ọ bụrụ na ndị ọrụ na-adịghị mma na-adịghị mma na-adịghị mma na-adịghị mma, ma ọ bụ na-adịghị mma na-adịghị mma na-adịghị mma na-adịghị mma. nymbot/auto Nymbot na-eme ka ị na-agba ọsọ na 25 sekọnd mgbe ị na-agba ọsọ iji nweta nke a. Ọ bụrụ na ọ na-agba ọsọ ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ.
• Web nchọpụta $ 0.008 a search, na-agbanwe na sats, mgbe a search na-agba ọsọ, ma ọ bụ na ụdị mgbe ahụ na-ekwu ma ọ bụ na-agba ọsọ. The peeji nke ọ na-agba ọsọ na-esonụ na model dị ka input, otú ha na-agba ọsọ ya.

Onye ọ bụla nsogbu na-egosi ihe ọ bụla na-eri. JSON nsogbu na-egosi a nymbot Object na ego ọ na-eji ya, ego na-akwụ ụgwọ na sats, na ihe na-abụ:

Ọnụahịa Object

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

Ịkwụ ụgwọ ntụziaka na-egosi ndị a headers, nke bụ ebe ị ga-achọ ego nke ntụziaka na-abụghị JSON, dị ka ntụziaka:

Ụdị per million tokens, na-agụnye ụgwọ na margins, bụ na Nkọwa nke na dollars na sats, na na The price sheetỌ bụrụ na price nke Bitcoin nwere ike ịhụnanya, na-akwụ ụgwọ chọrọ na-aga 503 price_unavailable na Retry-After: 60 Ọ bụ ezie na ịhụnanya.

nzọụkwụ

Onye ọ bụla nsogbu nwere otu ụdị, onye OpenAI ahịa na-amaghị ya. code bụ a na-adịghị mma aha na ị nwere ike na-atụle na; message Ọ bụ maka ndị mmadụ na nwere ike ịgbanwe.

Ngwuputa Body

{
  "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
  }
}

2 Ọnụ ọgụgụ:

• /api/v1/messages na-ekwu na Anthropic's error format, n'ihi na nke a bụ ihe Anthropic ahịa na-agụnye: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}.The ụdị na-esonụ status: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error ọ overloaded_error (503).
• A na-agba ọsọ ọsọ na-agba ọsọ tupu ya mbụ byte na-enweta a na-agba ọsọ JSON na ọnọdụ n'elu, ọ bụghị a na-agba ọsọ. A na-agba ọsọ mgbe na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ.

Error ozi na-adịghị na-agụnye n'ime ndị ọzọ na ọrụ. A na-agba ọsọ nke onye na-arụ ọrụ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ.

Ụkpụrụ

A njikọ na foto ga-egosi na a nkwurịta ụka: a adreesị na a private ma ọ bụ n'okpuru netwọk, ma ọ bụ na Nymbot onwe ya na saịtị, na-atọgide. Provider nzọụkwụ nke na-eji na ngwa na-atọgide n'ebe a, otú a ọgwụgwụgwụgwụ nke chọrọ na otu nkwurịta ụka nwere ike na-agba ọsọ ma ọ bụ na-adịghị.

Ihe API nwere ike ịhụ

The API bụghị onwe ya na otú ngwa bụ, na ọ dị mkpa ịbụ n'ezie banyere otú.

• Ọ bụghị end-to-end encrypted. N'ime ngwa, a nkwurịta okwu na ngwa gị na keys naanị Nymbot nwere na-aga dị ka a Ọnọdụ WrapA API chọrọ bụ obi HTTPS: ọ na-akpali akpali n'oge na Nymbot, na Nymbot na-akpọ ya na-ekpuchi ya na-ekpuchi ya.
• Ndị na-akwụ ụgwọ na ndị na-akwụ ụgwọ na-adịghị akwụ ụgwọ. Ọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ na-agba ọsọ ajụjụ History A nchekwa nke iji nke otu ajụjụ (time, ụdị, model, token akara, ego, oge na ma ọ bụrụ na ọ na-eji web search ma ọ bụ na-eme ka) na-achịkwa maka 90 ụbọchị, na ngwa ya onwe ya.
• Onye ọ bụla ọzọ na-achịkwa maka a nym bụ obere na a na-egosi ebe a. Onyinye Key Ndị a na-agụnyere dị ka a hash, na-enweghị isi, na aha ha, a obere nso, ego cap, reset oge, ikpeazụ oge na mgbe ha e mere na na-eji ya na ikpeazụ; naanị ndị ọhụrụ 50 na-agba ọsọ keys na-achịkwa. A Automatic ịgbado ọkụ The wallet njikọ na-achịkwa encrypted, na ya nso, ego, na ihe na-esonụ nke na-esonụ n'elu-up. Video ọrụ na-achịkwa maka 24 awa. Ịkwụ ụgwọ ụgwọ kwa na-akpọ naanị a Lightning ịkwụ ụgwọ hash maka 7 ụbọchị na a hashed ịkwụ ụgwọ token maka 30 ụbọchị, na-agụnye na-enweghị nym. Ọnwa na-adịghị ike na-akwụ ụgwọ na-achịkwa dị ka na-eme ka a n'elu-up na-akwụ ụgwọ ha.
• Wiping the app na-egbochi ya. A ngwa Wipe na-agba ọsọ ọ bụla API key, na-agba ọsọ nchịkọta nchịkọta, nchịkọta iji, nchịkọta njikọ na video ọrụ. The ego na ihe ọ bụla ụgwọ na-enweta na-agba ọsọ.
• Usoro nke model nwere ike ịhụ gị chọrọ, dị ka ọ na-eme site na ngwa. Catalog models run at their makers; standard routes and embeddings run on Cloudflare.
• Ndị na-emepụta media bụ ndị na-emepụta. Ngwa na video na-ere dị ka njikọ na-agba ọsọ na-akpọ Blossom faịlụ ụlọ ọrụ, ebe adreesị faịlụ bụ ya hash. Onye ọ bụla nwere njikọ nwere ike ịgbanwe ya, na Nymbot nwere ike ịgbanwe ya ọzọ. b64_json na a na-emepụta image na-aga n'ime ntụziaka na ọ na-enweghị ikpe.
• Ya mere, na foto ị na-enye a generator. A foto ị na-eduzi ekwentị, ma ọ bụ gbasara a data: URL na generator image_url, na-agba ọsọ na a public Blossom nchịkọta mbụ ka generator nwere ike ime ya, na nke a na-atụle ya. A picture sent by https:// na njikọ na-agba ọsọ dị ka na njikọ. Photos na a chat chọrọ na-aga na model's provider, adịghị na Blossom.
• A key na-agụnye gị nym. Ihe niile a key na-eji na-enweta site na n'akụkụ nke gị nym, otú API iji bụghị anụmanụỌ bụrụ na ị chọrọ API iji na-echekwa dị iche iche na gị na-arụ ọrụ nile, na-eme ka keys si a pụrụ iche nym na ya onwe ya ego.

Ọ bụrụ na ị chọrọ nchedo nke ngwa, na-eji ngwa. The API bụ maka mgbe ị chọrọ ụdị n'ime ngwa gị.

Onye ọ bụla endpoint

“Nym” na-ekwe omume na-ekwu na gị Nostr key, nke a na-ekwu na Nkọwa akaụntụ chọrọN'ihi na ngwá ọrụ na-esonụ ndị a formats, ịhụ Ngwá Ọrụ na SDKs, na maka coding ihe dị ka Claude Code, Codex na Cline, ịhụ Ngwaọrụ Coding.