መሰረት ፍልጠት / ደቨሎፐራዊት (ኣልጋእ ስራሕ)

API ሓፈሻዊ መግለጺ

ኣብቲ ኣፕ ካብቲ ናትኩም ኮድ ዝትጥቀመሎም ሞዴላት፣ ጀነሬታታት ከምኡውን ሚዛን። እቲ API ናይ OpenAI ከምኡውን ናይ Anthropic ኣቀራርባታት ስለ ዝጥቀመ፣ መብዛሕቲ መሳርሒታትን SDKs ን መሰረታዊ URLን ቁልፍን ብምቕያር ይሰርሑ።

እዚ ገጽ ንመመላእታ ብማሽን ዝተተርጎመ እዩ። እቲ ናይ እንግሊዝኛ ኦሪጅናል እቲ ዝምልከቶ ስሪት እዩ።

API እንታይ እዩ?

ኣብቲ ዘሎ HTTP API nymbot.ai እቲ OpenAI ወይ Anthropic ዓሚል (client) ድሮ ዝሰድዶ ምስቲ ተመሳሳሊ ሕቶታት ዝምልስ፦ ክትረኽብ ኢኻ፦

• መፍጻማታት መደብ (Chat Completions), እቲ መደresponses API እና መልእኽቲ Anthropicከስትሪሚንግ፣ ካለው መሳርሒታት፣ ምስሊታት፣ ምክንያታዊነትን ናይ ዌብ ፍለጋን ምስቲ ኣብቲ ዘሎ ኩሉ ሞዴል፣ መዝገብ ን ኣፍሊግ ን Nymbot ናጻ ኣውቶ-ራውቲንግ።
• ታንታታት, ቪድዮ, ንግግር, ትራንስክሪፕሽን እና ኤምባዲንግስ.
• ናትካ ሚዛን, ናይ Lightning ምልኣኽ, ካብ ዎሌትካ ዝመጽእ ኣውቶማቲክ ኣተሓሳስሪ መክፈቲ (top-ups) ከ...ን እውን ታሪኽ ነፍሲ ወከፍ ሕቶ ክሳብ ክንደይ ከፍ ይብል?

ካብ ተመሳሳሊ ክልተ እቲ ተከፈለ ሚሕዝርታት ከመተግበሪኡ፣ ብተመሳሳሊ ዋጋታት። ኣብ API፡ ኣይብሉን ናይ ወርሓዊ ክፍሊት (subscription) ኣይብሉን ናይ ናጻ ኣገልግሎት (free allowance) ኣይብሉን እዮም፦ ዝተሓሻሹ ኩሉ ሕቶታት ብዝገዛእኩም ክሬዲት ይኽፈሉ እዮም።

እቲ API ዝገብሮ ዘይኮነ ነገር ናይ Њምቦት (Nymbot) ናይ ገዛእ ራሱ ዝኾነ ነገር ምወሃብ እዩ። ብትእዛዝካ ዝሰደዱ መልእኽትታት ከም ዝሰደዱ ናብ ሞዴል ይኸውን እዮም፦ ናይ Њምቦት ስርዓተ-መመሪያ (system prompt)፣ ትዝታ (memory)፣ ወይ ድማ ፍንታይ ዕለት ወይ ቋንቋ ኣይተሓሓዙን። ዝመጽእ ነገር ድማ መልሲ እቲ ሞዴልን ክሳብ ክንደይ ወጻኢ ከም ዝኸውን ዘተ ገሊጹ ዝተጻሕፈ መዘኻኸሪ ጥራይ እዩ።

መሰረታዊ URLታቶ

ኩሉ ኤንድፖይንት (endpoint) ኣብ ትሕቲ ይነብር /api/v1/ኣለመታወቅ ዝገበሮ መገዲ ይምለስ። 404 ንጹር መገድ ብትኽበተ ክትሰምሮ ዝኽእል፡ ብጌጋ ሜቶድ ምስ ተጠራም ↩️ ይመልስ 405፣ ክልቲዎሙ ከJSON።

እቲ API ካብ ዝኾነ ሳይት ዝመጽእ cross-origin requests ይምልስ፣ ስለዚ брау저 ገጽ ክጽውዖ ይኽእል እዩ። እንተኾነ ግን፣ ናብ брау저 ትሰድዶ ዝኾነ ነገር ዝኸፈተ ሰብ ክዕቅቦ ይኽእል እዩ፣ ስለዚ ነዚ ክትገብሮ ምስ ቁልፊ ጥራይ እዩ ዘለኻ ዘይነዊኢ መጠን ዘለዎ። መኽደኒብናምካ (nym) ተመርምዞም ዘለዉ ኤንድፖይንትታት (ቁልፍታት፣ ጸብጻብ ሒሳብ፣ NWC ኣውቶ-ቶፕ-ኣፕን ምልዛብ ምልጋጽን) ውልቀ ነገር እዮም፦ ኣብ ብራውዘር፡ ንናይ Nymbot ናትቲኦም ሳይትታት ጥራይ እዮም ዝመልሱ። ርአ መጠይቕታት ኣካውንት ምፍራምን ምትታይን.

