Contenido nisqaman saltay
Nymbot-man kutichiy

Yachaypa sapin Qhapaq ñan kamachikuqkunas

Rikuchikuna, uywaykunapas, imaymanakuykunapas

App nisqamanta qhapaqchaykunapas, chaymanta maskaypaq allin ruranapaqmi: rikch'aykuna, videokuna, rimaykuna, qillqasqa rimaykuna hinaspa embeddingskuna, chaykunaqa qelqaykimanmi kachkanmi huk huk pacha usata hina.

Llimp'ikunata paqarichiy

Hukmantapacha tawa rikch'akunaqa rimaymantam ruran, chaykunataqa tukusqa kaptinqa qun. Kayqa chay hina rurana kaqkunawanmi hina. ?image app nisqapi.

POST https://nymbot.ai/api/v1/images/generations — API key nisqata munan, ichaqa pachaqa huch'uy kutim pachaqa chaskiy kani.

Ids mana kachanchu GET /api/v1/models?type=image. Sapa ruwaq, @cf/black-forest-labs/flux-1-schnell, 5 standart kreyt (50 sats) nisqata qali p'anqaypi chaskin huk rikchaypaq. Paykunataqa imaymana generatorkunaqa Pro kreytkunata paykunapas imaymana chawpinpi llamk'achisqanku, k'anchaywan paypa k'anchayninwan, hinataq chaypi kaspan kay hampina yupaycha. n llamk'aykunap chaninpai 🖼️ n ñan kaspas. Generator mana chaskinqa pichaq kachkan, mana qarpaspa; paqarichiq generatorqa prompt nisqataqa charkhan.

HampiQillqayKaypaq kashanWillakuy
modelk'umpiAríHuk yachayniyoq, hinata m: nano-banana.
promptk'umpiAríImatataq qillqaytaq. Ñawpa 2,000 qillqasqa nisqallapachamta usunanchik.
nallin qalluMana1 ñukapa 4. Default 1. Chaytapas qallarin chaytaqa num_images.
sizek'umpiManaK'allpa nisqa hina "16:9", chaymantapas OpenAI hatunnin hina ukhuqa "1792x1024", chayqa chay rurina kasqanmanta kashan 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:4 hina. "auto" tukuyta yarqaypaq qun.
aspect_ratiok'umpiManaHuknin hina size, chaymantami iskayninkunataq apakun.
qualityk'umpiManaGenerator-paqllataq, hinallataq "low", "medium" dois "high".
negative_promptk'umpiManaImatataq saqinchik.
output_formatk'umpiMana"png", "jpeg" dois "webp".
response_formatk'umpiMana"url" (tukuytaq) imaymana "b64_json".
image_urlk'umpiManaHuk rikchay qallariynapaq: an https:// pacha rumiqa, imaymana 4,096 qillqasqa kashan, manam imaymana sutinmi icha hampiqninmi kanmanchu, icha... data:image/…;base64 URL (PNG, JPEG, WebP icha GIF; manan SVGchu). Qallariykunapaqmi uqariykunawan edit; chaykunata munakuqkuna hina kawsikuqkunapaqqa required by those with requires_image_url.

resolution manan utilizasunchu: huk-huk ruruchaqkuna paypaq llasata rurakun. Cunawan url, ukuynin paykunaqa Blossom public host nisqamanta churakun, chaymantataq linknin qowanki (qaqataq qhali qhali nisqakunaqa pacha linknin pachallanta qun, chaytaqa apachinku). Link nisqawan pipas qhaliypuni, chaytaqa manañam kutimuchisqachu; riquy Imatataq API rikunman?.wan b64_json llank'aypi kachkanmi chay rikch'ay chaypi kutimun, manañataq uparaykun. Rikch'ay mañachisqaqa... data: URL chaypi image_url huknin hina kiểmay kanchu allichay hinaspa Blossomman ñawpaqta chaykuy, llant'uqqa chayta qayqununpaq; hinaspas manan hampaqpi (request) mana allinchu chayqa, kutim qichuypun.

Chaykunam huk wataq... n llamk’aq kanchariq rikchaykunaqa manan allin kanchu, allin llamk’aqkunataq qowanchis, chaymantapas chaykunataqmi qarqaykusun (qallariqpaq qarqayninwan), hinaspa nymbot.failed ñanqata yachichin itaq ayqataq mana kanchu. Tukuy chayqa mana allin chayqa, sut'inqa kutimun 502.

Tarpuy

