Arandupykuaaty ñemopyenda / Mba'apohára kuéra

Ñe'ẽngatu, Mbohe'ẽ ha Ñe'ẽnga

Mbohapy hendáicha eñe'ẽse peteĩ modelo rehegua, mbohapy ñemombo'e rupive umi cliente oñe'ẽháicha, opaite oñemohendáva opaite mba'e ha oñembojereháicha avei.

Ko páhina oñembohasa máquina-pe iporãve hag̃ua. Pe inglés original ha’e pe versión ojeporúva.

Ñe'ẽmbyaty Porãtapu

OpenAI chat ha’eicha, ha pe ikatúva opaite tembiapo oipytyvõva. Eheja pe ñe’ẽmboty jaipurúvo ha eguata pe oúva katu.

POST https://nymbot.ai/api/v1/chat/completions — API key oñenondéva.

ante model ha messages oñemohendáva. Peteĩ sampling parámetro oñembojeguaa haguã ko omohendáva ndoiporúi ha ndaha'éi error, upéicha peteĩ request body oĩ porã opaite modelo ndive. Ko modelo lista omombe'u opaite modelo'ỹ supported_parametersMba'éichapa oñemboyve mba'eve reity, ndaha'éi oñembohory: opa mba'e ndaikatúi ha'e omoĩva: ta'anga peteĩ modelo ndaikatúvape ohecha, tembipuru peteĩ modelo ndaikatúvape oipurú.

Pe tendapy ha'e peteĩ mba'e oikóva ojehecha jave chat.completion, opaite mba'e rehegua usage.cost (dólar-pe) ha pe nymbot tendajú. model ha'e pe oñemoambue mba'e puku, so peteĩ têno oñeñe'ẽ hag̃ua oñeñe'ẽ mbarete. Upéicha, ikatúramo oñomomba'e pe oñe'ẽmbajepýgui, i ñe'ẽmbyaty oĩ message.reasoning_content, hesakãvo pe ára reheve.

Ñepyrũmby

{
  "id": "chatcmpl-5f1c0a9e27d84b3c",
  "object": "chat.completion",
  "created": 1790726400,
  "model": "anthropic/claude-sonnet-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "A Lightning invoice is a one-time payment request..."
      },
      "logprobs": null,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1240,
    "completion_tokens": 380,
    "total_tokens": 1620,
    "prompt_tokens_details": { "cached_tokens": 0 },
    "completion_tokens_details": { "reasoning_tokens": 0 },
    "cost": 0.01895
  },
  "nymbot": {
    "balance": "pro",
    "charged_credits": 0.162,
    "charged_sats": 16.2,
    "balance_credits": 412.425,
    "balance_sats": 41242.5
  }
}

finish_reason jaikuaa mba'épa oúva rehe, oĩramo pe omoĩva oje'e ambue rupive: tool_calls modelo oñe'ẽvo mba'eichaitépa oñeñongatu va'erã tembipuru, length mba'éichapa pe hendáicha oipurúva opa mba'e ojeheja va'ekue ( térã pe modelo omoĩ opaite ko'ãva ñe'ẽmimirĩ ha ndoĩ mba'eve) content_filter oñembojeguaa jave pe oñe'ẽva, ha stop mba'eichaitépa ndaikotevẽ. usage.completion_tokens_details.reasoning_tokens ichaite 0: oñembohory reasoning tokens oñembohegui, ha oñembohetaguasu, ko'ápe completion_tokens.

Ko'ã techapyrã katuha oĩramo opa endpoint ndive, oĩ umi opa kuatia guasúpe ohechakuaa: Mba'e jave.

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": "system", "content": "Answer in one short paragraph."},
      {"role": "user", "content": "What is a Lightning invoice?"}
    ],
    "max_tokens": 400
  }'

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="anthropic/claude-sonnet-5",
    messages=[
        {"role": "system", "content": "Answer in one short paragraph."},
        {"role": "user", "content": "What is a Lightning invoice?"},
    ],
    max_tokens=400,
)
print(reply.choices[0].message.content)
print(reply.usage.cost)

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: "anthropic/claude-sonnet-5",
  messages: [
    { role: "system", content: "Answer in one short paragraph." },
    { role: "user", content: "What is a Lightning invoice?" },
  ],
  max_tokens: 400,
});
console.log(reply.choices[0].message.content);
console.log(reply.usage.cost);

Streaming

ndive "stream": true Pe hesakuaa oú server-sent events rupive, modelo oñe'ẽvo hag̃ua. Pe eventova'ekue ha'e... chat.completion.chunk peicha mbytépe data: tapytã, ha pe y-reru paha ndive data: [DONE]. Ñandupy oñembojerovia oñeñe'ẽvo delta.reasoning_content, pe mbojerovẽ pe delta.content.

