Мэдлэгийн бааз Үйлдвэрлэгчид
Зураг, аудио болон хавтан
Апп-ийн генераторууд, хайлтын барилгын блок: зураг, видео, дуу, транскрипт, хавхлага, таны түлхүүрээс хэрэглээний дагуу төлбөргүй.
Энэ хуудсыг тав тухтай байлгах үүднээс машинаар орчуулсан болно. Англи хэл дээрх эх хувилбар нь тохирох хувилбар юм.
Фото зураг
Тогтмол нь нэг до 4 зураг үүсгэхийн тулд, тэд хийх үед тэднийг дамжуулдаг. Энэ нь генераторуудын нэг баг юм ?image App дээр
POST https://nymbot.ai/api/v1/images/generations — API ключ хэрэгтэй, эсвэл Lightning төлбөрийн шаардлага.
Ids нь GET /api/v1/models?type=imageСтандарт генератор
@cf/black-forest-labs/flux-1-schnell, үнэ цэнэтэй 5 стандарт кредит (50 sats) зураг. Бүх бусад генератор өөрийн үнэтэй Pro кредит зарцуулдаг, хэвийн төлбөр, маржин, гэх мэт Апп. n Фото зураг
n Generator-ийн тоноглогдсон тоноглогдсон тоноглогдсон тоноглогдсон тоноглогдсон тоноглогдсон тоноглогдсон тоноглогдсон тоноглогдсон.
| Байгалийн | Бүтээгдэхүүн | Үйлчилгээний | Үзүүлэлт |
|---|---|---|---|
model | Түлхүүр | Тиймээ | Generator ID, гэх мэт nano-banana. |
prompt | Түлхүүр | Тиймээ | Ямар ч эхний 2000 символ ашиглаж байна. |
n | Өнгөрсөн | Үнэгүй | 1 нь 4. Шагналт 1. Мөн хүлээн зөвшөөрсөн num_images. |
size | Түлхүүр | Үнэгүй | Тавтай морилно уу "16:9", эсвэл OpenAI хэмжээ зэрэг "1792x1024", энэ нь 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:4 болон 4:5 нь хамгийн ойр юм. "auto" Энэ нь генераторууд руу илгээнэ. |
aspect_ratio | Түлхүүр | Үнэгүй | Үүнээс гадна size, , мөн тэд аль аль аль аль нь илгээж байгаа бол төлдөг. |
quality | Түлхүүр | Үнэгүй | генератор тусгай, гэх мэт "low", "medium" эсвэл "high". |
negative_prompt | Түлхүүр | Үнэгүй | Ямар ч байтугай. |
output_format | Түлхүүр | Үнэгүй | "png", "jpeg" эсвэл "webp". |
response_format | Түлхүүр | Үнэгүй | "url" (Барилга) эсвэл "b64_json". |
image_url | Түлхүүр | Үнэгүй | Фото зураг нь эхлэх нь: an https:// Энэ нь хэрэглэгчийн нэр, нууц үггүйгээр хамгийн их 4.096 тэмдэгтэй холбоос, эсвэл data:image/…;base64 URL (PNG, JPEG, WebP эсвэл GIF; SVG биш). edit; хэрэглэгчид requires_image_url. |
resolution хэрэглэдэг биш юм: бүр генератор өөрийн хэмжээ хийх. url, Бүх зураг нь олон нийтийн Blossom хост дээр байршуулсан бөгөөд та өөрийн холболт авах болно (ямар ч генераторууд зөвхөн өөрсдийн холболт дамжуулах болно). Хамгийн сүүлийн үеийн холболт нь ямар ч нэг нь энэ нь нээж болно, энэ нь дахин татаж авах болно; үзнэ үү Ямар ч огноо үзнэ үүҮүнээс гадна
b64_json Фото зураг хариу дээр үсэглэдэг бөгөөд энэ нь ямар ч удаа байрлуулсангүй. Фото зураг data: Эдүүлбэр image_url Энэ нь тавтай морилно уу
Эдүүлбэр Blossom эхлээд генератор үүнийг олж болно; Энэ нь хүсэлтийг хязгаарлагддаг бол энэ нь дахин илрүүлэх болно.
Хэрэв зарим нь n зураг буцаж, та ажиллаж байгаа хүмүүсийг олж авах, зөвхөн тэдний хувьд төлбөртэй байдаг (бүү ямар ч ханган нийлүүлэгч буцаж байгаа хэдий ч), болон nymbot.failed хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр хэлбэрээр 502.
Сэтгэгдэл
{
"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 }
}
| Үйлчилгээ | Үнэндээ |
|---|---|
400 | Үнэндээ хурдан n 1 нь 4 (invalid_value) ; хязгааргүй хэмжээ (invalid_size) эсвэл зураг (invalid_image, invalid_image_url); загвар байдаг боловч зураг генератор биш юм (invalid_model); зураг генераторууд нь редактировать чадахгүй (edit_unsupported); ямар ч зураг нь ямар ч шаардлагагүй (image_required). |
402 | Баланс хүссэн бүх зургийг хамаргүй. |
404 | ямар ч загвар нь энэ нэртэй (model_not_found). |
502 | Generator нь хязгаарлагдсан (upstream_error). Үгүйгээр ханган нийлүүлэгч туршилтын зардлыг төлбөргүй байна; дараа нь алдаа charged_sats. |
503 | Фото зураг одоо байрладаггүй (media_hosting_unavailable). b64_json Бүртгүүлэх |
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);
Фото зураг
Энэ нь OpenAI-ийн редактийн эцсийн хэсэг юм, Тиймээс OpenAI SDK-ийн images.edit ажиллаж байна. Зөвхөн Pro генератор нь edit загварын жагсаалт нь үүнийг хүлээн зөвшөөрч байна.
POST https://nymbot.ai/api/v1/images/edits — API ключ хэрэгтэй, эсвэл Lightning төлбөрийн шаардлагаӨрөө нь multipart/form-data32 MB хүртэл
| Байгалийн | Бүтээгдэхүүн | Үйлчилгээний | Үзүүлэлт |
|---|---|---|---|
image | Бүртгэл | Тиймээ | Хувилагдсан зураг: PNG, JPEG, WebP эсвэл GIF, 20 МБ хүртэл. image[]; Эхний нэг ашиглаж байна. |
prompt | Түлхүүр | Тиймээ | Ямар ч өөрчилж |
model | Түлхүүр | Тиймээ | генератор нь edit. |
n | Өнгөрсөн | Үнэгүй | 1 нь 4. |
sizeaspect_ratioqualitynegative_promptoutput_format | Түлхүүр | Үнэгүй | Generation тухай |
response_format | Түлхүүр | Үнэгүй | "b64_json" (Тавтай морилно уу) эсвэл "url". |
Та хуваалцсан зураг сайн хэлбэртэй PNG, JPEG, WebP, эсвэл GIF гэж шалгаж байна, түүний үнэхээр хэлбэрээр илгээсэн бөгөөд публик Blossom хост дээр байрлуулж байна, учир нь генераторууд линк дамжуулан тэдний өгөгдлийг олж авах. Хэрэв редактийг хязгаарлагддаг бөгөөд ямар нэгэн ач холбогдолгүй бол хост хуваалцсан хуваалцсан. Ангилал нь генераторуудтай адил хэлбэртэй байдаг. Үнэлгээ нь генераторууд нь үнэ юм, зарим генераторууд нь өгөгдлийн зураг нь төлбөр агуулдаг.
Сэтгэгдэл
{
"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 }
}
| Үйлчилгээ | Үнэндээ |
|---|---|
400 | Ямар ч зураг, илрүүлэгчгүй, зураггүй файл (invalid_image), эсвэл редактировать чадахгүй генератор (edit_unsupported). |
413 | Фото зураг 20 MB (file_too_large), эсвэл 32 MB гаруй бүх хүсэл. |
503 | Фото нь одоо байрладаггүй (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"));
Видео
Видео минут тусалдаг, Тиймээс энэ фонад ажиллаж байна. Та үүнийг хуваалцах, тавтай морилно уу ID-ийг олж авах, энэ нь хийх хүртэл ID-ийг хайж байна. Бүх видео генератор Pro баланс ашигладаг.
POST https://nymbot.ai/api/v1/videos — API ключ хэрэгтэй, эсвэл Lightning төлбөрийн шаардлагаӨнгөрсөн 202.
| Байгалийн | Бүтээгдэхүүн | Үйлчилгээний | Үзүүлэлт |
|---|---|---|---|
model | Түлхүүр | Тиймээ | Видео генератор ID нь GET /api/v1/models?type=videoгэх мэт veo. |
prompt | Түлхүүр | Тиймээ | Ямар ч байх ёстой. |
duration | тоо эсвэл string | Үнэгүй | Урт секунд, 0-аас дээш, 60 хүртэл. Та урт сонгох боломжийг олгодог генераторууд зөвхөн ашиглаж байна; бусад нь ихэвчлэн урт, энэ нь юу вэ seconds Reaction болон үнэ дараах. |
aspect_ratio | Түлхүүр | Үнэгүй | гэх мэт "16:9" эсвэл "9:16"; гэх мэт хэмжээ "1280x720" Энэ нь найдвартай харьцуулагч юм. |
resolutionquality | Түлхүүр | Үнэгүй | Генераторын нэг resolutions загварын жагсаалт, гэх мэт "720p" эсвэл "1080p". Энэ нь үнэг тохируулж байна. Үүнээс гадна ямар ч зүйл байхгүй байна unsupported_resolution. |
image_url | Түлхүүр | Үнэгүй | Фото зураг нь эхлэх нь: an https:// Холбоо барих data:image/… URL-ийг эхлээд олон нийтийн Blossom хост дээр татаж авах болно. Generators with requires_image_url. |
Бүтээгдэхүүний үнэ нь генераторууд, тодорхойлолт, урт нь татаж авах үед тохиромжтой байдаг, тиймээс үйлчлүүлэгчийн ажил хүлээн зөвшөөрөх үед таны Pro балансээс төлбөртэй бөгөөд энэ нь
cost, estimated_cost болон nymbot. Хэрэв ханган нийлүүлэгч үйл явцыг хүлээн зөвшөөрч байгаа бол, ямар ч ач холбогдолгүй байх болно. Хэрэв дараагийн хуваалцахгүй бол, эсвэл эцсийн клип хадгалах боломжтой бөгөөд ханган нийлүүлэгч нь зардлыг хуваалцахгүй бол, төлбөр нэг удаа, автоматаар хуваалцах болно. Ажлын нэг цаг дараа одоо ч байгаа нь хуваалцсан бөгөөд энэ нь хуваалцсан байх болно, учир нь ханган нийлүүлэгч үүнийг хүлээн зөвшөөрч байгаа үед хуваалцсан байх болно. Үнэгүй хуваалцсан нь кредитыг хуваалцдаг боловч ключ-ийн зардал тооцлыг багасгахгүй.
Холбоо барих (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 Эхлэл As in_progressэсвэл completed Видео нь одоо ч data генератор нь үүнийг хурдан авч байна.
Видео дээр шалгах
GET https://nymbot.ai/api/v1/videos/{id} — тавтай морилно уу. Тавтай морилно уу. Тавтай морилно уу. Тавтай морилно уу.
Сэтгэгдэл 202 видео хийх үед болон 200 нэг удаа дууссан эсвэл үр дүнтэй байна. 5 нь 10 секундын дотор асуултууд. Бүх шалгах нь ханган нийлүүлэгчдэд нэг удаа асуултууд, нэг удаа хариултууд; Энэ нь видеог чадахгүй байна. Ажлын дараа 24 цагийн дотор хадгалж байна.
GET /api/v1/videos Хамгийн сүүлийн үеийн 50 ажлын байршуулалт нь
{"object": "list", "data": […]}.
Сэтгэгдэл (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 Нөхцөл in_progress, completed эсвэл failedЭдүүлбэр » A Failed Job Carries error ({"code": "generation_failed", "message": …}); Хэрэв энэ нь төлсөн бол, cost 0 болон nymbot Өнгөрсөн
refunded_credits болон refunded_sats. Бүртгэгдсэн видео нь олон нийтийн Blossom хост дээр байдаг, үүсгэсэн зураг шиг.
| Үйлчилгээ | Үнэндээ |
|---|---|
400 | ямар ч хурдан; 0 нь 60 хүртэлх цаг хугацаа (invalid_value); генератор санал болгож чадахгүй шийдэл (unsupported_resolution); ямар ч зураг нь генератор хэрэгтэй (image_required); видео генератор биш загвар (invalid_model). |
402 | Pro баланс видеог хамаргүй. |
404 | ямар ч генератор (model_not_found), эсвэл энэ ID нь таны нимм нь ажилгүй, эсвэл энэ нь 24 цагийн гаруй байна (video_not_found). |
429 | Your nym already has 10 видео rendering (video_jobs_limit). Эдгээр нь шалгаж, нэг эцсийн дараа илүү илгээх. |
502 | Generator нь үйл явцыг хүлээн зөвшөөрсөн. Нийт хэрэглэгчийн төлбөргүйгээр төлбөргүй байна. |
503 | Видеог одоо хүргэх, хадгалах болно (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);
Сэтгэгдэл
Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: Үзүүлэлт: audio.speech.create OpenAI SDKs нь ажиллаж байна.
POST https://nymbot.ai/api/v1/audio/speech — API ключ хэрэгтэй, эсвэл Lightning төлбөрийн шаардлага.
| Байгалийн | Бүтээгдэхүүн | Үйлчилгээний | Үзүүлэлт |
|---|---|---|---|
model | Түлхүүр | Үнэгүй | Зураг загвар нь Аудио загвар жагсаалт.Default: Стандарт дуу, @cf/myshell-ai/melotts. aura-2 Deepgram Aura 2 нь алдартай. |
input | Түлхүүр | Тиймээ | Чөлөөт текст: стандарт дуу нь 800 зэрэгцээ, Aura 2 нь 2,000 зэрэгцээ. |
voice | Түлхүүр | Үнэгүй | Voice ID нь Voice жагсаалт: тавтай морилно уу Aura speaker luna эсвэл aura-2-luna-en), эсвэл MeloTTS хэл (en, es, fr, zh). OpenAI дууны нэр alloy тавтай морилно уу, загварууд нь тавтай морилно уу. |
language | Түлхүүр | Үнэгүй | хэлний код, гэх мэт esЯмар ч дуу, энэ хэл нь нэг сонгоно уу. Ямар ч хэл хэл хэл хэл нь унтраах 422 voice_language_mismatch, , загварууд нь нэргүй хэл юм 422 unsupported_language. |
response_format | Түлхүүр | Үнэгүй | Стандарт дуудлага үсэг mp3 Only. Aura 2 Дараа нь mp3 (Хуувцаслалт нь) opus, aac, flac, wav эсвэл pcm. |
speed | Нийт | Үнэгүй | хүлээн зөвшөөрсөн болон мэдэгдсэн. |
Стандарт дуудлага нь хэрэглээний хувьд 3 стандарт кредит (30 sats) үнэтэй байдаг. Aura 2 нь Pro юм. Та илгээх үгс дагуу үнэтэй байдаг. Reaction Body нь аудио юм.
Content-Type; зардал нь X-Nymbot-Cost-Sats Header. Хэрэв хэлний загвар буцаж байгаа бол, ямар ч ачаалал байна.
Сэтгэгдэл
HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-Nymbot-Cost-Sats: 4.2
X-Nymbot-Balance-Sats: 41055.6
(audio bytes)
| Үйлчилгээ | Үнэндээ |
|---|---|
400 | Загваргүй; загвар нь хязгаарлагдмал (input_too_long); загварыг үүсгэх боломжтой формат (unsupported_response_format); Зөвлөмжгүй дуу (invalid_voice); загвар нь хэлбэрийн загвар биш (invalid_model). |
422 | Зохиогчийн эрх хуулиар хамгаалагдсан. Зохиогчийн эрх хуулиар хамгаалагдсан. |
502 | Сүлжээний загвар буурсан. Ямар ч ачаалалгүй. |
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()));
Аудио загвар, дуу
Дуудлага загвар, дуу, эсвэл транскрипцийн загвар сонгохын тулд хоёр албан ёсны жагсаалт. 41 Aura 2 англи хэл, 4 MeloTTS хэл байдаг.
GET https://nymbot.ai/api/v1/audio/models ямар ч түлхүүр хэрэгтэй.
GET https://nymbot.ai/api/v1/audio/voices?language=en ямар ч түлхүүр хэрэгтэй.
| Байгалийн | Бүтээгдэхүүн | Үйлчилгээний | Үзүүлэлт |
|---|---|---|---|
language | Үйлчлүүлэгчид | Үнэгүй | Эдгээр хэл дээр зөвхөн дуу. |
model | Үйлчлүүлэгчид | Үнэгүй | Энэ загвар нь зөвхөн дуу. |
Сэтгэгдэл (Voices)
{
"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 }
]
}
Моделины жагсаалт {"object": "list", "data": {"tts": […], "stt": […]}}. Бүх хэлний загвар нь өөрийн баланс, үнэ, max_input_chars,
response_formats, languages болон default_voice; транскрипцийн загвар нь алдааг санал болгож байна, max_file_bytes, max_seconds, формат болон минутын үнэ.
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);
Өнгөрсөн текст
Whisper ашиглан бүртгэлийг текст руу өөрчлөх. Энэ нь OpenAI-ийн транскрипцийн эцэст юм.
audio.transcriptions.create Ажлын
POST https://nymbot.ai/api/v1/audio/transcriptions — API ключ хэрэгтэй, эсвэл Lightning төлбөрийн шаардлагаӨрөө нь multipart/form-data.
| Байгалийн | Бүтээгдэхүүн | Үйлчилгээний | Үзүүлэлт |
|---|---|---|---|
file | Бүртгэл | Тиймээ | Татаж авах, 256 байт 25 MB хүртэл, 30 минутын хүртэл: WAV, WebM, MP4 эсвэл M4A, Ogg эсвэл Opus, MP3 болон бусад формат Whisper унших. |
model | Түлхүүр | Үнэгүй | Үнэлгээ whisper, Whisper Large v3 Turbo юм. whisper-1, whisper-large-v3-turbo болон @cf/openai/whisper-large-v3-turbo Үүнээс гадна |
language | Түлхүүр | Үнэгүй | Алдартай хэл, гэх мэт enОдоогоор олж авсан. |
prompt | Түлхүүр | Үнэгүй | Зөвхөн анхны 1000 хэлбэрээр ашиглаж байна. |
response_format | Түлхүүр | Үнэгүй | json (Хуувцаслалт нь) text, srt, vtt эсвэл verbose_json. |
WAV, WebM, MP4 болон Ogg файлуудын хувьд урт нь файлуудыг ямар ч ажиллуулах өмнө уншиж байна, Тиймээс 30 минутын гаруй бүртгэлийн өмнө нь (с 3 секундын ачаалалтай). A WAV файлын урт нь дээж хурд, каналы, дээж хэмжээгээр орно. MP3 гэх мэт бусад форматүүд нь урт нь өмнө дээр уншиж чадахгүй, Тиймээс тэд хэмжээгээр хязгаарлагддаг: хамгийн бага бит хурдтай Nymbot нь 8 kbps, 30 минут нь 1.8 MB бөгөөд энэ формат дахь том файлууд нь хязгаарлагддаг 413
audio_too_long ямар ч ажиллуулах өмнө. WAV, WebM, MP4 эсвэл Ogg гэх мэт илүү урт жагсаалт илгээх. Хэрэв Whisper дараа нь 30 минутын гаруй бичсэн бол, хүсэлтийг хүлээн зөвшөөрч байна
413 audio_too_long, , Whisper ажиллаж байгаа бол 30 минутын төлбөртэй байна.
Та аудио урт, долоо хоногт хүрээтэй: файлын хамгийн урт урт унших, урт Whisper мэдээлэл, болон файлын хэмжээ нь хамгийн бага боломжийг олгодог, Whisper-ийн минутын үнэ нь хэвийн төлбөр, маржин, болон хамгийн бага нь 0.05 кредит нь хүсэлттэй. Энэ нь стандарт салбарт хуваалцаж болно үед энэ нь харах болно үед, болон Pro-аас аль хэдийн; 402 Тавтай морилно уу, Тавтай морилно уу, Тавтай морилно уу, Тавтай морилно уу!
Сэтгэгдэл
{
"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 ягаан туяаны текст, srt болон vtt Дараа нь субтитров, болон
verbose_json хэл, цаг хугацаа, цаг хугацааны сегментийг нэмнэ. JSON-ийн бус гурван сегмент нь үнэ цэнэтэй байна.
| Үйлчилгээ | Үнэндээ |
|---|---|
400 | ямар ч файл, ямар ч хэрэглэгддэг аудио файл (invalid_audio), мэдлэггүй формат, эсвэл загварыг транскрипцийн загвар биш юм (invalid_model). |
402 | Үүнээс гадна баланс нь үүнийг хамардаггүй. |
413 | Файл нь 25 MB-аас дээш байна (file_too_large) эсвэл 30 минут, эсвэл дөрвөн хэлбэрийн хэлбэрийн урт нь уншиж чадахгүй байна, 1.8 MB-аас дээш бичлэг (audio_too_long). |
502 | Whisper аудио боловсруулах чадахгүй байна. Ямар ч төлбөргүй байна. |
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);
Англи хэл хэлний хуваалцах
POST https://nymbot.ai/api/v1/audio/translations — API ключ хэрэгтэй, эсвэл Lightning төлбөрийн шаардлагаӨрөө нь multipart/form-data.
Үүнээс гадна транскрипт, эдгээр самбар нь language, хязгаарлалт, үнэ, гэхдээ текст нь хэлээр хэлсэн хэзээ ч англи хэл дээр ирж байна. OpenAI SDK нь энэ нь 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);
Үнэлгээ
Шууд, clustering, deduplication нь текст нь векторуудад өөрчлөх. Модели Cloudflare дээр ажилладаг бөгөөд стандарт салбарт ашигладаг.
POST https://nymbot.ai/api/v1/embeddings — API ключ хэрэгтэй, эсвэл Lightning төлбөрийн шаардлага.
| Байгалийн | Бүтээгдэхүүн | Үйлчилгээний | Үзүүлэлт |
|---|---|---|---|
model | Түлхүүр | Тиймээ | Арилжааны загвар нь GET /api/v1/models?type=embedding. |
input | string эсвэл string array | Тиймээ | Түлхүүр үгс, доош 100 хязгааргүй шугам. Тооцооны багцууд хүлээн зөвшөөрсөн байна (token_input_unsupported) Бүх эх үүсвэр нь загвар нь тохиромжтой байх ёстой context_length, 4 байт токен гэж тооцогдсон. |
encoding_format | Түлхүүр | Үнэгүй | float (Барилга) эсвэл base64 (32 Бит флоат) |
dimensions | Өнгөрсөн | Үнэгүй | загвар нь өөрийн хэмжээ, эсвэл загвар нь supported_dimensions Эдгээр нэг; вектор дараа нь хязгаарлагддаг, нормализуулсан. Үүнээс гадна ямар ч зүйл биш юм. |
| загвар | Хэмжээ | Баримтлал |
|---|---|---|
@cf/baai/bge-m3 | 1024, олон хэл | 8,192 токен |
@cf/qwen/qwen3-embedding-0.6b | 1024, олон хэл | 8,192 токен |
@cf/baai/bge-large-en-v1.5 | 1024, Англи | 512 Токио |
@cf/baai/bge-base-en-v1.5 | 768, Англи | 512 Токио |
@cf/baai/bge-small-en-v1.5 | 384, Англи | 512 Токио |
загварын жагсаалтууд нь тавтай морилно уу, тэдний зардал; Google-ийн EmbeddingGemma, хүсэлтийн дагуу хэт авианы жишээ нь, каталог нь үнэтэй байдаг үед бас байдаг. Эмэгтэйчүүд нь импортын токенаар тоноглогдсон бөгөөд 0.05-кредитын хязгаарлалт бүр хүсэлтийг хэрэглэдэг боловч нэг хүсэлтийг нэг удаа илгээхээс илүү хялбар юм.
Сэтгэгдэл
{
"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 }
}
| Үйлчилгээ | Үнэндээ |
|---|---|
400 | Ямар ч, ямар ч хэв маяггүй; token array (token_input_unsupported); 100 гаруй эх үүсвэр (too_many_inputs); загварууд илүү урт байх болно (input_too_long); загварын хэмжээ (unsupported_dimensions). |
402 | Стандарт баланс нь маш бага юм. Тавтай морилноор Pro баланс ашиглахгүй. |
404 | Үүнээс гадна энэ нэртэй загваргүй. |
502 | Загварын шагнал. ямар ч ачаалал байхгүй. |
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);