අන්තර්ගතය වෙත යන්න
Nymbot වෙත නැවත යන්න

දැනුම පදනම සංවර්ධකයින්

API සමාලෝචන

ඔබ ඔබේම කේතයෙන් යෙදුම තුළ භාවිතා කරන ආකෘති, Generators සහ Balance.The API speaks the OpenAI and Anthropic formats, so most tools and SDKs work by changing a base URL and a key.

මොකක්ද මේ API

HTTP API එක nymbot.ai OpenAI හෝ Anthropic පාරිභෝගිකයා විසින් දැනටමත් යැවූ එකම ඉල්ලීම් වලට පිළිතුරු දෙයි.

ගෙවන්නේ එකම දෙකෙන්. සංසන්දනය API හි නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ නොමිලේ ගෙවනු ලැබේ.

මෙම API ක්රියා නොකරන්නේ Nymbot හිම කිසිවක් එකතු කිරීමයි.ඔබේ පණිවිඩය ඔබ ඒවා යැවූ විට ආකෘතියට යන්නේය: Nymbot පද්ධති ප්රවේශයක් නොමැත, මතකය නොමැත, දිනය හෝ භාෂා ඉඟි නොමැත.

පදනම URL

භාවිතයපදනම URL
OpenAI SDK සහ OpenAI අනුකූල මෙවලම්https://nymbot.ai/api/v1
Anthropic SDK සහ ක්ලෝඩ් කේතයhttps://nymbot.ai/api (SDK අංකය /v1/messages තමන්ගෙ

සෑම අවසානයකටම ජීවත් වන්නේ /api/v1/නොදන්නා පාරක් ආපහු එනවා 404 වැරදි ක් රමයක් සහිතව හඳුනාගත් මාර්ගය ආපසු එයි 405දෙකම JSON වගේ.

මෙම API ඕනෑම වෙබ් අඩවියක සිට cross-origin ඉල්ලීම් වලට පිළිතුරු දෙයි, එබැවින් බ්රවුසරය පිටුව එය ඇමතුමක් කළ හැකිය.ඔබ බ්රවුසරයට යවන ඕනෑම දෙයක් එය විවෘත කරන ඕනෑම කෙනෙකු විසින් කියවිය හැක, එබැවින් කුඩා අංකයක් ඇති යතුරකින් පමණක් එය කරන්න කප්ඔබගේ නයිම් සමඟ අත්සන් කරන අවසාන ස්ථාන (කයිස්, ගිණුම් සමුදාය, NWC ස්වයංක්රීය තිරගත කිරීම් සහ ආපසු ගෙවීමක්) විශේෂයක් වේ: බ්රවුසරයකදී ඔවුන් Nymbot හිම වෙබ් අඩවි පමණක් පිළිතුරු දෙයි. ගිණුම් අත්සන් ඉල්ලීම.

සෑම JSON ශරීරයක්ම යවන්න Content-Type: application/jsonවෙනත් ඕනෑම ආකාරයක ප් රතික්ෂේප කිරීම 415, එබැවින් සරල HTML ආකෘතිය හෝ A text/plain වෙනත් වෙබ් අඩවියෙන් ලැබෙන ඉල්ලීම API වෙත ළඟා විය නොහැක. -H "Content-Type: application/json" සමගින් -d.

ගිනි යතුරු

ක්ලික් කරන්නෙ app එකේ. open ගිනි වෙබ් යෙදුම පිටුපසින්, හෝ Android සහ iOS හි මඳබව තුළ, හා යතුර හදන්නඔබට අවශ් ය නම්, එය නම සහ, ඔබ කැමති නම්, කැප් සහ අවසන් දිනය ලබා දෙන්න.

මුරපදය එක් වරක් පෙන්වනු ලැබේ. මුරපදය වසා දැමීමට පෙර එය ආරක්ෂිත තැනකට පිටපත් කරන්න: Nymbot එය නැවත ඔබට පෙන්විය නොහැක. අහිමි මුරපදය ආපසු ලබා ගත නොහැක; එය අවලංගු කර තවත් එකක් නිර්මාණය කරන්න.