ኩሉ JSON body ምስ ኣስምቶ ስደድ Content-Type: application/jsonዝያዳ ዝኾነ ዓይነት ብ... ይኸውን ተመዊዒቱ 415, ስለEtsa ተራ HTML Form ወይስ text/plain ካብ ካልእ ሰበብ ዘሎ ሕቶ እቲ API ክትብጽሖ ኣይከኣለኩምን። ብ cURL፣ ኣስተላልፍ -H "Content-Type: application/json" ብሓባር ምስ -d.

API ቁልፊታት

መደlees ኣብቲ ኣፕሊኬሽን ይ作ወዓሉ። ክፈት API ኣብቲ ናይ ዌብ ኣፕliケーション ወልይ (sidebar)፣ ወይ ኣብቲ ኣብ Android ከምኡውን iOS ዘሎ ሜኑ፣ ከምኡ ብምእታው ቁልፊ ፍጠርስም ስደልዎ፣ ከፈለኻ ከዮም፣ ገደብን ናይ መወዳእታ መዓልትን።

መራኸት (key) ንዴቲ ሓደ ጥራይ እዩ ዝርአ። ነቲ ሰነድ ቅድሚ ምዝጋጋእካ ኣብ safe ቦታ ኮፒ ግበሮ፦ Nymbot ናይቲ መራኸት ባሻዊ ኣጸራርቶ (fingerprint) ጥራይ እዩ ዘ 보ቅ፣ ስለዚ ድጋሚ ክርእየካ ኣይክእልን እዩ። ዝጠፋእ መራኸት ክመልስ ኣይከኣልን እዩ፤ ኣኽሊሎ (revoke) ከምኡ ድማ ሓደ ሓደስቲ ሥራ።

መደገፊቲ ከምዚኣ ይመስል sk-nymbot- ብ43 ፊደላት፣ ቁጥራት፣ ኣDashታትን ንኣትታትን ዝተኸታተለ። እቲ ኣፕ ብስማቱ ከምኡውን ከምዚኣብ ዝመሰለ ሓጺር ፍታሕ ብሓደ ሓደ መደብ ዝርዝር የርእየ። sk-nymbot-Qm7x…c2Lw.