Eñemoĩ mbarete opa mba'e ojejapóva oñemopyandu ndiveve 100 segundórnte, ha'ehápe peteĩ hendypáva añetegua, peteĩ ñe'ẽnguéra guasu, peteĩ mba'e guasu max_tokens mba'e reikuaáramo térã peteĩ razonamiento modelo. Pe peteĩ ñe'ẽnguéra ndoúi mba'eve mba'ére teĩ mba'ére ndaikatúi ikatu oñembohovái upéi ndaikatúi, ha pe ñe'ẽnguéra oĩva ne ndive ha Nymbot mbytépe oñemokãta peteĩ ñe'ẽnguéra oĩhápe ndaha'éi mba'evépe ~100 sekóndote rupi; pe modelo omoĩ mbarete ha opa mba'e omoĩva oñembohetáta, ha pe hesakã ndoikuaái. Pe stream omoĩ ñe'ẽnguéra oñembopoteĩ hag̃ua, upéicha oĩ oñembopytu'u mbarete ndaikatúi oñemokã oĩ porãvo pe modelo omoĩvo opa mba'e.

Ysyry

data: {"id":"chatcmpl-5f1c0a9e27d84b3c","object":"chat.completion.chunk","created":1790726400,"model":"anthropic/claude-sonnet-5","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}

data: {"id":"chatcmpl-5f1c0a9e27d84b3c","object":"chat.completion.chunk","created":1790726400,"model":"anthropic/claude-sonnet-5","choices":[{"index":0,"delta":{"content":"A Lightning invoice"},"finish_reason":null}]}

: keep-alive

data: {"id":"chatcmpl-5f1c0a9e27d84b3c","object":"chat.completion.chunk","created":1790726400,"model":"anthropic/claude-sonnet-5","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl-5f1c0a9e27d84b3c","object":"chat.completion.chunk","created":1790726400,"model":"anthropic/claude-sonnet-5","choices":[],"usage":{"prompt_tokens":1240,"completion_tokens":380,"total_tokens":1620,"cost":0.01895},"nymbot":{"balance":"pro","charged_credits":0.162,"charged_sats":16.2,"balance_credits":412.425,"balance_sats":41242.5}}

data: [DONE]

• Ñe'ẽnguéra umi oñondivepa : ha'e keep-alive komentó, ojeja 15 segundokuetépe modelo oñe'ẽvo jave. SSE kliente'ỹra omoĩ opa.
• Ejerure "stream_options": {"include_usage": true} ojupytývo pe pa'ũ opa hag̃ua yukepe, ndereĩva ndive choices, pe kuatia mbyky, pe ojehechakuaáva ha pe... nymbot tendajú.
• Pe mbo'eha kuatia oñembo'y tembiapo oñemoirũramo. Reityryre pe koneksion, pe modelo ndaha'éi oñembo'y: Nymbot omoĩ tembiapo pe providór rembiapokuéra reheve, hasta 25 segundópe, ohecha hag̃ua i'e token kuatia, ha reityry pe providór omohendáva. Pe kuatia ndaikatúi nderehechávo, pe mbo'eha oñembo'y ne rembiapo ha mba'éichapa oñembo'e, ha avei pe modelo oñe'ẽva reheve oĩva opaite mba'e.
• Pete hendypy'a ambue oñepyrũmbýrõ, ha'e kuaa: 401 ha'e 402, oúma haguére teko porãicha JSON ha'e haguére i'e status code, ndaha'éi stream. Pe error oúva pe stream ñepyrũ rire oúma pe tapiaite data: {"error": {…}} evento, ha pe stream ojeheja ndereivo [DONE].
• Tekombo'e kuatia ha mbojerovia mímopu'ã ha modelokuéra OpenAI's Responses mbopegua rehegua, ndaha'éi techapyrã provider-gui. Ha katu oñe'ẽ hikuái techapyrã iporãmbajepépe, oñembosẽ porã rireka oñembohasávo.

cURL

curl -N https://nymbot.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nymbot/auto",
    "stream": true,
    "stream_options": {"include_usage": true},
    "messages": [{"role": "user", "content": "Write a haiku about sats."}]
  }'

Python

import os
from openai import OpenAI

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

stream = client.chat.completions.create(
    model="nymbot/auto",
    stream=True,
    stream_options={"include_usage": True},
    messages=[{"role": "user", "content": "Write a haiku about sats."}],
)
for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="", flush=True)
    elif chunk.usage:
        print("\ncost:", chunk.usage.cost)