{
  "created": 1790726400,
  "model": "nano-banana",
  "cost": 0.2126,
  "data": [
    {
      "url": "https://blossom.example/5c0e4b7d3a91f2e8...c4.png",
      "content_type": "image/png"
    }
  ],
  "nymbot": { "balance": "pro", "charged_credits": 1.817, "charged_sats": 181.7, "balance_credits": 410.608, "balance_sats": 41060.8 }
}
KayninHayk'aq
400Mana imatapas nirqanchu; n qallariypaqtaq kawayninpaq 1 nisqatamanta 4 nisqaman (invalid_value); mana allin sapaq hinapas (invalid_size) chaymantapuni rikchay (invalid_image, invalid_image_url); kaqmi kachkan manañam rikch’ay ruranaq, (invalid_model); allichayta mana atiqpaq ruruna rikchaypaq (edit_unsupported); munaqpaq rikchay mana kanchu (image_required).
402Qhipaq kaqqaqaqa tukuytaqa ruriyta mana allintachu chaskinkichu.
404Mana chay sutiyuq model kanchu (model_not_found).
502Generatorqa llullunipun (upstream_error). Mana imayachataq qarqan chaytaq ispachaqa qarqusqataq mana ruraypiqa; chaymantataq huk pachaqa charged_sats.
503Llaqtaykunaqa manam kanchu kachkan ukhunpitaq (media_hosting_unavailable). b64_json Allinllam kachkan.

cURL

curl https://nymbot.ai/api/v1/images/generations \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "prompt": "A lighthouse at dusk, oil painting",
    "size": "16:9"
  }'

Python

import os
import requests

res = requests.post(
    "https://nymbot.ai/api/v1/images/generations",
    headers={"Authorization": "Bearer " + os.environ["NYMBOT_API_KEY"]},
    json={"model": "nano-banana", "prompt": "A lighthouse at dusk, oil painting", "size": "16:9"},
)
res.raise_for_status()
print(res.json()["data"][0]["url"])

JavaScript

const res = await fetch("https://nymbot.ai/api/v1/images/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.NYMBOT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ model: "nano-banana", prompt: "A lighthouse at dusk, oil painting", size: "16:9" }),
});
const body = await res.json();
console.log(body.data[0].url);

Rikchaykunata allichay

Qillqasqayki rikchayta imaynanpas kutichin, huk rimayta uschaspa. Kayqa OpenAI-pa kutichiy endpointninmi, chaymi OpenAI SDK-kunapim images.edit kay hina llamkan. Pro ruranaqkunallam yanapanqaku edit model nisqa qillqasqapi qapin.

POST https://nymbot.ai/api/v1/images/edits — API key nisqata munan, ichaqa pachaqa huch'uy kutim pachaqa chaskiy kani. Kurkuqaqa multipart/form-data, 32 MB-kama.

HampiQillqayKaypaq kashanWillakuy
imageqillqaAríAllichay allin k'ajcha: PNG, JPEG, WebP icha GIF, iskay chunka megabyte (20 MB) kachkan. Chaymantapas chayllam qayariyniy: image[]; ñawpaqqa usachakusqa kachkan.
promptk'umpiAríImatataq cambaykachun.
modelk'umpiAríYaku ruranawan masi kachkaq edit.
nallin qalluManaHukmantapacha tawa.
size
aspect_ratio
quality
negative_prompt
output_format
k'umpiManaYaku kaspaspa.
response_formatk'umpiMana"b64_json" (kaypiqa payllam) wenakama "url".

Qhali PNG, JPEG, WebP icha GIF kasqan chayta qillqasqayki kiểmini, chaymi aswan kachkanmi, hinallataq huk k'anchariy mikuypi qhipakusqa, chaymi link nisqawanmi generators nisqakuna qallarin, chaymi llapallan k'anchariy mikuypi kachkan. Kayta k'anchariy mikuypi nispa qhaway. Qhipaq sapaqchis mana allinchaspa hinallataq mana qarqaspaqa, chay qhipakusqa qillqasqa pacha k'anchariy mikuypim qhipakusqa. Kutichiyqa chay k'anchariy mikuypi hina kachkan. Chaypi qarqayqa generator nisqapa hunaqninmi, chaymi hukkunapi qillqasqa qillqasqa qarqayta mikuypi kachkan.

Tarpuy