යතුර පේනවා වගේ sk-nymbot- ඊළඟට ලියුම් 43ක්, අංක 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 43ක්, අකුරු 4ක්, අකුරු 4ක්, අකුරු 4ක්, අකුරු 4ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු 3ක්, අකුරු sk-nymbot-Qm7x…c2Lw.

  • යතුර අයිති ඔබේ නයිම් එකට. එය ඔබගේ ඉසව්ව වියදම් කරයි, ඔබේ නයිම් පමණක් එය නිර්මාණය කළ හැකි, වෙනස් කළ හැකි හෝ අවලංගු කළ හැකිය.
  • කට්ටිය ඔට්ටු දානවා. ප්රධාන වියදම් ප්රමාණය ඇති විය හැකි අතර, ප්රමාණය සෑම දිනකම, සෑම සතියකම (පරිදා) හෝ සෑම මාසයකම (පරිදා) 00:00 UTC දී සකස් කළ හැක. එය සම්මත ක්රෙඩිට් ලෙස 10 sats සහ ප්රවර්ධන ක්රෙඩිට් ලෙස 100 ලෙස ගණනය කරයි, එබැවින් එය ඉල්ලීම වියදම් කරන ස්ථාවරයට අනුව එකම අදහස් කරයි. 403 key_limit_reached, උත්තරය කොප්පුව යටතේ පැමිණ තිබුණා නම් පවා; වැරැද්ද කොපමණ ඉතිරි වන අතර කොප්පුව ආපසු සකස් කරන විට පවසයි. max_tokens එය සැබවින්ම වියදම් කරන දේ සඳහා ඉල්ලුමක් ගෙවනු ලැබේ, එබැවින් සැපයුම්කරු පිටතට තබා ඇති බව වඩා වැඩි ටොක්න් වාර්තා කළහොත්, ගැලපෙන අවසාන ඉල්ලුම යතුර ටිකක් එහි තොප්පරයට පෙර ගත හැකිය; ඊළඟ ඉල්ලුම ප් රතික්ෂේප කරනු ලැබේ.
  • වියදම් කිරීම පමණක් වියදම් කිරීම නතර කරයි. එහි මට්ටමේ යතුර තවමත් ධාරාව පරීක්ෂා කළ හැකිය, එහි ඉතිහාසය කියවන්න, ආකෘති ලැයිස්තුගත කළ හැකිය, ටෝකන් ගණනය කළ හැකිය, ඉහළ නැංවීම සහ එය දැනටමත් ආරම්භ කර ඇති වීඩියෝව පරීක්ෂා කළ හැකිය.
  • Expiry එක විකල්පයක්. ඔබ සකස් කරන දිනයෙන් පසු, යතුර වැඩ කිරීමට නතර වේ.
  • අවලංගු කිරීම වහාම සහ අවසාන වේ. ප් රතික්ෂේප කරන ලද යතුර ඊළඟ ඉල්ලීම අසාර්ථක වේ.එය ලැයිස්තුවේ තබා ඇත, ප් රතික්ෂේප කරන ලදී, එබැවින් එහි වියදම් ඉතිහාසය තවමත් තේරුමක් ඇත.
  • ඔබ සෑම ක්රියාකාරී යතුරු 25 ක් දක්වා තිබිය හැක, සෑම ක්රියාකාරී යතුරු නාමය සමග.

එකම තැපැල් දර්ශනය සෑම යතුරෙකුම මෙම කාල සීමාව සඳහා වියදම් සහ මුළු, එය අන්තිමට භාවිතා කරන විට, ඔබගේ ඉනිම සහ ඔබගේ පසුගිය API ඉල්ලීම් දෙකම. යතුරු කළමනාකරණය.

ඉල්ලීමක් authenticate කරන්න

මෙම මාතෘකාවෙහි ඕනෑම මාතෘකාවක යතුරු පණිවුඩය යවන්න. ඔවුන් සමාන වේ, එබැවින් ඔබගේ පාරිභෝගිකයා තැපැල් කරන ඕනෑම දෙයක් භාවිතා කරන්න:

හයිඩර්තැපැල්
Authorization: Bearer sk-nymbot-…OpenAI SDKs, බොහෝ මෙවලම්, Claude Code සමග ANTHROPIC_AUTH_TOKEN
x-api-key: sk-nymbot-…Anthropic SDK
api-key: sk-nymbot-…Azure Style සේවාදායකයින්

අතුරුදන් වූ, නොදන්නා, අවලංගු වූ හෝ අතුරුදන් වූ Key Returns 401කේතය සමග missing_api_key, invalid_api_key, revoked_api_key හෝ expired_api_keyලියාපදිංචි ආකෘති, ශබ්ද ආකෘති සහ හඬ සහ ගෙවීම් ක්රම කිසිදු යතුරු අවශ්ය නොවේ.