JavaScript

import OpenAI from "openai";

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

const stream = await client.chat.completions.create({
  model: "nymbot/auto",
  stream: true,
  stream_options: { include_usage: true },
  messages: [{ role: "user", content: "Write a haiku about sats." }],
});
for await (const chunk of stream) {
  if (chunk.choices.length) process.stdout.write(chunk.choices[0].delta.content || "");
  else if (chunk.usage) console.log("\ncost:", chunk.usage.cost);
}

Tekove ñemongove haipyrekuéra

Eñe'ẽ mbo'ehaipyrekuérakuérape tools ha pe modelo ikatu eipuka peteĩ mba'e oñeñombojojáramo ipyepy'apy haguére. Reipy'apy pe función, reity mbohovái iresulta peteĩ tool michĩmíicha opaichagua message tool_call_id, ha remimombe'u umi ñe'ẽrãndu avei. Nymbot ndoguereki ne remba'apo; ha omoĩ kembali pe modelo'enough ñe'ẽrãndu ndéve.

tool_choice ñembojegua "auto", "none", "required" ha'e {"type": "function", "function": {"name": "…"}}Moõicha mbo'ehao rendapykuéra ohecha mba'épa mbo'ehao oñeñe'ẽ porã tools (capabilities.tools). Tembi'u oñe'ẽvo peẽme 400 unsupported_tool oĩ nymbot/auto ha umi modelo michĩmi oĩva katalogpe oñemboaje OpenAI's Responses transport-pe, upéicha Nymbot ndaikatúi omoĩ tembiapo upépe.

ndive "stream": true, peteĩ techapyra mba'eicha tools oñembohory peteĩ mba'e rehegua ha upéi oñembosarái peteĩ tekotevẽ mba'eicha: pe role, peteĩ techapyra oĩva mba'eicha tools call opa mba'e rehegua i'ypy, id, nombre ha mba'e oñombojoaju va'ekue, ha pe techapyra oñemoirũva. Mba'eichaitépa oñembohovái techapyra mba'eicha tools call ojerekóva, upéicha oñemboja.

Mbojeréio, partekuve

"choices": [
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": null,
      "tool_calls": [
        {
          "id": "call_7d2e",
          "type": "function",
          "function": { "name": "get_invoice_status", "arguments": "{\"invoice_id\":\"a41f\"}" }
        }
      ]
    },
    "finish_reason": "tool_calls"
  }
]

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": "Has invoice a41f been paid?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_invoice_status",
        "description": "Look up whether an invoice is paid.",
        "parameters": {
          "type": "object",
          "properties": {"invoice_id": {"type": "string"}},
          "required": ["invoice_id"]
        }
      }
    }]
  }'

Python

import json, os
from openai import OpenAI

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

tools = [{
    "type": "function",
    "function": {
        "name": "get_invoice_status",
        "description": "Look up whether an invoice is paid.",
        "parameters": {
            "type": "object",
            "properties": {"invoice_id": {"type": "string"}},
            "required": ["invoice_id"],
        },
    },
}]
messages = [{"role": "user", "content": "Has invoice a41f been paid?"}]

reply = client.chat.completions.create(model="anthropic/claude-sonnet-5", messages=messages, tools=tools)
call = reply.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)

messages.append(reply.choices[0].message)
messages.append({"role": "tool", "tool_call_id": call.id, "content": json.dumps({"paid": True})})

