Skip nav naverokê
Vegere Nymbot

Bingeha zanînê Dizayner/Pêşveber

Amûr û SDKs

Her tiştê ku dikare bi OpenAI an Anthropic re biaxive dikare bi Nymbot re jî biaxive. Di hema bê hejmarî de, ew URL-eke bingehîn, tûrek (key) û navê modelek e.

Her amadekirina li jêr پێویstî bi API keyekî heye, ku di applîkasyonê de hatîye çêkirin API menû (binêre Kuncên API), û ID-ya modelekî ji lîsteya modelan. Mînak bi kar tînin anthropic/claude-sonnet-5 li ser hevsengiya Pro. nymbot/auto li ser hejmarê ya standart ji bo sohbetên sade yên bi biha têr, lê nikare amûr bixe nîşandan, ku Goose pêdivî bi wê re heye; ji bo wê, modelekî katalogê hilbijêrin ku bi capabilities.tools.

Amadekarî ji bo ajanên kodan wek Claude Code, Codex, Cline, Kilo Code û Continue li ser rûpela xwe ye: dibistanên kodkirinê.

Her amûrekê mîftekekê bide.

Ji bo her amûrekê klîbeke cuda çêke, bi sînor de. Agentên kodê ji bo yek erkê gelek çerxandinên modelan dikin, û sînorkirina klîbekê hêsantirîn rê ye ku mirov bizanibe zêdetir ji çi hejmar amûr dikare xeman bikar bîne. Heke amûrek bi awayekî şaş tevgerê bide, klîbekê betal bike û tiştên din ne bêîbandor dibin.

OpenAI SDK

Libeyatên fermî yên Python û JavaScript bê guhertin kar dikin. Xal. base_url li Nymbot û perwerdeya xwe bide. Chat Completions, Responses, images, audio û embeddings hemû bi rêya wan dixebitin.

cURL

curl https://nymbot.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "anthropic/claude-sonnet-5", "messages": [{"role": "user", "content": "Hello"}]}'

Python

# pip install openai
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="anthropic/claude-sonnet-5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(reply.choices[0].message.content)

JavaScript

// npm install openai
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: "anthropic/claude-sonnet-5",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(reply.choices[0].message.content);

Zayîndeyên Nymbot'ê yên xwe, mîna plugins Ji bo lêgerîna webê, bikeve extra_body di Python de û rasterast di objekta daxwazê de bi JavaScript. nymbot çîmek di bersivê de ye reply.model_extra["nymbot"] di Python û reply.nymbot di JavaScript de. Liberekên ku dixwînin OPENAI_BASE_URL û OPENAI_API_KEY Guherbarên hawirdorê bi wan tenê dikarin bê meşandin ser Nymbot.

SDK ya Anthropic

Libêreyên Anthropic bi kar tînin https://nymbot.ai/api wek baseUrl, bêyî /v1, ji ber ku wan zêde dikin /v1/messages bi wan ve. Her modelekî katalogê kar dike, ne tenê Claude.

cURL

curl https://nymbot.ai/api/v1/messages \
  -H "x-api-key: $NYMBOT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'

Python

# pip install anthropic
import os
import anthropic

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

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(message.content[0].text)

JavaScript

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

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

const message = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello" }],
});
console.log(message.content[0].text);

Alîkarî kirin

Aider bi her serverekî ku bi OpenAI re lihev dike diaxive. URL-a bingehîn û kuncê deynin, û bixe openai/ li pêşî ID-a modelê da ku Aider bizanibe ew çi cure server e:

Shell

export OPENAI_API_BASE=https://nymbot.ai/api/v1
export OPENAI_API_KEY=sk-nymbot-...
aider --model openai/anthropic/claude-sonnet-5

Aider dikare hişyar bide ku ew mezinahiya konteksta modelê an jî bihayê wê nizanibe. Hişyarî bêzerar e; --no-show-model-warnings veşêre.

Open WebUI

Di Open WebUI de, veke Panela Adminê, paşê Setaan, paşê Têkilî, û koneksiyoneke OpenAI API lê zêde bike:

  • URL: https://nymbot.ai/api/v1
  • Ker: API keyê te

Open WebUI lîsteya modelan ji API yên dixwîne, lewma her modela sohbetê di hilbijartina wê de xuya dibe. Dema ku di Docker de tê xebitandin, ev yek bi guhartinên pergalê (environment variables) jî dikare bê kirin OPENAI_API_BASE_URL û OPENAI_API_KEY.

Open WebUI sohbetên we li ser serverê xwe disîne. Nymbot wan naxîne, lê Open WebUI dike, li ku derê ku hûn bi rê ve birin.

Goz

Biçe goose configure, hilbijêre Konfigurera Pêşanjeyan, hilbijêre OpenAI, û dema ku hat guhertin vê nirxên lê bide. Hemî wekî hev dikare di hawirdorê de were deynin:

Shell

export GOOSE_PROVIDER=openai
export OPENAI_HOST=https://nymbot.ai/api
export OPENAI_BASE_PATH=v1/chat/completions
export OPENAI_API_KEY=sk-nymbot-...
export GOOSE_MODEL=anthropic/claude-sonnet-5
goose session

Goose li ser hewlên her gavê amûran vedigire, lewma modelek bi ... hilbijêre capabilities.tools di lîsteya modelan de; nymbot/auto dibze amûr.

HTTP yê hêsan

Tu tiştî SDK naxwaze. Her endpoint JSON e li ser HTTPS e, ji bilî barkirinên fîlan, ku forma multipart in. Her ziman an amûreke ku bikaribe daxwazekê (request) HTTP çêbike dikare API bikar bîne:

  • Mifteya we wekî bişînin Authorization: Bearer sk-nymbot-….
  • Ajanên JSON bi şandın re Content-Type: application/json.
  • Ji bo streamingê, bersiv wekî server-sent events bixwîne; bi cURL re, lê zêde bike -N nexwe wekî ku ew digihîjin, wan çap dike.
  • Çarçoveyê ji xwarê hejmarê bixwîne X-Nymbot-Cost-Sats sernav, û parastina X-Request-Id sernav heke hewceyî be ku tu derbarê daxwazekê de bipirsî.

cURL

curl -i 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": "Hello"}]}'

Python

import os
import requests

res = requests.post(
    "https://nymbot.ai/api/v1/chat/completions",
    headers={"Authorization": "Bearer " + os.environ["NYMBOT_API_KEY"]},
    json={"model": "nymbot/auto", "messages": [{"role": "user", "content": "Hello"}]},
)
print(res.headers["X-Nymbot-Cost-Sats"], res.headers["X-Request-Id"])
print(res.json()["choices"][0]["message"]["content"])

JavaScript

const res = await fetch("https://nymbot.ai/api/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.NYMBOT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ model: "nymbot/auto", messages: [{ role: "user", content: "Hello" }] }),
});
console.log(res.headers.get("X-Nymbot-Cost-Sats"), res.headers.get("X-Request-Id"));
console.log((await res.json()).choices[0].message.content);