Arandupykuaaty ñemopyenda Mba'apohára kuéra
Ta'anga, áudio ha embeddings
App-pe oĩva generator-kuéra, ha opaite mba'e oñemopu'ãva oheka hag̃ua: ta'anga, video, ñe'ẽ, transcription ha embeddings, opaite reipuru reheve oñembo'y ne rembiapo kuatia reheve.
Ko páhina oñembohasa máquina-pe iporãve hag̃ua. Pe inglés original ha’e pe versión ojeporúva.
Ta'angue umi ta'anga
Mbo'ehaipykuéra haipyre mbo'ehaipyre mimbipa haguã peteĩ hag̃ua upéicha upéicha mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre mbo'ehaipyre m ?image tepyrupe.
POST https://nymbot.ai/api/v1/images/generations — oñemohenda API key, térã Pe katuete Lightning rembipetẽ peteĩ jerure reheve.
Ids oúva GET /api/v1/models?type=imagePe mbohe'áva mbojoaju,
@cf/black-forest-labs/flux-1-schnell, 5 standard credits (50 sats) oipytyvô
ta’ãmbue mba’érepa peteĩ ta’anga. Pe ambue jepurúva oipytyvô Pro credits iñe’ẽme, iresẽ ha iñe’ẽme,
icha pe... tepy mbytépe. n tapa rupa'ã mba'eichaitépa ojehecha
n hetave avei. Peteĩ mba'e ndojepurúi va'erã genérata, oñembesãnte ndaha'éi ñembojegueraha haguére; genérata opaite la prua (prompt)nte oipuru.
| Koku | Eñe'ẽ | Ñembo'e va'erã | Ñe'ẽmbotyry |
|---|---|---|---|
model | puku ñembyaty | heẽ | Tekove rãmba'apóva, haicha tetã oje'ẽva nano-banana. |
prompt | puku ñembyaty | heẽ | Mba'épa oñemonga. Ha'e pe katupyry ambue mbytére ojeipuru haguáicha. |
n | inteyéras | Nahániri | 1 peẽme 4. Default 1. Upéicha avei oñembojoaju haguére num_images. |
size | puku ñembyaty | Nahániri | Pete mba'e haipyreicha upeicha guarani "16:9", térã peteĩ OpenAI mba'eita haipéicha "1792x1024", ha'e pe oĩva oñemoĩvéva 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:4 ha 4:5 rehe. "auto" hej'u upe ñembohoryramo. |
aspect_ratio | puku ñembyaty | Nahániri | Imésme peve size, ha oĩ porãme oñembosaráivo mokõive. |
quality | puku ñembyaty | Nahániri | Mbohovái-pype, haipóruicha "low", "medium" ha'e "high". |
negative_prompt | puku ñembyaty | Nahániri | Mba'e reitypa. |
output_format | puku ñembyaty | Nahániri | "png", "jpeg" ha'e "webp". |
response_format | puku ñembyaty | Nahániri | "url" (pe oñembojeguaáva) térã "b64_json". |
image_url | puku ñembyaty | Nahániri | Ta'anga ñembopyry hag̃ua: peteĩ https:// pote 4,096 caracter kuérare, ndaha'éi umi mba'eichagua ryre térã mba'eichagua, térã peteĩ data:image/…;base64 URL (PNG, JPEG, WebP térã GIF; ndaha'éi SVG). Ha'eete generator kuérape upeve upeve edit; oñangareko va'erã umi oĩva ndive requires_image_url. |
resolution ndajereverói: opaite ta'anga ipu'ũ iñe'ẽ porã: Kuarahy avei urlta'anga opaite oñemoĩ Blossom host rupive oĩva opaitepe g̃uarã ha reityry rehesáta i-link (mba'e hetaite generator-nte ohechauka i-link ha'e hikuái, ha ojeipuru). Opaite kuéra oĩva link rupive ikatu oity iñe'ẽ ha ndaikatúi oñemomosãva mboyve; ehecha mba'épa pe API ohechandive
b64_json tekomi oñembojerovia pe mbojegua rupive ha ndaikatúi oñemomombo. Peteĩ ta'anga
ojapóva peteĩ data: URL upéicha image_url oñeha'ã ha'éicha peteĩ
embohovái ha upetã Blossom-pe mokõive, upéicha pe generator oñembohorýva;
ha oñemombaretéva upéi, pe mbohovái ndojapoichẽramo.
Upéicha ikatúramo peicha n ta'anga oñemboja, nde reikotevẽ umi oĩ porãnte, reñemoneĩ umi katuante (ha avei umi provider oñemoneĩ haguã oñemboja haguãnte), ha nymbot.failed he'i mba'éichapa
kuatia ha'eveva. Pe oñembo'e oñe'ẽramo opaite, pe peteĩ ñe'ẽ oñe'ẽve. 502.
Ñepyrũmby
{
"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 }
}
| Teko'o | Moõpa |
|---|---|
400 | Ndaipóri prompt; n peteĩnte upéva upéicha 4 peve (invalid_value); mba'eichaitépa oĩ (invalid_size) térã ta'anga (invalid_image, invalid_image_url); peteĩ môdelo oĩva ha ndaha'éi ta'anga ra'u (invalid_model); ta'anga mbo'eháicha ndaikatúi moñe'ẽmboyve rehe (edit_unsupported); ndaha'éi kuatia mba'éichapa oĩ upe oikotevẽva (image_required). |
402 | Pe mba'e oĩva ndaikatúi mohenda opaite ta'anga oñe'ẽva. |
404 | Oĩramo nderehevéva réra ndaha'éi modelo ᵞmodel_not_found). |
502 | Pe mbo'ehao oñemondýi (upstream_errorNdaja'ei mba'eve oĩramo upe provider oñemoĩvo pe ñeha'ã; upéi pe mba'eicha oñembyasy... charged_sats. |
503 | Ta'anga ndaikatúi oñeñongatu ko'ágã (media_hosting_unavailable). b64_json Oñemohendaite. |
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);
Ta'anga rembohovái
Omoĩ peteĩ ta'anga reityka hag̃ua peteĩ tembiapo. Ko'ápe OpenAI-re oĩ ko edit endpoint, upéicha OpenAI
SDKs' images.edit oñemba'apóvo upéicha avei. Áraite Pro generadores ndive edit modelo mbojegua rehegua
eipota chupe.
POST https://nymbot.ai/api/v1/images/edits — oñemohenda API key, térã Pe katuete Lightning rembipetẽ peteĩ jerure reheveTetã ha'e multipart/form-data, peve 32 MB.
| Koku | Eñe'ẽ | Ñembo'e va'erã | Ñe'ẽmbotyry |
|---|---|---|---|
image | tapyra | heẽ | Pe tapicha oñembojeguaáva: PNG, JPEG, WebP térã GIF, upéicha 20 MB-peve. Oñeandu avei hag̃ua image[]; pe tapỹi ambue oñe'ẽva ojeipuru. |
prompt | puku ñembyaty | heẽ | Mba'épa oñembohytáva. |
model | puku ñembyaty | heẽ | Mbo'ehao peteĩ generator ndive edit. |
n | inteyéras | Nahániri | Peteĩ pe irundy. |
sizeaspect_ratioqualitynegative_promptoutput_format | puku ñembyaty | Nahániri | Mbojoaju rehe. |
response_format | puku ñembyaty | Nahániri | "b64_json" (oĩva upépe) térã "url". |
Pe eñeñombyryta eñeñombyryvo ojehecha ha'e hína peteĩ PNG, JPEG, WebP térã GIF iporãva, oñembojoaju iñe'ẽme, ha oĩ peteĩ Blossom host oñembosako'i hag̃ua, upéicha piko umi generador oheka iñe'ẽ rupive. Eñe'ẽ chéve peteĩ mba'e oñembohoryva. Ko'ãg̃are oñeñombyryramo ha ndaikatúi oñemboja, pe oĩva oñemomombovo kembali. Pe ára oñe'ẽva ha'éma pe oñembojoaju hag̃ua. Pe akãngue ha'e pe generador rembiapo akãngue, ha mokõi generador rupi oĩ peteĩ pirapire pe eñembojoaju hag̃ua pe mba'e oñembojoaju va'ekue.
Ñepyrũmby
{
"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 }
}
| Teko'o | Moõpa |
|---|---|
400 | Imãra térã ñe’ẽ oñe’ẽva ndaha’éi ta’anga, peteĩ tembiapo ndaha’éiva ta’anga (invalid_image), térã peteĩ jereva ndaikatúva mohenda (edit_unsupported). |
413 | Pe ta'anga oĩ hese 20 MB-gui ypypávo (file_too_large), térã pe ñe'ẽnguéra opaite 32 MB over. |
503 | Ta'anga ndaikatúi ojejerure ko'ág̃a (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
Video la'ãry, upévare oñembo'y pyhareve, ndaha'éi oñemonduka. Reñemoĩ, reipytyvõ peteĩ id katuite, ha reñomonduka pe id kýre oñemoĩ va'erã. Video generator opa oñemombo'e Pro balance.
POST https://nymbot.ai/api/v1/videos — oñemohenda API key, térã Pe katuete Lightning rembipetẽ peteĩ jerure reheve. Ñembotyry 202.
| Koku | Eñe'ẽ | Ñembo'e va'erã | Ñe'ẽmbotyry |
|---|---|---|---|
model | puku ñembyaty | heẽ | Video generator id'ỹ oguahẽ porã GET /api/v1/models?type=video, oĩvaicha veo. |
prompt | puku ñembyaty | heẽ | Mba'épa oñembosarái va'erã. |
duration | número térã ñe'ẽ | Nahániri | Tembipytu segundópe, upéicha 0 rehevé ha upéicha 60pe. Oipuru añetehápe generators oipytyvõva'ekue reñembo'e tembiapo mbarete rehegua; pe ambue ohechauka haguãsy opaite, ha upéva ha'e mba'épa seconds mbytépe ha pe tape oĩ hína. |
aspect_ratio | puku ñembyaty | Nahániri | Ha'eicha "16:9" ha'e "9:16"; peteĩ mba'e guasuichaicha upéicha "1280x720" oikove pe oñemohendáva oĩva ohesáivo. |
resolutionquality | puku ñembyaty | Nahániri | Peteĩ generator-gua resolutions modelo rendy rehegua,icha mba'eicha "720p" ha'e "1080p"Omoĩ pe regua. Pe mba'eve avei oñeñe'ẽi ndaha'éi. unsupported_resolution. |
image_url | puku ñembyaty | Nahániri | Ta'anga ñembopyry hag̃ua: peteĩ https:// link térã a data:image/… URL, oñembopota ambue Blossom host peteĩ tenda pype ambueve. Oñondivepa generators ndive oĩva requires_image_url. |
Pe mba'e rupi oñembo'y pe tenda rehegua nepymbapote, generator, resolution ha length rehegua, upéicha oñembo'e ne Pro balance-gui ko'águi provider omoĩvo teko oñembopoty hag̃ua, ha ohechaukaicha hag̃ua
cost, estimated_cost ha nymbotUpe imbareteva oñembotyramo
tekotevẽ, mba'eve ndoipóri. Pe render oñembyasy upéi, térã pe clip oñemboherúramo
ha pe provider ndoipóri, pe jepy'apy oñemone'ẽ peteĩ ára, iporãite. Pe render
oñembojoaju peteĩ aravo jave, ha upéicha oñembohea, ha pe jepy'apy oĩ,
péicha la provider oñembohea pe render oñembojoajúramo. Pe refund oñemone'ẽ
créditos ha ndaikatúi omoĩ mbyasy pe key's spend count.
Mbojegua (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 ñepyrũ katu in_progress, térã completed video ñemondive
oĩma oñembojape data jo generator oñemvo oñondivepa.
Vídeo ñeha'ã
GET https://nymbot.ai/api/v1/videos/{id} — oĩ porãnte peteĩ tembiapo kuaa mba'épa omoĩ peteĩ nym omohendáva chupe. Petareta oñembo'e haguã katu oñembo'e jave.
Oĩ pytu 202 video ojejapóvo ha 200 oñembosarái térã oñembohovái omoĩvo. Ejerure 5 ha 10 segondopévo. Mba'e opaite ojehecha oñe'ẽ peteĩ mba'e rupive ha oipytyvõ avei upépe; ndohechái video rehe; peteĩ mba'e oñe'ẽvo oĩ 24 ára oñembotyvo rire.
GET /api/v1/videos oja'arõ jave kapi'i rembiapo 50 opaite oñembo'e haguã
{"object": "list", "data": […]}.
Ñepyrũmbypype (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 ha'e in_progress, completed ha'e failedTembiapo ndajapóiva oñembosarái error ({"code": "generation_failed", "message": …});
ha oñemombyry haguã, cost ha'e 0 ha nymbot hu'u ha mbojoaju
refunded_credits ha refunded_satsPe video omoĩva'ekue peteĩ Blossom host opaite tapicha ohecha va'erã,icha umi ojejapúva réra mba'e.
| Teko'o | Moõpa |
|---|---|
400 | Mba'eve nderehevái; peteĩ ára oĩva 0 ha 60 mboyve (invalid_value); peteĩ resolución ndaha'éi oĩva generator-pe (unsupported_resolution); ndaha'éi ta'anga jeyhupytyva oĩva oñomanduváva (image_required); peteĩ môde ndaha'éiva video generatór (invalid_model). |
402 | Pro balance ndaikatúi video reheve. |
404 | Upéicha mba'eichaitépa generator (model_not_found), térã nderehe mba'e ndaikatúi ehechauka pe id-pe ndery, térã ndoikuaa upéva mokõi ára ha haete (video_not_found). |
429 | Nderehe nym-pe oĩma 10 vídeo oñemohendáva (video_jobs_limit). Ehecha chupekuéra ha emoĩ avei hetave ikatúramo peteĩ omoĩvo. |
502 | Pe generador omoĩ ñemomyrũ pe tembiapo. Ndaha'éi mba'e oñemboja, upéicha ndoĩramo pe provider omoĩramo. |
503 | Vídeo ndaikatúi mokõiichagua oñehendu térã oñongatu ko’ágã (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);
Ñe'ẽ porã mbojoapy
Eñe'ẽ tekoteipy ha ombohovái ára ára, ndaha'éi peteĩ link. OpenAI speech endpoint-pa,
so audio.speech.create OpenAI SDKs-pe ojapo.
POST https://nymbot.ai/api/v1/audio/speech — oñemohenda API key, térã Pe katuete Lightning rembipetẽ peteĩ jerure reheve.
| Koku | Eñe'ẽ | Ñembo'e va'erã | Ñe'ẽmbotyry |
|---|---|---|---|
model | puku ñembyaty | Nahániri | Ñe'ẽ rembiapo modelo peteĩ hendáguive audio modelo ryaku'i lista. Default: pe ñe'ẽ opaite, @cf/myshell-ai/melotts. aura-2 Deepgram Aura 2pa'e. |
input | puku ñembyaty | heẽ | Ñe'ẽ oñeñotỹva: up to 800 characters pe voz estándarpe, 2,000 Aura 2 ñemongu'epe g̃uarã. |
voice | puku ñembyaty | Nahániri | Voz id peteĩrenga guive ñe'ẽkuéra tembiapo ñemonguéra: peteĩ Aura speaker haicha'éva luna ( térã aura-2-luna-en), térã peteĩ MeloTTS ñe'ẽ (en, es, fr, zh). OpenAI ñe'ẽkuéraicha upe ko'ãkuéra upe mba'eichaitépa oñeñe'ẽ upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha oguata hag̃ua upe ko'ã mba'eicha upe ko'ã ojehecha ogu alloy ojapo ha omoĩ modelo peẽnguéra remiandu pya'e. |
language | puku ñembyaty | Nahániri | Tetegua ñe'ẽ ñe'ẽ mbo'ehaipyreicha upeicha aséva es. Ñañe'ẽrendu'ỹre, omohenda peteĩ ñe'ẽndy ko ñe'ẽpe g̃uarã. Peteĩ ñe'ẽndu oñe'ẽ ambue ñe'ẽme oñemondýi kembali 422 voice_language_mismatch, ha peteĩ ñe'ẽ ndereikuaái pe modelo ndaha'éiva pevo 422 unsupported_language. |
response_format | puku ñembyaty | Nahániri | Ñe'ẽ opa térã ñe'ẽ oñembohovái kembali mp3 mamoite. Aura 2 omondúi mp3 (oĩva upéicha), opus, aac, flac, wav ha'e pcm. |
speed | pote | Nahániri | Oñeñotỹ ha oñembyatýi. |
Pe ñe'ẽte osẽ 3 credits (30 sats) peteĩ jerure rehe, icha pe app-pe. Aura 2 ha'e Pro, oñembojoaju pe ojeheréva letra rupi. Pe mba'e oñemohendáva ha'e pe audio, peteĩ mba'e oñeñotỹva...
Content-Type; pe mba'e ipaha oĩva teĩha X-Nymbot-Cost-Sats Ykapoty. Ojeheja ñe'ẽ rembiapo oñembo'yramo, mba'eve ndojepota'ói.
Ñepyrũmby
HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-Nymbot-Cost-Sats: 4.2
X-Nymbot-Balance-Sats: 41055.6
(audio bytes)
| Teko'o | Moõpa |
|---|---|
400 | Nderehe'í; input over the model's limit (input_too_long); peteĩ mba'e peicha ndaikatúi model omoheã porã ndive (unsupported_response_format); ndojerereikuaáva ñe'ẽ (invalid_voice); mohendaha ndaha'éi ñe'ẽ mohendaha (invalid_model). |
422 | Pe ñe'ẽ ndaikatúi ñe'ẽ oje'eva ñe'ẽ rupive, térã pe modelo ndopavãi pe ñe'ẽ rupive. |
502 | Ñe'ẽ modelo oñembojegua'a. Upéicha ndaikatúi mba'eve oñemoĩ. |
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()));
Ami mbo'eha kuatia ha ñe'ẽ upekuéra
Mbojeréi opaite tembiapo pohã oñembojeguaáva ñembosarái ha ñe'ẽ, térã ñe'ẽmbotapy tembiapo oñembojeguaáva. Oĩ 41 Aura 2 English ñe'ẽnguéra ha apatã MeloTTS ñe'ẽ.
GET https://nymbot.ai/api/v1/audio/models — ndojehei'áivi yave.
GET https://nymbot.ai/api/v1/audio/voices?language=en — ndojehei'áivi yave.
| Koku | Eñe'ẽ | Ñembo'e va'erã | Ñe'ẽmbotyry |
|---|---|---|---|
language | ñe'ẽ (puka) | Nahániri | Ko'ápe guarani ñe'ẽ rory ha ñe'ẽ porãicha rekove añeteguáicha. |
model | ñe'ẽ (puka) | Nahániri | Ko'ã mba'e ha'e ko modelo remi'ãre añe'ẽ rupi'ápente. |
Ñe'ẽnguéra (he'ẽ)
{
"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 }
]
}
Mbo'ehao rendapykuéra oñe'ẽ mba'épa {"object": "list", "data": {"tts": […], "stt": […]}}Mbo'ehaovaykuéra opaite ohechauka iñe'ẽkuéra rembiapo, oho i'ã, héra, max_input_chars,
response_formats, languages ha default_voice; pe
mbojerokyreko môde omohechauka iñe'ẽndykuéra, max_file_bytes, max_seconds,
tekove ha réra pýre.
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);
Ñe'ẽporãme ñemohenda mba'e ypytu'u rehegua
Omoĩ peteĩ ñe’ẽreko kuatiañe’ẽ rupive Whisper. Ko’áicha OpenAI-remimbarete transcription endpoint, so
audio.transcriptions.create ete oikove.
POST https://nymbot.ai/api/v1/audio/transcriptions — oñemohenda API key, térã Pe katuete Lightning rembipetẽ peteĩ jerure reheveTetã ha'e multipart/form-data.
| Koku | Eñe'ẽ | Ñembo'e va'erã | Ñe'ẽmbotyry |
|---|---|---|---|
file | tapyra | heẽ | Pe ñe'ẽnguéra, 256 bytes-gui 25 MB-pe ha 30 minutosve: WAV, WebM, MP4 térã M4A, Ogg térã Opus, MP3 ha ambue ñe'ẽnguéra Whisper oikuaáva. MP3 ha ambue ñe'ẽnguéra ndaikatúi oñembojegua upéicha haguére, upéva oñembojoapy 1.8 MB-pe. |
model | puku ñembyaty | Nahániri | Tekove porãnte whisper, ha'e Whisper Large v3 Turbo. whisper-1, whisper-large-v3-turbo ha @cf/openai/whisper-large-v3-turbo oñeñe'ẽ avei. |
language | puku ñembyaty | Nahániri | Ñe'ẽ oñe'ẽva, upeicha asẽ enOñemomba'e oñemboja haguã. |
prompt | puku ñembyaty | Nahániri | Ñe'ẽ térã mba'eichaitépa oñembohasa oñembohesáiva, ha'e undáicha réra. Ha'e pe katupyry mokõive 1.000 ñe'ẽnte ojeipuru. |
response_format | puku ñembyaty | Nahániri | json (oĩva upéicha), text, srt, vtt ha'e verbose_json. |
WAV, WebM, MP4 ha Ogg tekovekuérape, pe peteĩ ñe’ẽnguéra reity ha’e oñembohasa pe tekove rupi oñepyrũmbýrõnte, upévare
30 minutu rãĩva oñembojere upeve (3 segundu reheve). WAV tekove peteĩ mba’e oñembohasa iñe’ẽrenda (sample rate), iñe’ẽ oñembohasa (channels) ha iñe’ẽ guasu (sample size) rupive. Tekove ambue mba’e, upeicha MP3, ndaikatúi oñembohasa upeve, upévare oñemboheraha iñe’ẽ guasu (size) rupive: pe pahaite iñe’ẽrenda Nymbot oñembohasa haguére, 8 kbps,
30 minutu ha’e 1.8 MB, ha peteĩ tekove guasuve upéicha mba’ére oñembojere 413
audio_too_long mba'e ndoikotevẽmbýre. Émo opaite tapicha rekove ndaha'éi, eñomongeta opaite mba'e WAV, WebM, MP4 térã Ogg reheve.
If Whisper oñe'ẽ opaite 30 ára reheve, pe jerure oñembojere oñemboty hakuve:
413 audio_too_long, ha ko'ãme Whisper oñeẽvo, 30 minutu oñemoĩ.
Reñeẽme pe áudio rekove reheve, oñemboje pe segundo ha'e: pe oñembo'e pe tekotevẽ oĩva pe tembiapo rehe, pe Whisper ohecháva pe rekove, ha pe oikotevẽva pe archivo rehe, Whisper pe mbyté oñembo'eicha ha pe tembiapo oñembopy'aguapy haguã, ha peteĩ peteĩme oñemboje 0.05 creditópe. Upéva oñembo'e pe chekakuaa oĩva ha upéicha avei Pro rehe; a 402 ojepuru jave mba'éichapa oñembo'e hesekuéra. Ñe'ẽ rupive, peteĩ ñe'ẽre'ỹ oñembo'e ha katu ipoguata; API-pe katu opaite oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Upéicha oñembo'e. Up
Ñepyrũmby
{
"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 émba'apo tekotevẽ ñe'ẽ ndive, srt ha vtt mombarete tembiapokuaa, ha
verbose_json oĩmi pe ñe'ẽ, ára ha ára oñembojoajuva. Pe mbohapy ndaha'éi JSON, pe akãgua mbykymi oĩ hikuái pe hekave.
| Teko'o | Moõpa |
|---|---|
400 | Tekotevẽi tembiapo, peteĩ tembiapo ndaha'éiíva áudio upéicha (invalid_audio), peteĩ mba'e ndoikuaái mba'épa, térã peteĩ modelo ndaha'éi peteĩ mba'e ñe'ẽ oñembohasa hag̃ua (invalid_model). |
402 | Moõicha rembiapo ndaikatúi chupe mohendáva. |
413 | Tekombo'e oñembosarái 25 MB-gua overfile_too_large) térã pe ñe'ẽnguéra ovehesáivo 30 minutu rupi, térã, peteĩ tembiapo ndaikatúva oñembohasa oñembohea peve, 1.8 MB ypave (audio_too_long). |
502 | Whisper ndaikatúi pe áudio oñembohasávo. Mba'eve ndoikói. |
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);
Ñe'ẽnguéra ko'ẽ rupi ingléspe
POST https://nymbot.ai/api/v1/audio/translations — oñemohenda API key, térã Pe katuete Lightning rembipetẽ peteĩ jerure reheveTetã ha'e multipart/form-data.
Imésme transcription-icha, opaite mba'e hendáicha, oĩramo... language, mbojerure ha
reko, ha katu pe tekote ko'ẽngue oúva Inglenguápe oñeñe'ẽva mba'eichaitéramo. Pe OpenAI SDK-kuéra ojerure
upéicha 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);
Moñemyasãkuekuéra
Ñe'ẽ omoĩ vektór-pe oheka hag̃ua, oñondive omoĩ hag̃ua ha omohenda porãve hag̃ua. Ápe oñembohory Cloudflare-pe ha omoipuru pe mba'e oĩva teko'ãme.
POST https://nymbot.ai/api/v1/embeddings — oñemohenda API key, térã Pe katuete Lightning rembipetẽ peteĩ jerure reheve.
| Koku | Eñe'ẽ | Ñembo'e va'erã | Ñe'ẽmbotyry |
|---|---|---|---|
model | puku ñembyaty | heẽ | Embedding modelo peteĩ guive GET /api/v1/models?type=embedding. |
input | ñe'ẽru térã ñe'ẽru pyporé | heẽ | Tekotevẽva oñembo’e va'erã, hasta 100 ñe'ẽ ndaha'eiha mba'eve. Token arrays oñembotyry ndaikatúi (token_input_unsupported). Opaite mba'e oñeha'ãva oñembosarái va'erã modelo'ỹ context_length, oñembojerovia opa pataha yvága mbytére umi token. |
encoding_format | puku ñembyaty | Nahániri | float (pe oñembojeguaáva) térã base64 (números flutuantes 32-bit little-endian) |
dimensions | inteyéras | Nahániri | Mbo'ehao ipu'akaite, térã peteĩ mbo'ehaoguive ñandéve supported_dimensions ha'e peicha rehegua; upéicha pe vector oñemombarete ha oñemboave. Pe ambue mba'e oñembojere. |
| Mba'e môra | Tesa ñemongovekuéra | Tekopy) |
|---|---|---|
@cf/baai/bge-m3 | 1024, heta ñe'ẽnguéra | 8,192 tokens |
@cf/qwen/qwen3-embedding-0.6b | 1024, heta ñe'ẽnguéra | 8,192 tokens |
@cf/baai/bge-large-en-v1.5 | 1024, Inglés | 512 tokens |
@cf/baai/bge-base-en-v1.5 | 768, Inglés | 512 tokens |
@cf/baai/bge-small-en-v1.5 | 384, Inglés | 512 tokens |
Mbojeréichagua lista ha'e pe añetegua mba'éichapa oĩ ha mba'éichapa oñembosarái; Google's EmbeddingGemma, oĩ ramo umi vector michĩva ñemone'ẽ rupive, upépe avei oĩ jave pe katalogoha oĩ porandu hóga. Embeddings oñembojeréicha pe input token rupive, ha pe 0.05-credit mínimo oñemoĩ peteĩ ñemone'ẽ rupive, ndaha'éi pe input rupive, upévare oñembosarái opaite tekove peteĩ ñemone'ẽ rupive ha'e mba'e ipurahéive heta tekove ñemone'ẽmbyry oñemboja haguã.
Ñepyrũmby
{
"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 }
}
| Teko'o | Moõpa |
|---|---|
400 | Ndejepy'apy térã mba'eve nderehei; token arrays (token_input_unsupported); upéichave 100 inputs jaiko (too_many_inputs); peteĩ ñe'ẽnguéra opaite ha'eva modelo reheve opa (input_too_long); peteĩ mba'e rehegua ikatu'ỹi ko modelo omohenda (unsupported_dimensions). |
402 | Pe mba'e porãitéva tekotevẽnteicha ipaha oñembo'e too low. Embeddings ndaikatúi oipuru pe Pro balance. |
404 | Imbarete ndereheva porandu ndaikatúva ko réra rehegua. |
502 | Pe modelo oñembyasy. Ndoguerekói mba'eve oñemboja'ỹva. |
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);