final = client.chat.completions.create(model="anthropic/claude-sonnet-5", messages=messages, tools=tools)
print(final.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 tools = [{
  type: "function",
  function: {
    name: "get_invoice_status",
    description: "Look up whether an invoice is paid.",
    parameters: {
      type: "object",
      properties: { invoice_id: { type: "string" } },
      required: ["invoice_id"],
    },
  },
}];
const messages = [{ role: "user", content: "Has invoice a41f been paid?" }];

const reply = await client.chat.completions.create({ model: "anthropic/claude-sonnet-5", messages, tools });
const call = reply.choices[0].message.tool_calls[0];
const args = JSON.parse(call.function.arguments);

messages.push(reply.choices[0].message);
messages.push({ role: "tool", tool_call_id: call.id, content: JSON.stringify({ paid: true }) });

const final = await client.chat.completions.create({ model: "anthropic/claude-sonnet-5", messages, tools });
console.log(final.choices[0].message.content);

Ta'anga peteĩ ñe'ẽnguéra reheve

Mba'erepy ndive capabilities.vision ta'anga reka kuaa. Eñemboja peteĩ image_url mbojegua peteĩ oñeñe'ẽha reko, oĩháicha peteĩ opaite mba'e https:// link térã a data:image/…;base64, URL. Upéicha 20 tapicha rupi peteĩ tembiapo rehevépe. SVG tapicha oñembojere, ha avei peteĩ link upéicha 4,096 kárakter oĩva térã peteĩ user name térã password oĩva iñe'ẽme (400 invalid_image_url). Peteĩ oĩhápe ikatu oñemboyve detail ha'e auto, low ha'e high.

ndive nymbot/auto, peteĩ ñe'ẽnguéra ha peteĩ ta'anga oĩva ijerére oho peteĩ modelo ypývape oĩhápe ohecha va'erã. Peteĩ modelo katalogi ndaha'éi capabilities.vision rehecha'ỹta ta'anga ndive 400 unsupported_content. Ta'anga ikatu añete oĩ mensáhengue user-pe. Link oĩva oñembohasa peteĩ host públiko-pe; Nymbot omohenda ta'anga modelo-pe omoĩva provider-pe ha ndoikuiti.

Ta'anga oñembo'eicha pe provider oñembo'e hag̃ua input token-re, haicha pe ambue request-pe.

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": [
        {"type": "text", "text": "What is in this picture?"},
        {"type": "image_url", "image_url": {"url": "https://example.com/receipt.jpg"}}
      ]
    }]
  }'

Python

import base64, os
from openai import OpenAI

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

with open("receipt.jpg", "rb") as f:
    data_url = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()

reply = client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "What is in this picture?"},
            {"type": "image_url", "image_url": {"url": data_url}},
        ],
    }],
)
print(reply.choices[0].message.content)

JavaScript

import { readFile } from "node:fs/promises";
import OpenAI from "openai";

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

const dataUrl = "data:image/jpeg;base64," + (await readFile("receipt.jpg")).toString("base64");

const reply = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-5",
  messages: [{
    role: "user",
    content: [
      { type: "text", text: "What is in this picture?" },
      { type: "image_url", image_url: { url: dataUrl } },
    ],
  }],
});
console.log(reply.choices[0].message.content);

Jepy'apy

Mba'erepy ndive capabilities.reasoning oiñemoarandu oñe'ẽmboyve. Eporani hetave térã oĩmbarete ndive reasoning_effort ("minimal", "low", "medium" ha'e "high") térã "reasoning": {"effort": "high"}, térã jepota :thinking modelo ñepyre, oñe'ẽva mburuvicha mba'e. Peteĩ modelo ndoguerekóijaháicha pensamientu, pe ñe'ẽnguéra ndojapoiméi. Jepu'ã umi ndive nymbot/auto, :thinking emindíva pe petye jerure standard reasoning rupive.

Anthropic môdrape pe mba'e ojejapóva ha'e peteĩ ñe'ẽmbyky (thinking budget) opaite 1,000, 2,000, 8,000 térã 16,000 tokens, ndaha'éi mba'eve hetave ko'ãnte max_tokens he'i. Ñamomuandu'u ndaha'éi mba'eve reheve tool_choice mbojerure peteĩ tembipuru, ha upéi pe peteĩ ñe'ẽnguéra tekove (pe iñe'ẽ porãvéva ha'e peteĩ tembipuru mba'e), ani hag̃ua Anthropic oñemoĩ mboyve pe ñe'ẽnguéra oñembohovái mba'eicha oñepyrũ hag̃ua upéicha. Ko'ã mba'e oñeñe'ẽ avei Responses ha Messages endpoints rehegua.

Pe ñe'ẽnguéra oú kembali message.reasoning_content, térã delta.reasoning_content ñamombe'u jave, ndaha'éi oñemoĩ umi hesakuãme. Ñañe'ẽ haipyre oĩ ha upéicha ojehecha, oñemoĩvo pe mba'e oĩhápe completion_tokensMombarete pypekuéra ndojerurei pe ñe'ẽ ñe'ẽmbotapy ndaha'éi, ha upéicha avei oñembo'y.

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",
    "reasoning_effort": "high",
    "messages": [{"role": "user", "content": "Is 2^61 - 1 prime? Show why."}]
  }'

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="anthropic/claude-sonnet-5",
    reasoning_effort="high",
    messages=[{"role": "user", "content": "Is 2^61 - 1 prime? Show why."}],
)
message = reply.choices[0].message
print(getattr(message, "reasoning_content", None))
print(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: "anthropic/claude-sonnet-5",
  reasoning_effort: "high",
  messages: [{ role: "user", content: "Is 2^61 - 1 prime? Show why." }],
});
console.log(reply.choices[0].message.reasoning_content);
console.log(reply.choices[0].message.content);

Mbo'ehaovã paha