ඡායාරූප, වීඩියෝ, කටයුතුවල, පරිවර්තනය සහ ඇතුළත් කිරීම් එක් වරක් Lightning හරහා කිසිදු යතුරකින් තොරව ගෙවිය හැක: කිසිදු ඉල්ලීමක් නොමැතිව ඉල්ලුම යැවීමට සහ ගිණුම ගෙවීමට 402 පිළිතුර - දකින්න යතුරකින් තොරව ඉල්ලුමකට ගෙවීම.

ප්රධාන කළමනාකරණය, ගිණුම් සම්ප්රේෂණය සහ ස්වයංක්රීය Top-ups විශේෂයක් වේ: ඔවුන් කුසලතා වෙනුවට ඔබේ NIM හි අත්සන් ගනී, එබැවින් පැතිරෙන කුසලතාවය තවත් කුසලතා නිර්මාණය කළ නොහැක. ගිණුම් අත්සන් ඉල්ලීම.

ඔබේ පළමු ඉල්ලීම

පරිසර ප්රමාණයට යතුරු පැකේජය තබන්න, පසුව මොනවහරි මොනවහරි model එකක් ඉල්ලන්න.The examples throughout these pages read it from 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 හි ස්වයංක්රීය මාර්ගෝපදේශය වන අතර එය සම්මත සම්මතයෙන් ගෙවනු ලැබේ. anthropic/claude-sonnet-5Pro Balance එකෙන් පාවිච්චි කරන්න. ලැයිස්තුව ආකෘති හැම ID එකකටම

ඉල්ලීම කොපමණ වියදම්