• ሓደ ቁልፊ ንስምኻ እዩ። ካንተን ባላንስ ይውስድ፣ ንምባኻ እውን ንትኽእል ክትፈጥሮ፣ ክትቕይሮ ወይ ክትሰርዝዎ እዩ። መራሒ (key) ዘለዎ ዝኾነ ሰብ ብዛዕባኡ ክውስድ ስለ ዝኽእል፣ ከም ፓስወርድ (password) ተሓዛዮ።
• ካፕሱ ኣብ ሳትሰታት ኣሎ። ሓደ መፎክሪ (key) ናይ ወጻኢ ገደብ ክህልዎ ይኽእል እዩ፡ እቲ ገደብ ድማ ኣብ በቲ 00:00 UTC፡ ኣብSE ኩሉ መዓልቲ፡ ኩሉ ሰሙን (ሰኑይ) ወይ ኩሉ ወርሒ (ቀዳማይ ዕለት) ክቕየር ይኽእል እዩ። እዚ ክልቲኦም ተመዓራያት (balances) ይቆጽር እዩ፡ መደበኛ ክሬዲት ከም 10 sats ከምኡውን ፕሮ (Pro) ክሬዲት ከም 100 ይቆጽር ስለዘሎ፡ ዝኾነ ዓይነት ተመዓራይ ዝጠቐመሉ እቲ ዝተሓሰበ ማለት እዩ። ሓደ ሕቶ (request) ቅድሚ ምኻዱ፡ ዝበለጸ ክኸፍሎ ዝኽእል ዋጋ (ናብ ምሉእ ክሬዲት ተኣቢዩ) ምስቲ ዝተረፈ ናይቲ ገደብ ይነጻጸር። እንተተኣሳሰቦ ድማ፡ እቲ ሕቶ ብእዚ ክቐረብ ኣይክእልን እዩ፦ 403 key_limit_reached፣ መልሲኡ ኣብ ትሕቲ ናይ ውሱንታ መጠን እንተመጺኡ እኳ፤ እቲ ጌጋ ክሳብ ክንደይ ከምዘተረፈን እቲ ውሱንታ መዓስ ከም ዝቐይርን ይገልጽ ኣሎ። ምባል max_tokens እቲ ዝተሓባበ ኪሳራ ንቕድሚት ዝመጽእ ዓቐን ዝቕንስ እዩ። ዝተሓተተ ሕቶ እቲ ብሓቂ ዘወድዶ ዋጋ ጥራይ እዩ ዝኸፈልኩት፡ እዚ ድማ ምስቲ ናይ ኣቐላይ ዓቐን ይቃረብ እዩ፡ ስለዚ እቲ መቕረብቲ ካብቲ ዝተመደበሉ ክልተ ዝበለጸ ቁጽጽር መተእታውያን (tokens) እንተReport ኢሉ፡ እቲ ዝሓደሰ ዝተሰሪቡ ሕቶ እቲ ኣቐላይ ዓቐን ን slightly ንቕድሚት ክሓልፎ ክኽእል እዩ፤ እቲ ቀጻሊ ድማ ክቐረብ ኣይኽእልን እዩ።
• ዝተባዕተየ ባዶ ኮፍያ (cap) ዘይሕብዝ ምልዓትን ዘይሕብዝትን ጥራይ እዩ። ብካፒትሉ ዘሎ ቁልፊ፡ ገና ክከታተል ይኽእል እዩ ሚዛኑ፣ ታሪኽኡ ክርድእ፣ ሞዴላት ክዘርዝር፣ ቶክን ክቆጥር፣ ክመርሕን ድSuper ድሮ ዝጅምሮ ቪድዮ ክምርምርን።
• መወዳእ ምርጫ እዩ። እቲ ዝወሰንካዮ ዕለት ምስ ወዳአ, መገዲ እታ ቁልፊ ክሰርሕ ኣይብድልን እዩ።
• ምኽባር ብቕጽበትን ናይ መወዳእታን እዩ። ዝተሰረዘ መkey ኣብ ቀጻሊ ሕቶ ይኸፍል። ኣብቲ ዝርዝር ተሓዲሱ፣ ከም ዝተሰረዘ ተቐሚሙ ይቕጽል፣ ስለEt ድማ ታሪኽ ምፍቃድ (spending history) ኣኳንን ይኸውን።
• እseneት 25 ንጥፈት ዘለዎም ቁልፍታት፣ እቶም እያ chacun ናብራቶም ዝበሃሉ ስም ክህልዎም ትኽእል ኢኻ። ናይ ሓደ ቁልፍ ናይ ምሶነት ግዜ (reset period) ምቕያር፣ ሓደ ሓድሽ ግዜ ካብ ዜሮ ክጅምር እዩ።

እቲ ተመሳሳሊ ቅጥዒ፡ ነፍሲ ወከፍ መፍጫ (key) ኣብዚ ሕ্তመ ግዜን ብጠቕላላን ዘፍጽሞ ዓቐን፣​ መወዳእታ መዓልቲ ዝተጠቐምካሉ፣​ ክልቲኦም ዓቐንታትኩም (balances)፣​ ከምኡ እውን ናይ መወዳእታ API ሕቶታትኩም የርእየካ። እቲ ኣብኡ ዘሎ መወዳእታታት (endpoints) ኣብዚ ተዳልየ ኣለዉ፦ ቁልፋት ምሕደራ.

መጠይቕ ምልዓከል (Authenticating)

እቲ ቁልፊ ኣብ ዝኾነ ካብዚኦም እዚኣቶምgetHeaderታት ስደደሉ። እዞም እዚኣቶም ተመሳሳሊ ስለ ዝኾኑ፣ ክሊየንትካ ብመኖርቲ ዝሰድዶ ዝኾነ ተጠቐመሉ፦

ዝጉዩ፣ ዘይተፈልጠ፣ ዝተሰረዘ ወይ ዝጸDEST ከይ (key) ይመልስ 401፣ ምስ ኮድ missing_api_key, invalid_api_key, revoked_api_key ወይ expired_api_keyሞዴልታት፣ ሞዴል ኦድዮታትን ድምጽታትን፣ ከመይነት ክፍሊትን ምዝገባ ኣይድልዮን እዩ።

ፎቶታት፣ ቪድዮ፣ ንግግር፣ ትራንስክሪፕሽንን ኤምቤዲንግሰን እውን ብዘይ ምስ клю (key) ብሓደ ግዜ ብLightning ክኽፈሉ ይኽእሉ እዮም፡ እቲ ሕቶ ብዘይ клю ስደዱ ከምኡ እውን እቲ ኢንቮይስ ብ... ክኽፈሉ ይኽእሉ እዮም፦ 402 መልሲ። ርኣይ። ብዘይ መፍቶሒ ብመሰረት ምጥቓዕማ ክፍሊት ምኽላሕ.