Peteĩ suffix mba'eichaitépa oñeñe'ẽva pe modelo réra rehegua omohenda ambue mba'e rehe, ndaha'éi ambue kuatiahaicha'ỹre. Ha'ekuéra oñeñe'ẽ mba'eichaitépa mba'eichaitépa mba'e porãite ha ñe'ẽnguéra rehe, oñemboherakuãicha anthropic/claude-sonnet-5:online.

Tekotevẽ ndaikatúi opaite suffix-ku. Ko'ẽg̃ua hendive oñeñongatu hi'aremýgui, upévare peteĩ modelo i'arye tapiaite kolón (:) oĩramo oĩ oñembopyry; upéicha ndaikatúiramo, suffix-ku oñemombaretéva oñepyrũ hi'aregui peteĩnte oñemomombove hag̃ua peteĩ modelo oñeñongatu hag̃ua. Modelo réra ikatu hakuã upéicha 200 characters-pe ha upéicha 4 suffix-pe; oĩramo hetave, oñembojere oĩramo hese: 400 invalid_value.

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:thinking",
    "messages": [{"role": "user", "content": "Plan a three-day trip to Lisbon."}]
  }'

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="anthropic/claude-sonnet-5:thinking",
    messages=[{"role": "user", "content": "Plan a three-day trip to Lisbon."}],
)
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: "anthropic/claude-sonnet-5:thinking",
  messages: [{ role: "user", content: "Plan a three-day trip to Lisbon." }],
});
console.log(reply.choices[0].message.content);

Internetta jaheka

Cháta modelo opaichagua ikatúta eñe'ẽ avei internet-gui. Nymbot ojerure pe tembiapo upe mokõi ambue ñe'ẽ (its first 2,000 characters), omoĩ porã tembiapo ha omohenda pe modelo pe mba'e oje'ẽva, oje'e chupe ndaikatúi oñe'ẽ porãnte pe mba'e oje'e va'ekue upe tembiapo rehe. Oĩ mokõi modo:

• Ára ha ára ñeha'ã: "plugins": [{"id": "web", "max_results": 5}], ha a :online mbo'ehao puku upe môdelo reheve.
• Eporandu mba'éichapa oipytyvõ: "tools": [{"type": "web_search", "parameters": {"max_results": 5}}], avei jehechakuaa hag̃ua web_search_preview ha'e openrouter:web_search. Nymbot ohekaetereíma oñeñe'ẽramo interrogación oñemohendáva oĩva oñongatu hag̃ua ko'ágã arandu, pe ambue tembiapo oipurúva avei.

max_results 5 ha'e tembiapo oñemboja'o jerovia rupive ha upéi ha'eve 10. Tembiapo oñeñembojoa peẽme nymbot.web_search.sources, opaite hendáicha a title, snippet ha url, ha upeve url_citation ñe'ẽmbojoaju tekove oñeñe'ẽ hag̃ua message reheve.

Mba'eveichaguasu ojejapóva opaite rehegua oñembosarái $0.008, oñembohasa sats-pe, tokens-re oñondivepa, ha oĩ peteĩ mba'e oñembohovái hag̃ua. Ko'ã oñehechaukáva mba'e ha'e avei input tokens, upévare peteĩ hendy kuatiaha pe internet-gui oĩ gueteri opaite mba'e opaite mba'e reipyva'ekue, ojehupyty avei hetave opaite mba'e reipyva'ekue guare.

Mbojeréio, partekuve

"nymbot": {
  "balance": "pro",
  "charged_credits": 0.431,
  "charged_sats": 43.1,
  "balance_credits": 411.994,
  "balance_sats": 41199.4,
  "web_search": {
    "sources": [
      { "title": "Lightning Network - Wikipedia", "snippet": "The Lightning Network is a payment protocol...", "url": "https://en.wikipedia.org/wiki/Lightning_Network" }
    ]
  }
}

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",
    "plugins": [{"id": "web", "max_results": 5}],
    "messages": [{"role": "user", "content": "What changed in the latest Bitcoin Core release?"}]
  }'

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="anthropic/claude-sonnet-5",
    messages=[{"role": "user", "content": "What changed in the latest Bitcoin Core release?"}],
    extra_body={"plugins": [{"id": "web", "max_results": 5}]},
)
print(reply.choices[0].message.content)
for source in reply.model_extra["nymbot"]["web_search"]["sources"]:
    print(source["url"])

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: "anthropic/claude-sonnet-5",
  plugins: [{ id: "web", max_results: 5 }],
  messages: [{ role: "user", content: "What changed in the latest Bitcoin Core release?" }],
});
console.log(reply.choices[0].message.content);
for (const source of reply.nymbot.web_search.sources) console.log(source.url);