මෙම API ක්රියා කරන්නේ හරියටම App වැනි ආකාරයෙන්.

  • මොන සාධකද nymbot/auto වියදම් කරන්න සම්මත සංසන්දනය (10 sats a credit). සෑම අනෙකුත් චැට් ආකෘතිය ප් ර ස්ථාවර ඡායාරූප ජෙනරාටර් සහ ස්ථාවර කටයුතුවල ස්ථාවර ක්රෙඩිට් වියදම් කරයි; අනෙක් සියලුම ජෙනරාටර් Pro වියදම් කරයි. Embeddings ස්ථාවර ක්රෙඩිට් වියදම් කරයි. Transcription ස්ථාවර ක්රෙඩිට් වියදම් කරයි.
  • කොච්චර චැට් ඉල්ලුම සැබවින්ම කියවනු ලැබූ සහ ලියූ ආකෘතිය විසින් කියවනු ලැබූ ටොක්න් මත ගණනය කරනු ලැබේ, සැපයුම්කරුගේ ප්රකාශයට පත් කරන ගාස්තු මත. එම මිල 5% ගාස්තු එකතු කර ඇත, පසුව 1.5, එබැවින් ඔබ සැපයුම්කරුගේ ලැයිස්තුව මිල 1575 වතාවක් ගෙවනු ලැබේ. එය සජීවී Bitcoin මිල මත ගාස්තු බවට පරිවර්තනය කරනු ලැබේ සහ ක්රෙඩිට් දහස් ගණනකින් ගෙවනු ලැබේ. වෘත්තීය ඡායාරූප, වීඩියෝ සහ කටහඬ තත්පරයට, තත්පරයට හෝ සංකේතයට, සහ ස්වයංක්රීය ගාස්තු සහ ප්රමාණය සමඟ ඇඩ්රොයිප්රෙප්රෙප්රෙප්රෙප්රෙප්
  • අවම වශයෙන් අඩුම වශයෙන් 0.05 ක්රෙඩිට් වියදම් කරන සෑම ගණිත ඉල්ලීමකටම: සම්මත සම්මතයට බාගයක්, Pro හි 5 ක්රෙඩිට් වේ.
  • හදා ගන්න, ඊට පස්සෙ සකස් කරන්න. ඉල්ලීම ක්රියාත්මක කිරීමට පෙර, එය වියදම් කළ හැකි උපරිම වියදම ඔබ යැවූ දේ හා එය ලිවීමට හැකි උපරිම තැපැල් මත පදනම්ව ඔබගේ තැපැල් සිට තබා ඇත. සරල ASCII පිටත පණිවුඩය UTF-8 බයිට් වලින් ප්රමාණවත් වන අතර, ASCII අංක සහ තැපැල් සෑම තැපැල් ලෙස ගණනය වන අතර, එබැවින් ඕනෑම ස්ක්රිප්ටරය, කේතය සහ අංකයේ පණිවුඩය සම්පූර්ණයෙන්ම තබා ඇත. තැපැල් සම්පූර්ණ ක්රෙඩිට්, අවම වශයෙන් එක්, එබැවින් ඕනෑම ඉල්ලීම ආරම්භ කිරීමට සම්මත තැපැල් මත නොමිලේ 10 තැපැල් හෝ Pro මත 100 තැපැල් අවශ්ය වේ. 402 insufficient_balance ප් රචණ්ඩත්වය සිදුවේ, නමුත් අපි පාපයට එරෙහිව ශුද්ධ විනිශ්චය සහ අපි පුද්ගලිකව අකමැති අයට එරෙහිව ශුද්ධ විනිශ්චය සහ අපි පුද්ගලිකව අකමැති අයට එරෙහි වන පුරපැම අතර වෙනස අප හඳුනාගත යුතුය, එය උඩඟුකමේ අනිවාර්ය ප් රතිපලයයි (owed_sats ඒ අතරේ nymbot ප්රශ්නය, සහ අහිතකර අමුද්රව්ය). ණය කළ යුතු දේ මුලින්ම එම අමුද්රව්යයට ළඟා වන ඊළඟ ක්රෙඩිට් වලින් ගෙවනු ලැබේ. එය ගෙවනු ලැබෙන තෙක්, එම අමුද්රව්ය මත කිසිවක් වියදම් කළ නොහැක: API විසින් නොවේ, යෙදුම තුළ ප්රතිචාර, මාරු හෝ තෑග්ග.
  • ණය ප් රමාණවත් නැත. ප් රතිපත්තිය පවත්වා ගැනීමට නොහැකි නම්, ඉල්ලීම ප් රතික්ෂේප කරනු ලැබේ. 402 කිසිවක් ක්රියාත්මක කිරීමට පෙර. වැරැද්ද පවසයි, කොපමණ වටිනාකමක් කෙටි වේ, ඉල්ලීම සඳහා අවශ්ය sats කීයක් සහ කොපමණ නිදහස් වේ. max_tokens ඒ කියන්නේ පුංචි ගමනක්.
  • අසාර්ථක අසාර්ථක ඉල්ලීම කිසිවක් වියදම් නොකළහොත්, සැපයුම්කරු විසින් අසාර්ථක වීමට පෙර සිදු කරන ලද වැඩ සඳහා, හෝ අන්තර්ජාලය සෙවීමක් හෝ nymbot/auto මෙහෙයුම් පරීක්ෂණය දැනටමත් ක් රියාත්මක විය; එවිට ඔබ ගෙවන දේ, අවම වශයෙන් 0.05 ක්රෙඩිට්. ඔබ කපා දැමූ ක්රෙඩිට්, සැපයුම්කරු වාර්තා කරන ටෝකන් සඳහා ගාස්තු ගෙවනු ලැබේ: Nymbot ඔබ එම ගණනය ලබා ගැනීමට ඔබ පිටතට ගිය පසු 25 තත්පර දක්වා සැපයුම්කරුගේ ක්රෙඩිට් කියවනවා.
  • WEB සොයන්න $0.008 ගනුදෙනු, sats බවට පරිවර්තනය, ගනුදෙනු ක්රියා කරන විට, ආකෘතිය පසුව පිළිතුරු හෝ අසාර්ථක වේ.

සෑම ප් රතිචාරයක්ම වියදම් කරන්නේ කොපමණ වියදම්ද කියා JSON ප් රතිචාරය nymbot එය ගෙවනු ලැබූ සීමාව, ක්රෙඩිට් සහ sats හි ගාස්තු සහ ඉතිරි වූ දේ සමඟ ප්රශ්නය:

වියදම් ඉලක්කය

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

ගෙවුණු ප්රතිචාර ද මෙම මාතෘකාව ඇති අතර, JSON නොවන ප්රතිචාරයේ වියදම සඳහා සොයන්න:

හයිඩර්තේරුම
X-Nymbot-Cost-Satsමේ ඉල්ලීම කොපමණ වියදම්, sats.
X-Nymbot-Balance-Satsඑය ගෙවනු ලැබූ වැටුප මත ඉතිරිව ඇත්තේ කුමක්ද, sats.
X-Request-Idසෑම ප්රතිචාරයකම ඉල්ලීම සඳහා ID. ඔබ සහාය අමතන්නේ නම් එය ප්රකාශ කරන්න.

ඩොලර් මිලියන ගණනක ගාස්තු, දැනටමත් ගාස්තු සහ ප්රමාණය ඇතුළත් වේ. Model ලැයිස්තුව ඩොලර් සහ ආදායම්, සහ මිල ලැයිස්තුවBitcoin මිල කියවිය නොහැකි නම්, ගෙවන ඉල්ලීම් ආපසු 503 price_unavailable සමග 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
  }
}
තත්වයකවදා
400 invalid_request_errorJSON වලංගු නොවන ශරීරය (invalid_json) අවශ් ය ක්ෂේත් රයක් අතුරුදහන් වේ (missing_required_parameter), අගය වැරදියි, හෝ ඉල්ලීම මොනවාහරි ආකෘතිය හෝ අංගයේ මෙවලම් වැනි සිදු නොකරන දෙයක් සඳහා ඉල්ලා ඇත. nymbot/auto (unsupported_tool). param නාම යෝජනා (අදාල ලින්ක් ද සහිතව) upstream_rejected සැපයුම්කරු ඉල්ලීම ප් රතික්ෂේප කලේය.
401 authentication_errorයතුර අතුරුදන් වී, නොදන්නා, අවලංගු වී හෝ අතුරුදන් වී හෝ අත්සන් කළ ඉල්ලුම අසාර්ථක වී හෝ නැවත භාවිතා වී ඇත.
402 insufficient_quotaඉල්ලුම සපුරාලිය නොහැක.Code insufficient_balanceසමග balance, required_sats සහ balance_sats.
403 permission_errorප්රශ්නය යතුරු පද්ධතියට ගැලපෙන්නේ නැත (key_limit_reachedසමග limit_sats, used_sats සහ reset_at), හෝ ගිණුම සේවාව භාවිතා නොකළ හැකි (account_denied).
404 not_found_errorනොපෙනෙන මාර්ගය (unknown_endpoint(අවශ් ය නොවනුයේ නැත)model_not_found) හෝ නොදන්නා යතුර, ගිණුම හෝ වීඩියෝ.
405මෙම ක් රමවේදයේ ක් රමවේදයක් නොමැත (method_not_allowed) The Allow Header ලැයිස්තුව භාවිතා කරන ක්රම.
413ශරීරය හෝ ගොනුව විශාල වේ (payload_too_large, file_too_large(විශේෂය දිගුකාලීන වීඩියෝ එකක්)audio_too_long) මේ සීමාව.
415 invalid_request_errorශරීරය එවන්නේ නැත application/json (ඇත්තටම අන්තිම කොටස් වලදී, multipart/form-data): unsupported_media_type.
422වචනය හා භාෂාව එකිනෙකාට එකිනෙකාට නොපෙනෙන වචනය (voice_language_mismatch, unsupported_language).
429 rate_limit_errorමෙම කේතය මත ප්රමාණවත් ඉල්ලීම්, මෙම ලිපිනයෙන්, හෝ තහවුරු කිරීමට නොහැකි ප්රවේශයන් සමඟ (rate_limit_exceeded(එහෙත් අඩුම ගාස්තුවක් හෝ අඩු ගාස්තුවක්)upstream_rate_limited) තත්පර කිහිපය තුළ බලා සිටින්න Retry-After.
500 api_errorNymbot මත යමක් වැරදියි (internal_error).
502 api_errorප් රතිචාරයක් ලැබුණේ නැහැ (upstream_error(විශේෂයෙන් ම ප් රචණ්ඩත්වයක් නොලැබුණි)invoice_unavailable).
503 api_errorපරිශීලකයාට ප්රමාණවත් (upstream_overloaded, Bitcoin මිල කියවිය නොහැක (price_unavailable) හෝ සේවා කොටසක් පහත (service_unavailable, media_hosting_unavailable). Retry-After කවදා ආයෙම උත්සාහ කරන්නද කියන එකත් දන්නවා.

exceptions දෙකක් :

  • /api/v1/messages Anthropic හි වැරදි ආකෘතිය තුළ ප්රතිචාර ඇත, එබැවින් Anthropic සේවාදායකයන් විසින් පරීක්ෂා කරන පරිදි: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}තත්වය අනුගමනය කරන ආකාරය: The type follows the 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).
  • පළමු බයිට් වලට පෙර අසාර්ථක වූ ස්ට්රොයිම් ඉල්ලීම, එවැනි තත්වයක් ඇති සාමාන් ය JSON වැරැද්දක් ලැබෙන අතර, සිදුවීම් ප් රවාහයක් නොව, ප් රවාහය ආරම්භ වූ පසු අසාර්ථකතාවය, එම අවසාන අංගයේ ස්වයංක්රීය ආකෘතිය තුළ ප් රවාහයේ අවසාන සිදුවීම ලෙස යැවෙනවා.