መምረhi ምሕደራ፣ መጠቃለሊ ሒሳብን ከባህላዊ መተเติม (automatic top-ups) ንሳቶም፡ ንትኽክለኛ ምትክ ከረዲ (key) ንምዃን ካብ @nym ፊርማ ይወስዱ፡ ስለዚ ዝተሰረቀ ከረዲ ካልእ ከረዲ ክፈጥር ኣይክእልን እዩ። ርአ መጠይቕታት ኣካውንት ምፍራምን ምትታይን.

ቀዳማይ ሕ 要求ኻ

እቲ መደብ (key) ኣብ ኣካባቢያዊ ተለዋዋጭ (environment variable) ኣቐምጦ፣ ድሕሪኡ ድማ ንሞዴል ሓደ ነገር ሕተቶ። ኣብዚ ኣብዞም ገጾታት ዘሎ ኣብነትታታት ካብኡ ይጽበዮ። 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 ናትኮት መገዲ (routing) እያ። ኣብኡ ክሳብ ከምዚ ዝኣመሰሉ ናይ ካታሎግ ሞዴል መታወቂያ (id) ኣቐምጡ፣ ከም፡ anthropic/claude-sonnet-5፣ ካብቲ Pro balance ንታክመሉ ሞዴል እቲያውን ንጥቀመሉ። ሞዴላት ምዝገባ ኩሉ መታወቂያታት ይህብ።

ሓደ ሕቶ ክንደይ ይመግቦ?

እቲ API ልክ ከምቲ ኣፕሊኬሽን ዝገብሮ ዓይነት እዩ ክፍሊት ዝሕሰብ።