{
  "created": 1790726460,
  "model": "nano-banana",
  "cost": 0.2126,
  "data": [{ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }],
  "nymbot": { "balance": "pro", "charged_credits": 1.817, "charged_sats": 181.7, "balance_credits": 408.791, "balance_sats": 40879.1 }
}
KayninHayk'aq
400Imaymana rikchaychu imaymana qillqasqachu manañam, huk hampitay mana rikchay mana (invalid_image), ichka qhapaqtaqmi mana allichanataq, (edit_unsupported).
413Kiwichaqaqa 20 MB nisqata lluqsimun (file_too_large), ñaqa tukuy hampariyqa 32 MB-pita asiyuq.
503Kiñayqa mana kanchu kay pacha qhapaq kanapaq (media_hosting_unavailable).

cURL

curl https://nymbot.ai/api/v1/images/edits \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -F model=nano-banana \
  -F [email protected] \
  -F prompt="Make it a snowy evening"

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("photo.png", "rb") as f:
    result = client.images.edit(model="nano-banana", image=f, prompt="Make it a snowy evening")

with open("edited.png", "wb") as out:
    out.write(base64.b64decode(result.data[0].b64_json))

JavaScript

import fs from "node:fs";
import { writeFile } 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 result = await client.images.edit({
  model: "nano-banana",
  image: fs.createReadStream("photo.png"),
  prompt: "Make it a snowy evening",
});
await writeFile("edited.png", Buffer.from(result.data[0].b64_json, "base64"));

Video

Huk videokuna pacha ch’inmi, chaymi qhipapi llamkan. Payta churanki, chaymantataq huk id ñawpaqta kutimunki, hinaspa chay id nisqata tapukunki tukuykama. Tukuy videokuna yarqay qhapaqta usuchinku.

POST https://nymbot.ai/api/v1/videos — API key nisqata munan, ichaqa pachaqa huch'uy kutim pachaqa chaskiy kani. Kutichin 202.

HampiQillqayKaypaq kashanWillakuy
modelk'umpiAríVideo ruranaqpaq id-ninmi GET /api/v1/models?type=video, hinallataq veo.
promptk'umpiAríImatataq pasachkanman.
durationnúmero icha qillqanaManaT’ika pacha, chaymanta 0-manta kachkaq, chaymantataq 60-man chayan. Chayqa generator-kunaqa qallariychisqallanmi usan, chaymanta sut’in kachkan; ñawpaqkunataqmi kawsayninpi kachkan, chayqa imataq. seconds imayraq chay kutichiypi hinaspa chay thanqa chaypi kachkan.
aspect_ratiok'umpiManaNinataq "16:9" dois "9:16"; chay hina hatun kaq "1280x720" ñawpaqman puriq nisqa ruraypim kachkan.
resolution
quality
k'umpiManaGeneratorpa huknින් resolutions modelokuna lista nisqapi, hinataq "720p" dois "1080p". Chayqa anchaqayta pacha ruran. Paymantamantaqa dekarisqa kachkan. unsupported_resolution.
image_urlk'umpiManaHuk rikchay qallariynapaq: an https:// Link imataq data:image/… URL, chayqa astawan ñawpaqtaqa public Blossom host nisqamanmi upachikuq. Generators nisqawan pacha yanapan. requires_image_url.

Qayllapi kachkan chaniyuq, qantaqmi qayllapi churanki, qhapaq kawsaymanta, llimp'iymanta, chaymanta pasaymanta, chaymi qanpa Pro hatun qullqi nisqamanta charkun qhapaqmi qallariypas, chaymantapas qhapaq kachkan chayta riqsiniypas cost, estimated_cost chaymanta nymbotManan allichaqqa llamkayta qonqayta munankuchuqa, imapipas manañam qarpunchikchu. Chaymanta renderqa mana allinchaspaqa, ichaqa tukuy kuska clipqa pakasqa mana chantaq, hinaspa allichaqqa manam qarpunchu, chayqa chay qarpayqa huk kutillam, huk kutinmi kutichikun. Huk rawra pachaqa huk samaypaqtaq pasachkan chayqa, chayqa qarpayninqa qhapaq kanqa, imaynan allichaqqa llamaqta qonqaspanraq qarpin. Kutichiyqa kawsaykunata kutichinmi, ichaqa key nisqapa qarpaynin tapuypaqtaqa manam llach'iychu.

Tukuyariq (202)

{
  "id": "vid_3e9a51c07b2f4d86e0a1c4f2",
  "object": "video",
  "model": "veo",
  "status": "in_progress",
  "created": 1790726400,
  "seconds": 8,
  "resolution": "1080p",
  "estimated_cost": 3.18,
  "expires_at": 1790812800,
  "cost": 3.18,
  "nymbot": { "balance": "pro", "charged_credits": 31.8, "charged_sats": 3180, "balance_credits": 378.808, "balance_sats": 37880.8 }
}