වැරදි පණිවුඩ කිසිවිටෙකත් වෙනත් සේවාගේ අභ්යන්තර විස්තර ඇතුළත් නොකරයි.

සීමාව

සීමාවවටිනා
ප්රධාන ඉල්ලීම්මිනිත්තු 120 ක් පමණ වේ.එහෙත් 429 සමග Retry-After.
යතුරකින් තොරව ඉල්ලීම්ලිපිනයකට මිනිත්තු 120, ආකෘති, ඇඩ්රොයිඩ් සහ ගෙවීම් ක්රම ලැයිස්තුව සඳහා, ආපසු ගෙවීම් ටෝකන් චෙක්පත් සහ ගෙවීම් අංගයක් නොමැතිව ඇමතුම්. 429 සමග Retry-After.
අසාර්ථක authenticationසෑම ලිපිනයකටම විනාඩියකට 30 යි, අත්සන්, ගෙවීම් ප්රවේශයන් සහ තහවුරු නොකරන ආපසු ගෙවීම් ටෝකන් සඳහා.එහෙත්, ප්රවේශයක් ඇති ලිපිනයෙන් සෑම ඉල්ලීමක්ම ලැබේ 429 සමග Retry-After මිනිත්තුව අවසන් වන තුරු, ශරීරය කියවීමට පෙර බලපත් ර පරීක්ෂා කරනු ලැබේ.
නව යතුරුපැය 60 කින් පැය 120 කින් පැය 120 කින් පැය 60 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින්
Top-up ගිණුම්පැය 60 කින් පැය 120 කින් පැය 120 කින් පැය 60 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින් පැය 120 කින්
NWC Wallet සම්බන්ධතාපැය 10 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 10 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය 30 කින් පැය wss:// ස්ථාවර වරාය මත
ටෝකන් ආපසු ගෙවීමවිනාඩියකට ඉල්ලුම් 60ක්
ලිපිනයIPv6 ලිපිනය සෑම ලිපිනයකටම සම්පූර්ණ /64 ලෙස ගණනය වන අතර IPv4 මැප්පට් IPv6 ලිපිනයෙන් IPv4 ලිපිනය ලෙස ගණනය වේ.
JSON ඉල්ලුම ශරීරය4 MB; ඔබේ nym සමඟ අත්සන් කරන ඉල්ලීම් සඳහා 64 KB.
Multipart request body (අඩුගත කිරීම්)32 MB. සංස්කරණය කිරීම සඳහා ඡායාරූපය 20 MB දක්වා, ඇඩ්විඩ් ගොනුව 25 MB දක්වා විය හැකිය. 64 කොටස්, එක් එක් කොටස් අකුරු 8 KB දක්වා සහ 1 සිට 70 චරිත දක්වා සීමාවක් ඇති අතර, අනෙක් අතට 400 invalid_multipart.
එක් චැට් ඉල්ලීමක ඡායාරූප20 - සෑම කෙනෙකුම https:// හෝ http:// ප් රවෘත්ති ගනුදෙනුකරුවකු වෙත සබැඳි හෝ A data:image/… URL එක
පරම්පරාවට අනුව පින්තූර ඉල්ලීම1 සහ 4 (n)
ටෝකන් ප්රතිඵලඋදාහරණයක් වශයෙන්, වඩාත් ප්රමාණවත් මෘදුකාංගය, වඩාත් විශාල max_tokens එය අවම කර ගැනීම, ප් රතික්ෂේප කිරීම නොවේ.
කතාව ඇතුලත් කිරීමසාමාන් ය කටහඬ සඳහා 800 චරිත, Aura 2 සඳහා 2,000 චරිත.
පරිවර්තනය30 min audio, 25 MB. දිගුකාලීන ලියාපදිංචි කිරීම ප් රතික්ෂේප වේ 413 ඒ කාලෙට අලුත් දෙවිවරු නැති නිසා දෙවිවරු දුක් වෙනවා."
ඇතුළත්ඉල්ලුමකට 100ක්
වීඩියෝ රැකියාවපැය 24 කට පසු ඔවුන් ඉදිරිපත් කරනු ලැබූ අතර, පැය 1 කට පසු ප්රදර්ශනය ලබා දෙයි.
ඉතිහාසය අවශ්යදින 90ක් ගතවනු ඇත.
ක්රියාකාරී Key Per Nym25) අවලංගු කරන ලද නවතම යතුරු 50 පමණි.