• ከመይ ኣbaliknya? nymbot/auto ከፍሊሉ መደበኛ ሚዛን (10 sats ክሬዲት)። ኩሉ ካልእ ናይ ቻት ሞዴል ዘፍስሶ እዩ ፕሮ ሚዛን (100 ሳትስ ን ሓደ ክሬዲት)። እቲ መደበኛ ምስሊ ዝፈጥርን መደበኛ ድምጺ ዝፈጥርን መደበኛ ክሬዲት ይውስዱ እዮም፤ ኩሎም ካልኦት generator ግን Pro ይውስዱ እዮም። Embeddings መደበኛ ክሬዲት ይውስዱ እዮም። Transcription መደበኛ ሚዛን ክትሸፍኖ ክትክእል ከላ መደበኛ ክሬዲት ይውስድ፣ እንተዘይኮ ግን Pro ክሬዲት ይውስድ። ናይ ሞዴልታት ዝርዝር ነቲ መእተዊ ዝውስድ ሚዛን ይገልጽ እዩ።
• ኸመይ ብዙሕ? ሓደ ናይ ቻት ሕቶ ብእቲ ሞዴል ብሓቂ ብደ קራእዎትን ብደ ከተወ **tokens** እዩ ብዝተመደበሉ፣ ብዝተገብረ ናይቲ ኣቕራቢ ዝተሓለወ መደብ ዋጋ። እቲ ዋጋ 5% ክፍሊት ተደሚሩ፣ ድሕሪኡ ብ1.5 ተባሂሉ ተባዛጊሩ፣ ስለዚ ካብቲ ናይቲ ኣቕራቢ ዝተሓለወ ዋጋ 1.575 እተባዛጊሩ ትኽፈል ኢኻ። ብቐጥታ ዘሎ ዋጋ ቢትኮይን (Bitcoin) ተመሪሱ ናብ **sats** ተቀይሩ፡ ብათ ግና ብኣሽቱ ኣካል ክሬዲት ይኸፈል እዩ። ፕሮፌሽናል ምስሊ፣ ቪድዮን ንግግሪን ብሓደ ምፍላቕ፣ ብሰከንድ ወይ ብሓደ ፊደል ይዋጋ ን፣ ትራንስክሪፕሽን ድማ ብሰከንድ ድምጺ ይዋጋ፣ ብዘለዎ ተመሳሳሊ ክፍሊትን ትርፍን። መደበኛ ምስሊ 5 መደበኛ ክሬዲት ኮይኑ፣ መደበኛ ድምጺ ድማ 3 ኮይኑ ይወሰን።
• ኣຕ່Minima። ዝግበር ዝርዝር ሕቶ ኩሉ ቢያንስ 0.05 ክሬዲት ይውስድ፦ ኣብቲ መደበኛ ሚዛን ግማሽ ሳት፣ ኣብ Pro ግን 5 ሳት። ስብርባሪ ክሬዲት ናብ ቕድመ ይተሓላለፉ እዮም፣ መዓበዊ ናብ ላዕሊ ኣይትሓሓሓኡን።
• ሕጽብ፣ ድሕቀ thereafter። ሓደ ሕቶ ቅድሚ ምሩጫኡ፣ ብመሰረት ዝሰደደሉን ዝጽሓፍቲ ኣገዳሲቶም ቶከንታትን መሰረት ተገይሩ፡ ዝረኽብቲ ዓቐን ዝተሓዘ ካብ ባላንስካ ክኸውን ይኽእል እዩ። ካብ መደበኛ ASCII ንላዕሊ ዘሎ ጽሑፍ ብከመይነት UTF-8 ባይትታት ይዕረብ፣ ከምኡ እውን ASCII ኣሃዛትን ምልክታትን ነፍሲ ወከፍቶም ከም ሓደ ቶከን ይቆጸሩ፣ ስለዚ ኣብ ዝኾነ ጽሕፈት ዘሎ ጽሑፍ፣ ኮድ ከምኡ እውን ኣሃዛት ብምሉእ ይሓዙ። እቲ ዝተሓዘ ክሬዲት ብመልክዕ ምሉእ ክሬዲት እዩ፣ ቢያንስ ድማ ሓደ ክኸውን ኣለዎ፣ ስለዚ ዝኾነ ሕቶ ንምጅማር ኣብ መደበኛ ባላንስ ቢያንስ 10 sats ወይ ኣብ Pro 100 sats ክኸውን ኣለዎ። ዝኽኸል እዩ ናይቲ ናይ Actual ወጻኢ ጥራይ እዩ፤ እቲ ዝተረፈ ግን ምስ ተወድአ ይትፈታተ altogether። ሓደ দীርታ ሕቶ ንኽርክብ ዝጸንሐሉ ምሉእ ግዜ እቲ ዝተሓዘ ክሬዲት ይሓዝ፤ እቲ ዝተሓዘ ክሬዲት ብዘይኣካል ዘይቅረብ ክኸውን እንተኾይኑ፡ ስትሪም ብ... ይቁርጽ። 402 insufficient_balance ሕደጋ ስሕተት፣ ዝተፈጠረ ድማ ተደሞገ። ናይ ሓቂ ወጻኢ ካብቲ ክኽፈል ዝኽእል ቀሪብ ገንዘብ (balance) ዝበለጸ እንተኾይኑ፣ ምሉእ ቀሪብ ገንዘብ ይኣፍስ፣ ተ剩下的 ድማ ዕዳ ይኸውን (owed_sats ኣብቲ nymbot መደብ፣ ከዝቅታ ዝርጋታ (negative balance) ምስ ዝተኣሳሰር)። ዝኸውን ሓደ ነገር መበለ ክኸውን እንተኾይኑ፡ እቲ ዝኸውን ሓደ ነገር ካብቲ ናይቲ መበለ ዝርዝር ዝመጽኡ ቀዳማይ ክሬዲትታት ቅድሚ ኩሉ ይኽፈል። ክኽፈል ክኸውን ክሳብ እታ ሰዓት፡ ኣብቲ መበለ ዘሎ ዝኾነ ነገር ክኸውን ኣይኽእልን እዩ፦ ብ API፣ ኣብቲ ኣፕ ዝመጽኡ መልሲታት፣ ዝተላእከ ዝተላእከ ገንዘብ ወይ ስጦታ ኣይከውንን እዩ።
• ኣ sufficiently ክሬዲት የብልኩ። ሰንደት (balance) ነክቲኡ ዕዴ ተኣዲዩ (hold) ክcovering ክክእል እንተዘይተኻ፣ እቲ ሕቶ ብ... ይዎንቱ። 402 ዝያተ መደራዊ ነገር ቅድሚ ምውሳዱ። እቲ ጌጋ ከመይ ጌሩ እቲ ዝጎደለ ሚዛን፣ እቲ ሕቶ ክሳብ ክንደይ sats ከም ዘድልዮን ክሳብ ክንደይ ከም ዘሎ Free ከም ዘሎ ከም ዝገልጽ ይብል፧ ንላዕሊ ዝበለ max_tokens ናይ ሓንቲ ንእሽቶ Hold ትብই።
• ውድቀታት። ዝfail ዝገብረ ሕቶ ምንም ዋጋ ኣይኽፍልን እዩ፣ እቲ ዝገብሮ ዓቕሚ ቅድሚ ምውዳኡ ብዝተሓሰበ ወይ ድማ ናይ ኢንተርነት መርመር ወይ እቲ... nymbot/auto መደብ ተፈፃሚ ድጋሚ ተገይሩ እዩ፤ ከETET እብዮ ከቶ 0.05 ክሬዲት እታክብ። ዝቖረፅካዮ ስትሪም (stream) እቲ ፕሮቫይደር ዘፍለጦ ንቶከንስ (tokens) ይኸፈልካ እዩ፦ Nymbot እቲ ቁጽሪ ንምፍላጥ፡ ንስኻ ምስ ተለይካ ክሳብ 25 ሰከንድ እቲ ናይ ፕሮቫይደር ስትሪም ክቕጽል ይቕጽል እዩ። እብ እንተዘይመጸ፡ እቲ ክፍሊት ካብቲ ዝሰደደትን ካብቲ ተጻሕፈትን ተቐዲሙ ይቕረብ፣ ንሞዴል ዝሓሳብ ዝኾነ ድማ እቲ ምሉእ ናይ ኣውጣኢ ዕድል እግዚኣ ሓቲፉ ይሓዝ። እቲ ዝተቖረጸ ራውት (connection) ዝነበራ ጥያቄ፡ ምብጻሕ ይቕጽል እዩ፣ ይኽፈል ድማ።
• ኣብ ኢንተርኔት ምድላይ ነፍሲ ወከፍ ምርመራ $0.008 ይኸው፣ ናብ sats ተቀይሪ፣ ምስ ምርመራ ዝተገብረ*:* እቲ ሞዴል መልሲ እንተሃብአ ወይ እንተተሳቐ፣ ኩሉ ይሻምል። ዝቆብጦም ገጾ እውን ከም መግ输入的 ናብቲ ሞዴል ይላኽኩም፣ ስለዚ ድማቶቶማ ይውስኽ።