status qallariypaqmi in_progress, imaymana completed video nisqawan ñawpaqtaqa puriqmi data kayta k'anchay chaskiy t'ikraykuptin.

Video ñawpaqman riqsinaypaq

GET https://nymbot.ai/api/v1/videos/{id} — nisqapi qallariypi churayqa, chay qallariypi churayqan nym-paq allin kawsayta (key) munanki. Allin kawsay (key) tukuyta chayasqanpas, qelqayta riqsispa allin kachkan.

Qispichkan 202 video rurakachkaniypas hinaspa 200 tukuykuspa icha mana allinchaspaqa. 5 icha 10 segundokunapi pitarillata tapuy. Kaypiqa, ñawpaqman qunqaytaqa kutichiykun, mana kutichiyta sayaykunichu; mana videota qawanmanchu. Huk llank'ayqa 24 uraypi kachkan qelqasqa kasqanmanta. GET /api/v1/videos llistay killaqaqaqa 50 ukhun kaq ayllanta as... {"object": "list", "data": […]}.

Tarpuykiy (200)

{
  "id": "vid_3e9a51c07b2f4d86e0a1c4f2",
  "object": "video",
  "model": "veo",
  "status": "completed",
  "created": 1790726400,
  "seconds": 8,
  "resolution": "1080p",
  "estimated_cost": 3.18,
  "expires_at": 1790812800,
  "completed_at": 1790726590,
  "data": { "url": "https://blossom.example/9b41d0c2e7a3f658...1e.mp4", "content_type": "video/mp4" },
  "cost": 3.18,
  "nymbot": { "balance": "pro", "charged_credits": 31.8, "charged_sats": 3180 }
}

status kaymi in_progress, completed dois failed. A mana allichasqa llamkaymi apan error ({"code": "generation_failed", "message": …}); pisqa kutichisqa kaspan, cost qaqancha 0 chay munanakuytaq nymbot añunkuna refunded_credits chaymanta refunded_satsLluqsiyuq videokunaqa public Blossom hostpi kashan, chay hina riqsichisqa llimp'ikuna hina.

KayninHayk'aq
400Mana imatapas ninqay; 0 masiquta 60 masiquta chiqhiypa qhipanpuni (invalid_value); chaypaqqa imaymana ruraytaqa chay yarqayqa manan quncanchu (unsupported_resolution); mana imaymana qillqasqa kanchu chay generatorpaqmi, chaytaqa qillqasqa kanmanqa (image_required); mana video rurana model kaq (invalid_model).
402Pro pachaqa videota tapuy mana atinmanchu.
404Mana chayta rurana imaymanaqa (model_not_found), chay sutiyuqpaq llamkanqayniyuqchu manam, ichaqa aswanqa 24 p'unchay kashanmi (video_not_found).
429Sapaq ninky qallarin 10 videokunata kachaykamuspa (video_jobs_limit). Paykunata rikuriy hinallataq hukmi tukuspan aswanmi churakuy.
502Llamkayta qallariqqa mana ruwarqanchu. Mana imatapas pagachinqachu, manan qatunqa qarqan chayqa.
503Video-kunaqa ama pacha apananchu icha takichananchu (media_hosting_unavailable, service_unavailable).

cURL

curl https://nymbot.ai/api/v1/videos \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "veo", "prompt": "Waves rolling onto a beach at sunrise", "duration": 8, "aspect_ratio": "16:9"}'

curl https://nymbot.ai/api/v1/videos/vid_3e9a51c07b2f4d86 \
  -H "Authorization: Bearer $NYMBOT_API_KEY"

Python

import os, time
import requests

headers = {"Authorization": "Bearer " + os.environ["NYMBOT_API_KEY"]}

job = requests.post(
    "https://nymbot.ai/api/v1/videos",
    headers=headers,
    json={"model": "veo", "prompt": "Waves rolling onto a beach at sunrise", "duration": 8, "aspect_ratio": "16:9"},
).json()

while True:
    time.sleep(8)
    status = requests.get("https://nymbot.ai/api/v1/videos/" + job["id"], headers=headers).json()
    if status["status"] in ("completed", "failed"):
        break

print(status["data"]["url"] if status["status"] == "completed" else status["error"])

JavaScript

const headers = {
  "Authorization": "Bearer " + process.env.NYMBOT_API_KEY,
  "Content-Type": "application/json",
};