ඡායාරූපයට සබැඳිය යුතු වන්නේ පොදු host එකකි: පෞද්ගලික හෝ දේශීය ජාලයේ, හෝ Nymbot හිම වෙබ් අඩවිවල ලිපිනය ප් රතික්ෂේප කරනු ලැබේ.

API දකින දේ

API යනු යෙදුම්වල පෞද්ගලික නොවේ, එය කෙසේද යන්න පිළිබඳ නිශ්චිත විය යුතු ය.

  • එය අන්තිමට සංකීර්ණ නොවේ. යෙදුම් වලදී, ඔබගේ උපාංගය මත පණිවිඩයක් තබන්නේ Nymbot හි තබන හා ගමන් කරන යතුරු පමණි. තෑග්ග WrapAPI ඉල්ලීම සාමාන් ය HTTPS වේ: එය Nymbot වෙත ගමන් කරන අතර, Nymbot හි සේවාදායකයා එය කළමනාකරණය කිරීම සඳහා එය කියවා ඇත.
  • ප්රශ්න සහ ප්රතිචාර ගබඩා නොකරයි. ඔවුන් ආකෘතිය හරහා හා ප්රතිචාර ආපසු පවතී. ඉතිරි කරන්නේ ගිණුම: සෑම ඉල්ලීමකටම කාලය, ආකෘතිය, වර්ගය, ටෝකන් ගණන, වියදම, ඉලක්කය, යතුර සහ එය සාර්ථක වියදම, දින 90 සඳහා, එය කුමක්ද ඉතිහාසය සොයන්න එකම ඉල්ලුම (කාලය, වර්ගය, ආකෘතිය, ටෝකන් ගණන, වියදම, කාලගුණය සහ එය වෙබ් සෙවුම භාවිතා කරනවාද හෝ සාර්ථක වියදම් කරනවාද යන්න) භාවිතා කිරීමේ ලියාපදිංචියත්, යෙදුමගේම සමග 90 දිනක් සඳහා තබා ගනී.
  • නයිම් සඳහා තබා ඇති අනෙකුත් සියල්ල කුඩා සහ මෙහි ලැයිස්තුගත කර ඇත. ගිනි යතුරු ඔවුන්ගේ නම, කෙටි ඉඟියක්, වියදම් කපාටයක්, ආපසු සකස් කිරීමේ කාලසීමාව, අවසානය සහ ඔවුන් නිර්මාණය කරන විට සහ අන්තිමට භාවිතා කරන විට, කිසිවිටෙකත් යතුරු පුවරුවක් ලෙස ගබඩා කරනු ලැබේ; නවතම 50 අවලංගු කර ඇති යතුරු පමණක් තබා ඇත. ස්වයංක්රීය Top-Up ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංගම දුරකථන ජංග
  • App එක පාවිච්චි කරනකොට ඒක අයින් වෙනවා. A උපකරණ wipe සෑම API යතුරක්ම අවලංගු කිරීම සහ ඉවත් කිරීම, ප්රශ්න ඉතිහාසය, භාවිතය වාර්තා, ජංගම දුරකථන සම්බන්ධතාවය සහ වීඩියෝ රැකියාව ඉවත් කිරීම.
  • ආකෘති සැපයුම්කරු ඔබේ ඉල්ලීම දැක ඇතCatalog models run at their makers; standard routes and embeddings run on Cloudflare.
  • මාධ් යවේදීන් විසින් නිර්මාණය කරන ලද ප් රවෘත්ති ප් රවෘත්ති සබැඳි ලෙස සපයන ඡායාරූප සහ වීඩියෝව පොදු Blossom ගොනු ගබඩාවට උඩුගත කරනු ලැබේ, එහිදී ගොනුවගේ ලිපිනය එහි හෙෂය වේ. b64_json පින්තූරයක් නැවත ප්රතිචාරයට එයි, එය කිසිවිටෙකත් උඩුගත නොකරයි.
  • ඒ වගේම ඔබ ජෙනරාටරය ලබා දෙන පින්තූර. ඔබ upload කරන ඡායාරූපය Editඑහෙනම් එවන්න A data: Generator එකේ URL එක image_url, මුලින්ම ප්රසිද්ධ Blossom ගබඩාවට උඩුගත කරනු ලැබේ, එබැවින් ජෙනරාටර් එය ලබා ගත හැකි අතර, එය එසේම පවතී. https:// චැට් ඉල්ලීමක ඡායාරූප model's provider වෙත යන්නේ, Blossom වෙත නොවේ.
  • ඔබගේ NIM එකට සබැඳි යතුරක් ඇත. යතුර වියදම් කරන සෑම දෙයක්ම ඔබේ නයිම් සංසන්දනයෙන් ලැබෙන නිසා API භාවිතය නොවේ. Anonymousඔබ API භාවිතය ඔබේ දිනපතා නයිම් වලින් වෙන්ව තබා ගැනීමට අවශ්ය නම්, ඔබේම ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී ඵලදායී