ኩሉ መልሲ ዋጋኡዶ ንዛረብ ኣሎ። JSON መልሲታት ዘለዎም... nymbot ብዝተከፈተሉ ባላንስ፣ ብክሬዲት ኮድታትን ሳትሰታትን ዝተከፈለት ክፍሊ፣ ከኡሞ ተረፈ ዝተባለ ነገር ዘለዎ ኦብጀክት (object)፦

እቲ ናይ ወጻኢ መደብ ተቋሚ ዕዮ (The cost object)

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

ብገንዘብ ዝፍጸሙ ምላሳት እዚኦም ርእሰ-መደብታት (headers) እውን የጠቓልሉ፣ እዚኣ ድማ JSON ዘይኮነ ምላስ (ከምቲ ድምጺኣዊ) ውድነት ክትርከብሉ ዘለዋ ቦታ እያ፦

ነቲ ክፍሊታን ትርፍን ዘጠቓለለ፣ ንኣከለተታትን ሚልዮን ቶከን ዝኸውን ዋጋ ኣብ እዚ ኣሎ። ዝርዝር ሞዴላት ብዶላራት ከሳትሰታት፣ ከ...ን ናይ ዋጋ ዝርዝር መግለጺ. ዋጋ ቢትኮይን ክቕራእ እንተዘይከበለ፣ ዝኽርየት ሕቶታት ይመልሱ 503 price_unavailable ብ bersama with Retry-After: 60 ኣብ ክንዲ ብምግማት።

ጌጋታት

ኩሉ ስሕታ ተመሳሳሊ ቅርጺ ኣለዎም፣ እቲ ተጠቃሚ OpenAI ድሮ ዝርድኦ። code ጽኑ ስም ኮይኑ ክትመሰጋገሉ ትኽእል እዩ፤ message ንሰባት እዩ፣ ከኣ ክቕያ ል ይኽእል እዩ።

ናይ ስህተት ኣካል

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

ክልተ ኣንታኻት፦

• /api/v1/messages መልስታት ኣብቲ Anthropic ዝጥቀመሉ ናይ ስህተት ኣቀራርባ (error format) ክኾኑ፣ ምኽንያቱ እዚ Anthropic ዓማልቲ (clients) ዝፍርድዎ ስለ ዝኾነ፦ {"type": "error", "error": {"type": "authentication_error", "message": "…"}}ዓይነትኡ ንሁኔታኡ ይከተል፦ invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error ወይ overloaded_error (503).
• ንመጀመሪያ ባይት ቅድሚመጽኡ ዝቅጽል ስትሪሚንግ መደብ፣ ብታሕቲ ስታተስ ዘለዎ ተራ JSON ስህታይ እዩ ዝመጽእ፣ ከመ ኦቨንት ስትሪም ኣይኮነን። እቲ ስትሪም ምስ ተጀመረ ዝመጽእ ውድቅነት ግን፣ ብመልክዕ እቲ ጸንሓት (endpoint) ከምዚ ናይቲ ስትሪም መወዳእታ ኦቨንት ኮይኑ ይላኽእ።

መልእኽትታት ጌጋ ፈጺሞም ውሽጣዊ ዝርዝራታት ካልእ ኣገልግሎት ኣይጠቓልሉን። ናይ ኣቕራቢ ጌጋ ድማ ናብኩም ቅድሚ ምውጻኡ ቃላቱ ይቕየር።

ወሰንታት