const job = await (await fetch("https://nymbot.ai/api/v1/videos", {
  method: "POST",
  headers,
  body: JSON.stringify({ model: "veo", prompt: "Waves rolling onto a beach at sunrise", duration: 8, aspect_ratio: "16:9" }),
})).json();

let status;
do {
  await new Promise((r) => setTimeout(r, 8000));
  status = await (await fetch("https://nymbot.ai/api/v1/videos/" + job.id, { headers })).json();
} while (status.status !== "completed" && status.status !== "failed");

console.log(status.status === "completed" ? status.data.url : status.error);

Rimayta qillqasqamanta uyariy munaq kay

Qillqatam uyarichin hinallataq audio nisqata kutichin, link manam. OpenAI-pa rimay nisqanmi, chaymi audio.speech.create OpenAI SDK-kunapi llamkan.

POST https://nymbot.ai/api/v1/audio/speech — API key nisqata munan, ichaqa pachaqa huch'uy kutim pachaqa chaskiy kani.

HampiQillqayKaypaq kashanWillakuy
modelk'umpiManaRimayta yachaq model mana... Audio modelokunaq qillqasqan. Qallari: ch'aqwa rimay, @cf/myshell-ai/melotts. aura-2 ¿Deepgram Aura 2 kanchu?
inputk'umpiAríÑawarinan qillqa: allin rimaypaqqa 800 qillqas chaynapi, Aura 2paqqa 2,000.
voicek'umpiManaRimay ruraqpa imaymana ñawin mana... rimaykuna qillqana: Aura ruruna hinallataq luna (mana aura-2-luna-en), imaymana MeloTTS simi (en, es, fr, zh). OpenAI rimay sutikuna hinatiyuq alloy kichaykusqa kachkan, chaymantapas ruran chay modelo rupaq rimayta.
languagek'umpiManaHuk simi qelqay hina ukhunla esRimay mana kaspapas, chay qallu simipi rimayta akllan. Huk huk simita rimasqapas, kutimun. 422 voice_language_mismatch, hinaspa rimay runataq chay modeloqa mana rimayta atisqanchispas 422 unsupported_language.
response_formatk'umpiManaRimay ñawpaqqa kutimun mp3 Chayllapacha. Aura 2 kutimun. mp3 (kay kachkan), opus, aac, flac, wav dois pcm.
speednúmeroManaQillqasqa kachkan, manataq yuyaychasqachu.

Paqarinkunapaq rimasqaykiqa huk kimsan ruraypi (30 sats) chay ruraykunawanmi, app nisqapi hina. Aura 2qa Promi, qampa qillqasqaykichikmantam chaninchakuq. Kutichisqaykiqa audiomi, chaywan nisqawan hina Content-Type; anqasqaqa chaypi X-Nymbot-Cost-Sats header. Simi ruray yachayqa mana allin ruraspataq, manam imatapas qunqaykuypaq chaychu.

Tarpuy

HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-Nymbot-Cost-Sats: 4.2
X-Nymbot-Balance-Sats: 41055.6

(audio bytes)
KayninHayk'aq
400Mana imapas manam; imaymana kaqmi modelpa mikhunapi (input_too_long); allin k'uypa manan rurachinmanchu k'umuyta (unsupported_response_format); amqasqa rimay (invalid_voice); rimay hampiq mana kasqan model (invalid_model).
422Rimayqa qatiq sutichasqa qelqayta mana rimanchu, icha chay modeloqa manam chay rimayta rimasqan chunachu.
502Rimay modeloqa mana llamk'arqanchu. Manan imatapas qarqaykurqanchu.

cURL

curl https://nymbot.ai/api/v1/audio/speech \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "aura-2", "voice": "luna", "input": "Your invoice has been paid."}' \
  --output speech.mp3

Python

import os
from openai import OpenAI

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

audio = client.audio.speech.create(
    model="aura-2",
    voice="luna",
    input="Your invoice has been paid.",
)
audio.write_to_file("speech.mp3")

JavaScript

import { writeFile } 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 audio = await client.audio.speech.create({
  model: "aura-2",
  voice: "luna",
  input: "Your invoice has been paid.",
});
await writeFile("speech.mp3", Buffer.from(await audio.arrayBuffer()));

Audio modelo-kuna imaymanaykunapas

Rimayta sapaqtaq ruraq modelta ima, simita ima, icha qelqayta ruraq modelta ima akllaypaqqa iskayllapi p’unchaykunapi kachkan. Paykunapi 41 Aura 2 English rimayniyuqkunam kachkan hinaspa tawa MeloTTS simikunapas kachkan.

