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.
Kay p'anqaqa makinawan tikrasqa kachkan, allin kananpaq. Inglés simipi original nisqataqmi chaypaq 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.
| Hampi | Qillqay | Kaypaq kashan | Willakuy |
|---|---|---|---|
model | k'umpi | Arí | Huk yachayniyoq, hinata m: nano-banana. |
prompt | k'umpi | Arí | Imatataq qillqaytaq. Ñawpa 2,000 qillqasqa nisqallapachamta usunanchik. |
n | allin qallu | Mana | 1 ñukapa 4. Default 1. Chaytapas qallarin chaytaqa num_images. |
size | k'umpi | Mana | K'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_ratio | k'umpi | Mana | Huknin hina size, chaymantami iskayninkunataq apakun. |
quality | k'umpi | Mana | Generator-paqllataq, hinallataq "low", "medium" dois "high". |
negative_prompt | k'umpi | Mana | Imatataq saqinchik. |
output_format | k'umpi | Mana | "png", "jpeg" dois "webp". |
response_format | k'umpi | Mana | "url" (tukuytaq) imaymana "b64_json". |
image_url | k'umpi | Mana | Huk 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 }
}
| Kaynin | Hayk'aq |
|---|---|
400 | Mana 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). |
402 | Qhipaq kaqqaqaqa tukuytaqa ruriyta mana allintachu chaskinkichu. |
404 | Mana chay sutiyuq model kanchu (model_not_found). |
502 | Generatorqa llullunipun (upstream_error). Mana imayachataq qarqan chaytaq ispachaqa qarqusqataq mana ruraypiqa; chaymantataq huk pachaqa charged_sats. |
503 | Llaqtaykunaqa 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.
| Hampi | Qillqay | Kaypaq kashan | Willakuy |
|---|---|---|---|
image | qillqa | Arí | Allichay allin k'ajcha: PNG, JPEG, WebP icha GIF, iskay chunka megabyte (20 MB) kachkan. Chaymantapas chayllam qayariyniy: image[]; ñawpaqqa usachakusqa kachkan. |
prompt | k'umpi | Arí | Imatataq cambaykachun. |
model | k'umpi | Arí | Yaku ruranawan masi kachkaq edit. |
n | allin qallu | Mana | Hukmantapacha tawa. |
sizeaspect_ratioqualitynegative_promptoutput_format | k'umpi | Mana | Yaku kaspaspa. |
response_format | k'umpi | Mana | "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 }
}
| Kaynin | Hayk'aq |
|---|---|
400 | Imaymana rikchaychu imaymana qillqasqachu manañam, huk hampitay mana rikchay mana (invalid_image), ichka qhapaqtaqmi mana allichanataq, (edit_unsupported). |
413 | Kiwichaqaqa 20 MB nisqata lluqsimun (file_too_large), ñaqa tukuy hampariyqa 32 MB-pita asiyuq. |
503 | Kiñ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.
| Hampi | Qillqay | Kaypaq kashan | Willakuy |
|---|---|---|---|
model | k'umpi | Arí | Video ruranaqpaq id-ninmi GET /api/v1/models?type=video, hinallataq veo. |
prompt | k'umpi | Arí | Imatataq pasachkanman. |
duration | número icha qillqana | Mana | T’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_ratio | k'umpi | Mana | Ninataq "16:9" dois "9:16"; chay hina hatun kaq "1280x720" ñawpaqman puriq nisqa ruraypim kachkan. |
resolutionquality | k'umpi | Mana | Generatorpa huknින් resolutions modelokuna lista nisqapi, hinataq "720p" dois "1080p". Chayqa anchaqayta pacha ruran. Paymantamantaqa dekarisqa kachkan. unsupported_resolution. |
image_url | k'umpi | Mana | Huk 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.
| Kaynin | Hayk'aq |
|---|---|
400 | Mana 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). |
402 | Pro pachaqa videota tapuy mana atinmanchu. |
404 | Mana chayta rurana imaymanaqa (model_not_found), chay sutiyuqpaq llamkanqayniyuqchu manam, ichaqa aswanqa 24 p'unchay kashanmi (video_not_found). |
429 | Sapaq ninky qallarin 10 videokunata kachaykamuspa (video_jobs_limit). Paykunata rikuriy hinallataq hukmi tukuspan aswanmi churakuy. |
502 | Llamkayta qallariqqa mana ruwarqanchu. Mana imatapas pagachinqachu, manan qatunqa qarqan chayqa. |
503 | Video-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.
| Hampi | Qillqay | Kaypaq kashan | Willakuy |
|---|---|---|---|
model | k'umpi | Mana | Rimayta yachaq model mana... Audio modelokunaq qillqasqan. Qallari: ch'aqwa rimay, @cf/myshell-ai/melotts. aura-2 ¿Deepgram Aura 2 kanchu? |
input | k'umpi | Arí | Ñawarinan qillqa: allin rimaypaqqa 800 qillqas chaynapi, Aura 2paqqa 2,000. |
voice | k'umpi | Mana | Rimay 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. |
language | k'umpi | Mana | Huk 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_format | k'umpi | Mana | Rimay ñawpaqqa kutimun mp3 Chayllapacha. Aura 2 kutimun. mp3 (kay kachkan), opus, aac, flac, wav dois pcm. |
speed | número | Mana | Qillqasqa 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[0m 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)
| Kaynin | Hayk'aq |
|---|---|
400 | Mana 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). |
422 | Rimayqa qatiq sutichasqa qelqayta mana rimanchu, icha chay modeloqa manam chay rimayta rimasqan chunachu. |
502 | Rimay 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.
| Hampi | Qillqay | Kaypaq kashan | Willakuy |
|---|---|---|---|
language | qispichiy (tapuy) | Mana | Kay qallariypaqqa rimaykunallam. |
model | qispichiy (tapuy) | Mana | Kay 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.
| Hampi | Qillqay | Kaypaq kashan | Willakuy |
|---|---|---|---|
file | qillqa | Arí | 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. |
model | k'umpi | Mana | Chay kachkanqa whisper, chayqa Whisper Large v3 Turbo kashan. whisper-1, whisper-large-v3-turbo chaymanta @cf/openai/whisper-large-v3-turbo imaynanmi kashan. |
language | k'umpi | Mana | Simi rimay, hinallataq en. Qhipata qhipataq kaytapas riqsisqa kanman. |
prompt | k'umpi | Mana | Sutakuna hina, qillqasqankunataq rurayta mosqayta qallarinqaku. Ñawpaq chunka pachak qillqasqallapachami usqhayta hark'ayku. |
response_format | k'umpi | Mana | json (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.
| Kaynin | Hayk'aq |
|---|---|
400 | Manam archivo kanchu, archivo mana usukuna qelqaywan (invalid_audio), amqasqan nisqayuq, icha manam qillqasqata qillqanapaq kaq modelchu (invalid_model). |
402 | Mana chayninpas qullqi nisqayuqqa manan tapuchinmanchu. |
413 | Qillqaqa 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). |
502 | Whisperqa 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.
| Hampi | Qillqay | Kaypaq kashan | Willakuy |
|---|---|---|---|
model | k'umpi | Arí | Huk embedding modelo mana qallariypaqtaqa GET /api/v1/models?type=embedding. |
input | rimay nisqa icha rimaykunap unaynin | Arí | 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_format | k'umpi | Mana | float (tukuytaq) imaymana base64 (kichu-pacha 32-bit floats). |
dimensions | allin qallu | Mana | Modelpaq sapaq hatun kaynin, imaymana modelwan... supported_dimensions chaykunam ñuqaqpa; chaymanta vector nisqata qispiychispa hinaspa allichisunchik. Chaymanta otherwiseqa manam qhawaychu. |
| Willay | Llaqtakuna | Kaypa huk kaqtaqqa |
|---|---|---|
@cf/baai/bge-m3 | Waranqa iskay chunka tawa, asqa simikuna | 8,192 tokénkuna |
@cf/qwen/qwen3-embedding-0.6b | Waranqa iskay chunka tawa, asqa simikuna | 8,192 tokénkuna |
@cf/baai/bge-large-en-v1.5 | 1024, Inglés | 512 tokens |
@cf/baai/bge-base-en-v1.5 | 768, English | 512 tokens |
@cf/baai/bge-small-en-v1.5 | 384, Inglés | 512 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 }
}
| Kaynin | Hayk'aq |
|---|---|
400 | Mananmi 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). |
402 | Sapaq phullayqa ancha chinkachkan. Embeddingsqa manapas Pro phullayta usachinchu. |
404 | Chay sutiyuq embedding modeloqa manan kanchu. |
502 | Modeloqa 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);