ඔබ යෙදුම් ආරක්ෂා කිරීමට අවශ්ය නම්, යෙදුම් භාවිතා කරන්න. API ඔබ ඔබේම මෙවලම් තුළ ආකෘති අවශ්ය විට සඳහා වේ.

සෑම අවසානයකම

අවසානයඑය කරන්නේ කුමක්දවාතය
GET /api/v1/modelsලැයිස්තුව ආකෘතිමිලට සමගකිසිදු
POST /api/v1/chat/completionsචැට් සම්පූර්ණKey එක
POST /api/v1/responsesපිපිරීම් පිළිතුරුKey එක
POST /api/v1/messagesAnthropic පණිවිඩKey එක
POST /api/v1/messages/count_tokensinput tokens ගණනය කිරීමKey එක
POST /api/v1/images/generationsපින්තූර නිර්මාණයයතුර හෝ ආලෝකය
POST /api/v1/images/editsImage එක Edit කරන්නයතුර හෝ ආලෝකය
POST /api/v1/videos, GET /api/v1/videos, GET /api/v1/videos/{id}ආරම්භ, ලැයිස්තු සහ වීඩියෝ පරීක්ෂායතුර හෝ ආලෝකය ආරම්භ කිරීම 1
POST /api/v1/audio/speechText to කතාවයතුර හෝ ආලෝකය
GET /api/v1/audio/models, GET /api/v1/audio/voicesAudio Model සහ Voiceකිසිදු
POST /api/v1/audio/transcriptions, POST /api/v1/audio/translationsText to Speech, සහ ඉංග් රීසියතුර හෝ ආලෝකය
POST /api/v1/embeddingsඇතුළත්යතුර හෝ ආලෝකය
GET /api/v1/credits/balance හෝ POST)දෙකම BalanceKey එක
GET /api/v1/topup/payment-methodsගෙවීමේ ක් රමකිසිදු
POST /api/v1/topup/create/btc-lightningLightning ගිණුමKey එක
GET /api/v1/topup/status/{invoice_id}Checks and Credits එයKey එක
GET /api/v1/queries/historyසෑම ඉල්ලීමක්ම කොපමණ වියදම්Key හෝ NIM
GET /api/v1/accountගිණුම් සලකා බැලීමනෝනා
/api/v1/keysයතුරු නිර්මාණය, වෙනස් කිරීම සහ අවලංගු කිරීමනෝනා
/api/v1/nwc-auto-topupස්වයංක්රීය Top-upsනෝනා
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeemChecks or redems a refund token - ආපසු ගෙවීමේ ටෝකන්Refund token; nym to redeem - ආපසු ගෙවීම

“Nym” ඔබේ Nostr යතුරකින් අත්සන් කරන ඉල්ලුමක්, ගිණුම් අත්සන් ඉල්ලීමමේවා ගැන දැනටමත් කතා කරන මෙවලම් සඳහා, බලන්න මෙවලම් සහ SDKs, සහ Claude Code, Codex සහ Cline වැනි coding agents සඳහා, බලන්න coding උපකරණ.