GET https://nymbot.ai/api/v1/audio/models — manam k’anchayta munanchu.

GET https://nymbot.ai/api/v1/audio/voices?language=en — manam k’anchayta munanchu.

HampiQillqayKaypaq kashanWillakuy
languageqispichiy (tapuy)ManaKay qallariypaqqa rimaykunallam.
modelqispichiy (tapuy)ManaKay modeloqa rimaykunallampaqmi.

Tinkuy (rimaykuna)

{
  "object": "list",
  "data": [
    { "id": "luna", "name": "Luna", "provider": "deepgram", "model_id": "aura-2", "models": ["aura-2"], "language": "en", "description": "Aura 2 English voice", "gender": "female", "preview_url": null },
    { "id": "en", "name": "MeloTTS English", "provider": "myshell", "model_id": "@cf/myshell-ai/melotts", "models": ["@cf/myshell-ai/melotts", "melotts"], "language": "en", "description": "English (MeloTTS)", "gender": null, "preview_url": null }
  ]
}

Modelo unanchaykunap sutinqa kutichikunmi {"object": "list", "data": {"tts": […], "stt": […]}}. Imaymana rimay yachay nisqaykunaqa k'anchayninmanta, urayninmanta, hinaspa allin kayninmanta willakunku, max_input_chars, response_formats, languages chaymanta default_voice; qillqayta yachaq kaqmi sutinkunata qun, max_file_bytes, max_seconds, kachaykunapas huk minutu nisqapi qayninapas.

cURL

curl https://nymbot.ai/api/v1/audio/models
curl "https://nymbot.ai/api/v1/audio/voices?language=en"

Python

import requests

print(requests.get("https://nymbot.ai/api/v1/audio/models").json())
for voice in requests.get("https://nymbot.ai/api/v1/audio/voices", params={"language": "en"}).json()["data"]:
    print(voice["id"], voice["model_id"])

JavaScript

console.log(await (await fetch("https://nymbot.ai/api/v1/audio/models")).json());
const voices = await (await fetch("https://nymbot.ai/api/v1/audio/voices?language=en")).json();
for (const v of voices.data) console.log(v.id, v.model_id);

Rimaykunata qillqayman kutichiy

Whisper nisqapi uyarikuynintata qillqata kutichin. Kayqa OpenAI-pa qillqayachiy endpointninmi, chaymi audio.transcriptions.create llank’an.

POST https://nymbot.ai/api/v1/audio/transcriptions — API key nisqata munan, ichaqa pachaqa huch'uy kutim pachaqa chaskiy kani. Kurkuqaqa multipart/form-data.

HampiQillqayKaypaq kashanWillakuy
fileqillqaAríQillqasqa, 256 bytes-manta 25 MB-man chaymanta 30 minutu kachkaptinpas: WAV, WebM, MP4 chaymanta M4A, Ogg chaymanta Opus, MP3 hinaspa Whisper ñawinchin ñanpa nisqakunapas. MP3 hinaspa chay ñanpa sutinqa ñawpaqta mana ninmanchu, chaykunapas 1.8 MB-llapi kachkan.
modelk'umpiManaChay kachkanqa whisper, chayqa Whisper Large v3 Turbo kashan. whisper-1, whisper-large-v3-turbo chaymanta @cf/openai/whisper-large-v3-turbo imaynanmi kashan.
languagek'umpiManaSimi rimay, hinallataq en. Qhipata qhipataq kaytapas riqsisqa kanman.
promptk'umpiManaSutakuna hina, qillqasqankunataq rurayta mosqayta qallarinqaku. Ñawpaq chunka pachak qillqasqallapachami usqhayta hark'ayku.
response_formatk'umpiManajson (kay kachkan), text, srt, vtt dois verbose_json.