Respuésa API

OpenAI-pe oĩva rembiapo pyahu'ỹva, OpenAI Agents SDK ha Codex oipurúva. Oñemba'apo Chat Completions-icha mba'eicha iñe'ẽmby, oñemoni ha iñemba'apo.

POST https://nymbot.ai/api/v1/responses — API key oñenondéva.

Ñepyrũmby

{
  "id": "resp_8c1e4b0f9a2d4e61",
  "object": "response",
  "created_at": 1790726400,
  "status": "completed",
  "model": "anthropic/claude-sonnet-5",
  "output": [
    {
      "type": "message",
      "id": "msg_2b7f",
      "role": "assistant",
      "status": "completed",
      "content": [{ "type": "output_text", "text": "A Lightning invoice is...", "annotations": [] }]
    }
  ],
  "output_text": "A Lightning invoice is...",
  "usage": {
    "input_tokens": 1240,
    "input_tokens_details": { "cached_tokens": 0 },
    "output_tokens": 380,
    "output_tokens_details": { "reasoning_tokens": 0 },
    "total_tokens": 1620
  },
  "incomplete_details": null,
  "error": null,
  "instructions": null,
  "store": false,
  "previous_response_id": null,
  "metadata": {},
  "nymbot": { "balance": "pro", "charged_credits": 0.162, "charged_sats": 16.2, "balance_credits": 412.425, "balance_sats": 41242.5 }
}

Tekoté rupi peteĩ tembi'u ojehechávo output ichaicha mba'eicha function_call tembiapo ndive call_id, name ha arguments; eñeñe'ẽmína pe mba'e ojejapáva ndéve a mbo'e hag̃ua function_call_output mbojeréi oñondiveveva call_idMba'eichaitépa oñe'ẽ, ojehecha hag̃ua pe modelo omoĩvo chupe, ha'e peteĩ reasoning tembiapo ndive reasoning_text tembikuaaty, ñemongove mokairũicha. status ha'e incomplete oñemyatyrvo umi hesakãva max_output_tokens mba'eichaitépa pe provider opavavé rerekóva, ndive incomplete_details.reason mohendas max_output_tokens ha'e content_filter. Peĩme avei oñemombyaty pe ñe'ẽnguéra rembiapo (temperature, tools, tool choice ha ambueve), OpenAI-icha, ha oĩ avei pe nymbot osẽ téra.

Oñembojegua, opaite tembiapo ha'e peteĩ event: línea ha peteĩ data: pypy a'ỹre sequence_number, ko tembiapo rehegua: response.created, response.in_progress, response.output_item.added, response.content_part.added, opaichagua hetavekuéra response.output_text.delta, response.output_text.done, response.content_part.done, response.output_item.done, ha opaiteve response.completed péicha pe reime ha mba'eicha oĩva. Pe hesakã oñembo'y va'erã pe response.incomplete hesakãnte, ha peteĩ mbojerovapy oñepyrũramo pe tesa'ỹi ndive response.failed. Reasoning streams iñonẽ iñeẽ porãnte ndive response.reasoning_text.delta ha .done. Tool calls oĩ opaite message rire, opaite peteĩ mba'e kuatia rehegua ndive response.function_call_arguments.delta ha .done.

cURL

curl https://nymbot.ai/api/v1/responses \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "instructions": "Answer in one short paragraph.",
    "input": "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"])

response = client.responses.create(
    model="anthropic/claude-sonnet-5",
    instructions="Answer in one short paragraph.",
    input="What is a Lightning invoice?",
)
print(response.output_text)

JavaScript

import OpenAI from "openai";

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

const response = await client.responses.create({
  model: "anthropic/claude-sonnet-5",
  instructions: "Answer in one short paragraph.",
  input: "What is a Lightning invoice?",
});
console.log(response.output_text);

Anthropic Ñe'ẽ

Anthropic rembiapo, Anthropic SDK-kuérape ha Claude Code-pe g̃uarã. Oñembojoaju opa mba'eichagua modelokuéra ndive upe katalog reheve, ndaha'éi Claude-re añónte: pe peteĩ jerure oñeñe'ẽmby, oho pe hendápe oñembopota haguã, ha upéi oñeñe'ẽmby kembali.

POST https://nymbot.ai/api/v1/messages — API key oĩra'u, oĩnte x-api-key ha'e Authorization: Bearer.

The anthropic-version ha anthropic-beta ñe'ẽnguéra oñembojoaju ha oñemboja'o. Anthropic modelo ñeténguéra oñeñe'ẽ umi katálogo ndive, upéicha Claude Code ha SDKs oñemoambue ko'ã ñeténguéra ikatúvo oipytyvõ:

• Héra katalogo oikuaáva, peicha claude-sonnet-5 ha'e anthropic/claude-opus-5, oje'a mba'éichapa oĩ.
• Eñembosarái ára (-20260514), -latest, peteĩ version tag mba'eicha -v1, peteĩ techapyrã rakãgua upeicha guarani [1m] ha ha anthropic/ ha'e anthropic. prefix-kuera oñembojererekotei, ha dots ha dashes version rupive oñeñemohenda opa hendáicha (claude-haiku-4-5 ojuhu claude-haiku-4.5).
• Ife ndaha'éi mba'eve, pe ryguasu (Opus, Sonnet térã Haiku) oñeembotyrõ, upéicha asýramo pe katalogo version oñondiveha térã ipu'akave pe oñe'ẽva rehegua.
• Tetã ndaikatúi mba'e reipa mba'eve ndive oñondivepa 404 not_found_error.

Ñepyrũmby

{
  "id": "msg_01c7a2f93e5b4d08",
  "type": "message",
  "role": "assistant",
  "model": "anthropic/claude-sonnet-5",
  "content": [{ "type": "text", "text": "A Lightning invoice is..." }],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 1240,
    "output_tokens": 380,
    "cache_read_input_tokens": 0,
    "cache_creation_input_tokens": 0
  },
  "nymbot": { "balance": "pro", "charged_credits": 0.162, "charged_sats": 16.2, "balance_credits": 412.425, "balance_sats": 41242.5 }
}

content ha'e avei ikatu jave tool_use mbo'eha ha a thinking pytu'u, mba'épa i... signature etéite. stop_reason ha'e end_turn, max_tokens, tool_use ha'e refusal, oñembojoaju avei mba'éichapa finish_reason oĩ Ñe'ẽmbyaty Porãtapu; stop_sequence ichaite paha null, upéicha avei peẽme oñembo'e ojehecha haguã pe hendapyre omoĩvo opa. input_tokens hesa'u mba'e oñembopopu javente; mba'e oĩma oĩ mokõi tapyi tembiapo rupi. Taha oĩ... nymbot tendaje ha pe X-Nymbot-Cost-Sats ñe'ẽngandu.

Oñembojoaju hag̃ua, Anthropic-pa umi mba'e oúva: message_start, content_block_start, ping, content_block_delta (text_delta, input_json_delta ha'e thinking_delta), content_block_stop, message_delta peẽ rory rehe, pe oĩva ha pe nymbot mbyju mba'e, ha message_stop. A ping oñembosẽ avei peteĩ mokõi mbyky reheve oñemba'apo jave. Tool calls oñemoambue pe tekotevẽ mboyve, opaite peteĩ mba'e upe g̃uarã tool_use mbytéicha iñe'ẽ rory opaite iñe'ẽme peteĩvépe input_json_delta.

Ko endpoint-pe mba'e iku'u ojeporu Anthropic rehecha: {"type": "error", "error": {"type": "not_found_error", "message": "…"}}. Mbojegua michĩva ha'e 402 billing_error, peteĩ provéedor oñemba'ekuaáva 503 overloaded_errorMba'e oñemboja'o umi tapicha oñepyrũramo pe stream upéi, omoĩ peteĩ error tavy.

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": "What is a Lightning invoice?"}]
  }'

Python

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": "What is a Lightning invoice?"}],
)
print(message.content[0].text)

JavaScript

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: "What is a Lightning invoice?" }],
});
console.log(message.content[0].text);

Momboy tokénte

Peteína peteĩ mba'eichaitépa Messages request oipurúta input tokens, ikatúramo peteĩ client omohenda mokõi omoĩmbajerevo. Ha'e ningo térã, ha katu oikotevẽ peteĩ key.

POST https://nymbot.ai/api/v1/messages/count_tokens — API key oñeñongatu. Amoĩ porã.

Tekove oñembojoaju oñondivepa Ñe'ẽkuéra, ndaha'éi max_tokens; modelo réra oñembohovái va'erã. Teko mbohovái ha'e peteĩ ñembosarái: pe system prompt, ñe'ẽmimirĩ, herramienta remimandu'a ha herramienta ñe'ẽmimirĩ oñembohovái mokõi pytu, ha upéicha upéicha 1,600 porẽ ambue ta'anga rupi. Ndaha'éi provider-pe oĩva tokenizer, upévare pe añetegua oĩva oñembojegua va'erã. Peteĩ llave oñembo'e va'erã haguã ha ndaikatúi oipurúva upéva.