ናይ ምስሊ መደlinking ናብ ዓወቲ መሳርሒ (public host) ክኸውን ኣለዎ፦ ኣብ ናይ ሓPrivate ወይ ናይ ሎካል network ዘሎ ኣድራሻ፣ ወይ ኣብ ናይ Nymbot ናትኡ ሳይትታት ዘሎ ኣድራሻ ይኣርፍድ። ኣብቲ ኣፕ (app) ዝተገብረ ናይ Provider pacing ኣብዚ እውን ተፈጻሚ ምዃኑ ስለዘለዎ፣ ናብ ሓደ Provider ዝቐርብ ብዙሕ ክሳብ መጠን ዝበርሁ ሕቶታት (requests) ብምቕናሽ እንተኾይኑ ክቕነስ ይኽእል እንጂ ክውድቕ ኣይኮነን።

እቲ API እንታይ ክርእዮ (ክህልዎ) ይኽእል?

እቲ API ከምቲ ኣፕሊኬሽናት ዘለዉ ኣገባብ ቕጽፊ ኣይኮነን፣ ከመይ ከም ዝኸውን ብዝተኸላኸለ ኣገባብ ምግላጽ ድማ ኣገዳሲ እዩ።

• ካብ መወዳእታ ናብ መወዳእታ ዝተሓለወ ምስጢራዊነት (end-to-end encryption) ኣይኮነን። ኣብቲ ኣፕሊኬሽንታትን፡ ሓበሬታ ኣብቲ ውልቃዊ መሳርሒኻ ተሓዊሱ፡ ብመ клюሰታት Nymbot ጥራይ ዝኽብብን ከምዚ ከም ዝኸውንን እዩ። መዓርዝታ (መዓርዝታ)አንድ ናይ API ሕቶ መደበኛ HTTPS እዩ፦ ናብ Nymbot ኣብ ዝከይድ እግረይ ዝተመስረተ (encrypted) እዩ፣ ሰርቨር Nymbot ድማ ንምhandle ምግባር ብንጹር ይቆርዖ።
• መሰረታዊ ሕቶታትን ከምላሾታትን ኣይሕዝወን እዩ። ናብ ሞዴል ይሓልፉ፣ መልሲ ድማ ተመላሲ ይኸውን። ዝቕጽል ዝ kept ዝገብረ ፋታ (bill) እዩ፦ ንነፍሲ ወከፍ ሕቶ እቲ ግዜ፣ ሞዴል፣ ዓይነት፣ ብዝሒ ቶከን፣ ወጻኢ፣ ቀሪት፣ ቁልፊን ከመይሲ ከም ዝተሳካን ን90 መዓልታት ዝቕጽል እዩ፣ እዚ ድማ እዩ ታሪኽ መርመራታት የተመሳሰለ ሕቶ (ግዜ፣ ዓይነት፣ ሞዴል፣ ብዝሒ ቶክን፣ ወጻኢ፣ ድሕረ-ቆይታ፣ ከመዶ ድሕረ-ምርመራ ኢንተርነት ተጠቒሙ ወይ ዘይተጠቒሙ፣ ወይ ድማ ተዓኪፉ) መዝገብ ምስቲ ናይቲ ኣፕሊኬሽን ክሳብ 90 መዓልታት ብሓባር ይሓዝ።
• ዝተረፈ ኩሉ ን anon ዝሓዝብ ንእታይ እዩ፣ ኣብዚ ድማ ተዘርዚሩ ኣሎ። API ቁልፊታት ከመደብ (hash) ተሓፊዞም እዮም ዝተሓዙ፣ እቲ መደብ ግን ኣይኮነን፤ ብተምቲ ስም፣ ሓጺር መመልከቶ፣ ናይ ወጻኢ ገደብ፣ ናይ ምእተላይ ግዜ፣ ናይ ምዕላእነት ግዜ፣ መዓልቲ ዝተሰርሑን ናይET ምቁራጽን ይሕዝ፤ 50 እቶም ኣነባብሩ ዝተሰረዙ መደብታት ጥራይ እዮም ዝሕዙ። An ኣውቶማቲክ ኣገማጽቲ ሒደት (automatic top-up) ምዝጋብ ultimately wallet እዚ ምስባብታኡ፣ ምስ ውፍሪኡ፣ መጠንኡ ከመሃን ናይ መወዳእታ መወከሲ ድርጊቱ ምስቲ ዝተገብረ መወከሲ ብምስጋብ (encrypted) ተሓዚቡ ይርከብ። ናይ ቪድዮ ስራሕታት ን24 ሰዓታት ይሕዙ። ብመሰረት ዝተገብረ ሕቶ ብዝተከፈሉ ሕቶታት ግን ን7 መዓልታት ናይ Lightning payment hash ጥራይ፣ ን30 መዓልታት ድማ ምስ ዝኾነ ስም ዘይተኣሳሰር (no nym) ዝተተሓሰረ ናይ refund token ጥራይ ይትክእሉ። ብመጠን ተወሳኺ ገንዘብ (balance) ክትከፍል ዘይክእል ክፍሊታት፣ መወከሲ (top-up) ክትከፍሎ ክትኽእል እያ ናይ ዕዳ ተባሂላ ትሕዝ።
• እቲ ኣፕሊኬሽን ምጽራሕ ከዲዱ ይቕጽሎ። A መሳርሒ ምጽራሕ ኩሉ መግለጺ ሕራይ (API key) ይሰረዞ እዩ፣ ከምኡ እውን ታሪኽ ሕቶታት፣ መዝገባት ኣጠቓቕማ፣ ምስ ዋሌት ዝተኣገናነ መግለጺን ናይ ቪድዮ ስራሕታትን የሕዝ። እቲ ተረፈ ገንዘብ ንኣብነት ዝኸፈሉ ክፍለታት ግን ኣብ nym ክሳብ እዋን ክቕጽሉ ይ bleiben።
• እቲ ሞዴል ዝሕግዝ ኩባንያ ናትናይቲ ሕቶኻ ኣብ ዓይኑ እዩ።ከመተግበሪኡ ከትውግ ዝተረኸ፣ ካታሎግ ሞዴላት ኣብ ሰራራቶም ይጥልፋት፤ ስታንዳርድ መንገዳትን ኤምቤዲንግታትን ኣብ Cloudflare ይጥልፋት።
• ዝተፈጠረ ሚዲያ ህዳራ እዩ። ከሊንክ ከትጥኣ ዝመጹ ምስሊታትን ቪድዮታትን ናብ ሕጋዊ Blossom ፋይል ሆስትታት ተኣጣቢኦም እዮም፡ እዛ ከኣ ሓደ ፋይል ኣድራሻኡ ሓሽ (hash) እዩ። ነቲ ሊንክ ዘለዎ ሰብ ሰብ ክኸፍቶ ይኽእል እዩ፡ ንምበር ምኽንያት Nymbot ዳግም ክሰርዞ ኣይኽእልን እዩ። ሕቶ ሓተት b64_json ከኡን ተተፍሪ ምስል ኣብ መልሲኡ ይቐርብ፣ እንተኾነ ግን ፈጺሙ ኣይትነስልን።
• እሞ እዞም ንትህቦም ምስሊታት ጀነሬተር ድዮምዶ? ኣብ ... ዝተሓጸረ ምስሊ ኣስተኻኽሊ፣ ወይ ድማ ከ... ይላኩ data: URL ኣብ ናይ መፍጠሪ image_url, መጀመሪያ ናብ ህዳራዊ Blossom host ይሽኮረከራል፡ እዚ ድማ እቲ ጀነሬተር ክረክቦ ንክእል እዩ፡ እዚ ድማ ንኡኡ እትፈላለ እዩ። ብዝተላከ ምስሊ https:// ሊንክ ከምቲ እተሓዘብ ከምቲ ሊንክ ይቕጽል እዩ። ኣብ ናይ ጭውውት ሕቶ ዘለዉ ምስሊታት ናብቲ ናይ ሞዴሉ ኣቕራቢ ይኸዱ፣ ናብ Blossom ኣይከዱን።
• ቁልፊ ምስ nymካ ተኣሲሩ ኣሎ። እቲ ቁልፊ ዝወጻ ኩሉ ነገር ካብ ባላንስ ንም (nym) ይቕነር፣ ስለEtም API ምጥቃም ኣይኮነን... ዘይተፈልየእቲ ኣገልግሎት API ካብ መዓልታዊ ኣድራሻኻ ክርሕክ እንተደሊኻ፣ ቁልፋት ካብ ዝተፈላለየ ኣድራሻ ምስኡ ድማ ናቱ ራእሳዊ ሚዛን ክህልዎ ገይርካ ፍጠር።

ምክልኻል ኣፕሊኬሽንታትን እንተ ሓሊፉካ፣ ኣፕሊኬሽንታትን ተጠቐም። እቲ API ድማ ሞዴልታትን ኣብ ናትካ መሳርሒታት ክትጥቀመሎም እንተ ደሊኻ እዩ።

ኩሉ ወሰን (endpoint)

“Nym” ማለት ብቤትኩም Nostr key ተፈራርሙሉ ዝቐረበ ሕቶ ማለት እዩ፣ ዝገልጽዎ እውን መጠይቕታት ኣካውንት ምፍራምን ምትታይንነዚኦምቲ ቅርጸ-ኣፃፃፍታትን ዝዛረቡሎም መሳርሒታት እንተሃቲኖም፡ እዚ ርአ መሳርሒታትን SDKታትን፣ ከClaude Code፣ Codex ከኣብላ Cline ዝበሉ ናይ ኮዲንግ ኤጀንትታት ንብዝብተ ክትመለከቱ፣ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መርበብ መር.