WAV, WebM, MP4 wan Ogg willaykunapaqqa, chaypa sutinpaq kaqniyqa willaykunapaqqa qallariypaqtaqa ñawpaqtaqa qillqasqa kán, chaymi asita qhapaq kayqa 30 minutu machaytaqa quska manañam allowachin (3 segundo qhapaq kaywan). WAV willaykunapaqqa chaypa kaqniyqa chaypa sample rate-ninmanta, channels-manta, chaywanpas sample size-manta hamun. Paykunapas MP3 hina hinapas, chaykunapaqqa qallariypaqtaqa manam ñawpaqtaqa qillqasqaku, chaymi chaypa hatun kayninmantaqa limitasqa kanku: pachaqa chhayna bitrate nisqapi, 8 kbps, 30 minutuqa 1.8 MB kán, chaymanta chay hina willaykunapi hatun kaqqa quska manam allowachin. 413 audio_too_long pachakamaqmi. Chaymantapasqa, qisqasqata WAV, WebM, MP4 icha Ogg nisqapi qillqasqata apachiy. Chaynapaqqa Whisperqa aswanqa aska kachkan chayta nirun, chayrayku mañakuyqa qichuy kachkan: 413 audio_too_long, hinallataq Whisper rurarqanmi, 30 minutos pagapanki.

Audiopa sut'inmanta qarq'asqa, huk pikunata chayamunata allichaspa qali: archivo nisqamanta ñawinchasqa sut'in, Whisper nisqapa sut'in, hinaspa archivo nisqap sut'inpa chikitanta, Whisper nisqapa huk minutu nisqapi chālliq kanmanta hayaq k'anchaywan hinaspa hukkuna nisqawan, hinaspa huk sut'iqa 0.05 creditomanta, huk sut'iqa. Chayqa chayta allichan chaypi kashan chaypas, Pro nisqapi otherwise; a 402 qaynaqa imakunataq munankun, app nisqapi, rimay nisqa qelqanapaqqa mayt'aq kanman; API nisqapiqa chikaypaqmi. Whisper mana allinchaspaqa, manan imatapas chikaychu.

Tarpuy

{
  "text": "Your invoice has been paid.",
  "usage": { "type": "duration", "seconds": 3 },
  "nymbot": { "balance": "standard", "charged_credits": 0.05, "charged_sats": 0.5, "balance_credits": 120.35, "balance_sats": 1203.5 }
}

text kayta qillqasqata kutichin, srt chaymanta vtt qhipanqaykunata kutichiy, chaymanta verbose_json ñawpaq kawsayta, tempus chhayta ima, hinallataq pacha t’ikraykuna apamun. JSON mana kasqan hina kimsanpaqqa, chaninqa uñanpi kachkan.

KayninHayk'aq
400Manam archivo kanchu, archivo mana usukuna qelqaywan (invalid_audio), amqasqan nisqayuq, icha manam qillqasqata qillqanapaq kaq modelchu (invalid_model).
402Mana chayninpas qullqi nisqayuqqa manan tapuchinmanchu.
413Qillqaqa 25 MB-pita aswanmi (file_too_large) chayqa huk wataqa iskay chunka minutu nisqamanta aswan, ichaqa manañam chaypa sutinqa ñawpaqta riqsimunqachu chaytaqa manan yachasunchu, iskay chunkaqa pikunmanta aswan (audio_too_long).
502Whisperqa audio nisqata manan llik'ispa atisarqanchu. Imapas manam qarqanachu.

cURL

curl https://nymbot.ai/api/v1/audio/transcriptions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -F [email protected] \
  -F model=whisper \
  -F response_format=json

Python

import os
from openai import OpenAI

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

with open("memo.m4a", "rb") as f:
    transcript = client.audio.transcriptions.create(model="whisper", file=f)
print(transcript.text)

JavaScript

import fs from "node:fs";
import OpenAI from "openai";

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

const transcript = await client.audio.transcriptions.create({
  model: "whisper",
  file: fs.createReadStream("memo.m4a"),
});
console.log(transcript.text);

Rimaykunata Inglés simiman t'ikray

POST https://nymbot.ai/api/v1/audio/translations — API key nisqata munan, ichaqa pachaqa huch'uy kutim pachaqa chaskiy kani. Kurkuqaqa multipart/form-data.

Qallariy hina, chaynanmi lliwtapas kachkan chaykunaqa apasqa kanchaymanta lluqsispaqa language, sapaqninmanta hinaspa hinqayninmanta, ichaqa simiqa English-llapi kutimunmi imaymana simipasqapi kasqapas. OpenAI SDK-kunaqa kayta sutichinku audio.translations.create.

cURL

curl https://nymbot.ai/api/v1/audio/translations \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -F [email protected] \
  -F model=whisper

Python

import os
from openai import OpenAI

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

with open("nota.m4a", "rb") as f:
    translation = client.audio.translations.create(model="whisper", file=f)
print(translation.text)

JavaScript

import fs from "node:fs";
import OpenAI from "openai";

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

const translation = await client.audio.translations.create({
  model: "whisper",
  file: fs.createReadStream("nota.m4a"),
});
console.log(translation.text);