Ñepyrũmby

{ "input_tokens": 318 }

cURL

curl https://nymbot.ai/api/v1/messages/count_tokens \
  -H "x-api-key: $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "What is a Lightning invoice?"}]
  }'

Python

import os
import anthropic

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

count = client.messages.count_tokens(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "What is a Lightning invoice?"}],
)
print(count.input_tokens)

JavaScript

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

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

const count = await client.messages.countTokens({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "What is a Lightning invoice?" }],
});
console.log(count.input_tokens);

Mohenda modelos

Mombarete ha mokõi pype API oñembojeguaáva, ihesakãramo iano'ỹréi. Ko tembiapo oñemoĩ oñeñe'ẽvoyve pe app'e apopyry rehegua, upéicha oĩ pyhareve pe upéicha oñeembopyry va'erã server-pe.

GET https://nymbot.ai/api/v1/models — ndaha'éi techapyrã. Ho'a mimbivete paite mimbichagua pype.

GET /api/v1/models/{id} ñembopyahu peteĩ mba'e.

Tembiapo hína opaite mba'e reityva'ekue, kombo'e ha marxe oĩma hiãngue, dólar ha sats-pe Bitcoin rembiapo ári. balance he'i mba'épa pe mba'e porandu oipuruháicha pe modelo. nymbot_key pe modelo'ỹ hína pe app-pe. created oĩ opaite 0, mba'ére pe catálogo ndojeréi mba'épa oñembojaipyre peteĩ môdelo. Peteĩ môdelo ndojepyhẽiva umi token rate ojejapóva, ojegua'u per_request rãngue.

nymbot/auto ha'eichaite oñepyrũmante, ojehechauka hag̃ua variable, peteĩ routes ñemongove katuete opaichagua mba'e ryre rãporã. Oñemongove visión ha reasoning, ha ndaha'éi tools.

GET /api/v1/models/{id} ojapo peteĩ mba'eicha avei opaite réra ha ñe'ẽnguéra jaerekóva peteĩ puruháicha, ha omokãvo pe mba'e ojehecháva pe modelo ndive.

Ñepyrũmby

{
  "object": "list",
  "data": [
    {
      "id": "anthropic/claude-sonnet-5",
      "object": "model",
      "type": "chat",
      "owned_by": "anthropic",
      "name": "Claude Sonnet 5",
      "created": 0,
      "context_length": 1000000,
      "max_output_tokens": 64000,
      "architecture": { "input_modalities": ["text", "image"], "output_modalities": ["text"] },
      "supported_parameters": ["max_tokens", "temperature", "tools", "tool_choice", "reasoning", "response_format", "stop"],
      "capabilities": { "vision": true, "video": false, "tools": true, "reasoning": true, "web_search": true },
      "balance": "pro",
      "pricing": {
        "type": "per_token",
        "currency": "USD",
        "input_per_1M_tokens": 4.725,
        "output_per_1M_tokens": 23.625,
        "cache_read_per_1M_tokens": 0.4725,
        "sats_input_per_1M_tokens": 4038,
        "sats_output_per_1M_tokens": 20192
      },
      "description": "...",
      "nymbot_key": "claude-sonnet"
    }
  ]
}

Tekove ambue opaichagua:

• Ta'anga ñembotapy oĩ capabilities (accepts_image_url, requires_image_url, edit) ha peteĩ tavy per_generation.
• Video ñembotapy oĩ max_duration_seconds ha resolutions, ha peteĩ mba'e purahéi per_second mba'eichaitépa opa mba'e opaichagua resolution-pe.
• Áudio ñembotapy oĩ audio_type speech ha'e transcription, ojehecha mba'eichaitépa oĩ per_1k_chars ha'e per_minute.
• Mbojerovayguasu ñembotapy oĩ dimensions, context_length, max_inputs ha peteĩ réra peteĩ mío peteĩ mbohovái input tokens-gui.

Tembipy'a oñembojerovia "estimated": true Ha'e pe app tembiapo jeneratór rehegua, hi'ã ndoje'e'ỹva. Mba'e ndojehechái. type vueltao 400.

cURL

curl "https://nymbot.ai/api/v1/models?type=chat"

Python

import requests

models = requests.get("https://nymbot.ai/api/v1/models", params={"type": "chat"}).json()["data"]
for m in models:
    print(m["id"], m["balance"], m["pricing"].get("input_per_1M_tokens"))

JavaScript

const res = await fetch("https://nymbot.ai/api/v1/models?type=chat");
const { data } = await res.json();
for (const m of data) console.log(m.id, m.balance, m.pricing.input_per_1M_tokens);