Kaypi kachkan riqsisqa kawsayniyuq ukhu ukhuypaqmi

Qillqata vectornakuqmi pakasqa mask'ay, kuska t'aqasqa hinallataq pasasqa kachunpaq. Modeloqkuna Cloudflare nisqapi llamk'anku hinallataq qelqasqallan pacha llamk'ayta usun.

POST https://nymbot.ai/api/v1/embeddings — API key nisqata munan, ichaqa pachaqa huch'uy kutim pachaqa chaskiy kani.

HampiQillqayKaypaq kashanWillakuy
modelk'umpiAríHuk embedding modelo mana qallariypaqtaqa GET /api/v1/models?type=embedding.
inputrimay nisqa icha rimaykunap unayninAríHukpi ruranapaq qillqasqa, chunka pichqa (100) mana hukllachu qillqasqa rimaykunaqkama. Token tukukuqkunataqa manam qallpariychu (token_input_unsupported). Kayninmi entradaqa modelo nisqapi kachkan chayta allichan아야. context_length, chayqa huk pataq bytes nisqata nisqatami huq token nispa tapuwan.
encoding_formatk'umpiManafloat (tukuytaq) imaymana base64 (kichu-pacha 32-bit floats).
dimensionsallin qalluManaModelpaq sapaq hatun kaynin, imaymana modelwan... supported_dimensions chaykunam ñuqaqpa; chaymanta vector nisqata qispiychispa hinaspa allichisunchik. Chaymanta otherwiseqa manam qhawaychu.
WillayLlaqtakunaKaypa huk kaqtaqqa
@cf/baai/bge-m3Waranqa iskay chunka tawa, asqa simikuna8,192 tokénkuna
@cf/qwen/qwen3-embedding-0.6bWaranqa iskay chunka tawa, asqa simikuna8,192 tokénkuna
@cf/baai/bge-large-en-v1.51024, Inglés512 tokens
@cf/baai/bge-base-en-v1.5768, English512 tokens
@cf/baai/bge-small-en-v1.5384, Inglés512 tokens

Modelokunapa listanqa imaynan kachkanpas imaynan chalanpas chayta riqsispaqpaqmi; Googlepa EmbeddingGemma nisqanqa, munakuyninkunapi aswan huch'uy vectorkunawan, chaypi kachkanpas manam catalog chalan nisqata qonchispaq. Embeddingskunapas imayna qallariq token nisqawanmi sapa kutim chayarin, hinaspa 0.05-credit nisqanqa sapa kutim, manam sapa qallariq nisqapaqchu, chaymi hawata qillqasqakunata sapa kutiman huñuchispaqa aswan huch'uy chalanmi, sapa kutita huk-huk sapaqta kutichiykunataqa.

Tarpuy

{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.0213, -0.0487, 0.0112] }
  ],
  "model": "@cf/baai/bge-m3",
  "usage": { "prompt_tokens": 9, "total_tokens": 9 },
  "nymbot": { "balance": "standard", "charged_credits": 0.05, "charged_sats": 0.5, "balance_credits": 1204.35, "balance_sats": 12043.5 }
}
KayninHayk'aq
400Mananmi hayk'aqmi icha qullqi; token rimaykuna (token_input_unsupported); aswanqa 100 nisqakunataq (too_many_inputs); rimasqam rurasqamanta aswan hatunmi (input_too_long); chay hatun kaqtaqa modeloqa manan apachiyta atinanchu (unsupported_dimensions).
402Sapaq phullayqa ancha chinkachkan. Embeddingsqa manapas Pro phullayta usachinchu.
404Chay sutiyuq embedding modeloqa manan kanchu.
502Modeloqa mana rurachkaptu. Manam imapas kutichikunanchu.

cURL

curl https://nymbot.ai/api/v1/embeddings \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "@cf/baai/bge-m3", "input": ["Lightning invoices expire.", "Invoices on Lightning have a time limit."]}'

Python

import os
from openai import OpenAI

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

result = client.embeddings.create(
    model="@cf/baai/bge-m3",
    input=["Lightning invoices expire.", "Invoices on Lightning have a time limit."],
)
print(len(result.data), len(result.data[0].embedding))

JavaScript

import OpenAI from "openai";

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

const result = await client.embeddings.create({
  model: "@cf/baai/bge-m3",
  input: ["Lightning invoices expire.", "Invoices on Lightning have a time limit."],
});
console.log(result.data.length, result.data[0].embedding.length);