ނޮލެޖް ބޭސް / ޑިވެލޮޕަރުން

ތަސްވީރުތައް، އަޑާއި އެމްބެޑިންގްސް

އެޕްތަކުން ބޭނުންކުރާ ޖެނަރޭޓަރުތަކާއި، ހޯދުމަށް ބޭނުންވާ ބިލްޑިންގ ބްލޮކްތައް: ފޮޓޯ، ވީޑިއޯ، ކلام، ޓްރާންސްކްރިޕްޝަން އަދި އެމްބީޑިންގްސް؛ މި Saks ތަކުގެ ކޮންމެ ބޭނުންކުރުމަކަށް ބަލާލައިގެން ތިބާގެ ބެލަންސް އިން ވަކިން ބިލް ކުރެވޭނެއ로.

މި ޞަފްޙާއަކީ ފަސޭހަ ކަމުގެ ގޮތުން މެޝިނުން ތަރުޖަމާކޮށްފައިވާ ޞަފްޙާއެކެވެ. އިނގިރޭސި އޮރިޖިނަލް އަކީ އެއަށް އަމަލުކުރާ ވަރޝަން އެވެ.

ފޮޓޯތައް އުފެއްދުން

ޕުރޮމްޓަކީގެ އެހީގައި އެއް މަހު ހަތެއްގެ ތެރޭގައި ފޮޓޯތަކެއް ތައްޔާރުކޮށް، އެކަން ނިމުނުގަނޑު އެކަން ދައްކައިދޭއެވެ. މިއީ އެ ދެންނެވިފައިވާ ޖެނަރޭޓަރުތަކުގެ އެއްގޮތުގެ ތަކެތި އެކަނިތެރިކަމެވެ. ?image އެޕްގެ ތެރޭގައި.

POST https://nymbot.ai/api/v1/images/generations — އޭޕީއައި ކީއެއް (API key) ބޭނުންވަނެއިރު، ނުވަތަ ކޮންމެ ރިކުއެސްޓަކުން ލައިޓްނިންގ ފައިމަންޓެއް.

އައިޑީތައް އަންނަނީ GET /api/v1/models?type=image. އާންމު ޖެނެރޭޓަރ، @cf/black-forest-labs/flux-1-schnell, ފޮޓޯއަކަކު ސްޓޭންޑާޑް ކްރެޑިޓް 5 (50 sats) ހިނގާ ކަހަލަ އެއް ސާފު އަގަކުން ކުރިއަށްދެއެވެ. އެހެނިހެން، އުންމީދުންވާ ކޮންމެ ޖެނަރޭޓަރަކީ އޭގެ އަމިއްލަ އަގުން، އާދައިގެ ފީއާއި މާޖިންނާއެކު Pro ކްރެޑިޓް ބޭނުންކުރާނެއެވެ، އޭގެ ނަމޫނާ ހިނގާ އެޕްލިކޭޝަން އޮންނަ އެޕްލިކޭޝަން. n ފޮޓޯގެ އަގު n ތައްގަޑު ބޮޑުކޮށްގެން. ޖެނަރޭޓަރެއް އިންގާ ނުގަންނަ ފީލްޑަކީ އޭގެ ބޭކާރުކަމުން ދޫކޮށްލެވޭ ކަމެކެވެ እንސެކަމެއް ނޫން؛ ސްޓޭންޑަރޑް ޖެނަރޭޓަރަކީ ޕްރޮމްޓް އެކަނި ބޭނުންކުރާ އެއްޗެކެވެ.

resolution ބޭނުން ނުކުރެވެނީ: ކޮންމެ ޖެނަރޭޓަރެއް އޭގެ އަމިއްލަ ސައިޒު އުފައްދައެވެ. އެކު url, މަންޒަރުތަކުން ކޮ Each picture އަކީ ފ öffentlich Blossom host އަކަށް އަޕްލޯޑް ކުރެވިފައިވާ ތަކެތި، އަދި އެކަމުގެ ލިންކް ތިބޭނުވާނެ (ಕೆಲަ ޖެނަރޭޓަރުތަކުން އެމީހުންގެ އަމިއްލަ ލިންކެއް ދޭނެ، އެއީ ފުރަތަމަ ދިން ލިންކު ފެންނާނެ އެއްޗެކެވެ). ލިންކް ހުރި ކޮންމެ މީހަކަށްވެސް އެއްޗެހި އައްޅުވާލެވިދާނެ، އަދި އެއީ އަލުން ފޮހެލެވިދާނެ އެއްޗެއް ނޫންވާނެ; see API އަށް ފެންނަނީ ކޮބައިか. އެކު b64_json ޖަވާބުގައި ފޮޓޯ އަނބުރާ އަންނައון، އެއީ އެއްވެސް ފަހަލަކުން އަޕްލޯޑް ކުރެވިފައިވާ ފޮޓޯއެއް ނޫނެވެ. ފޮޓޯއެއް ފޮނުވަނީ data: URL އެޅުން image_url އެކު ނުވަތަ އެއްގޮތަށްތޯ ފާހަގަކރުވަނީ އިދާރުކުރޭ އޭގެ ބައެއް ބްލޮސަމްގައި (Blossom) ފުރަތަމަ އަޕްލޯޑް ކުރަންވާނެ، އެކަމުން ޖެނަރޭޓަރަށް އެއީ ހޯދަން އެނުނުނަމަ، އެ ރިކުއެސްޓް ފެއިލްވެއްޖެނަމަ އަލުން ފޮޅާލެވޭނެއެވެ.

އިފަހު ބައެއްކަން n ފޮޓޯތައް ފެއިލްވެއްޖެ，މާ ހަމައަކީ ކާމިޔާބުވި ފޮޓޯތައް އެކަނި ލިބޭނެއެވެ، އަދި އެ ފޮޓޯތަކަށް އެކަނި Charge ކުރެވޭނެއެވެ (އޭގެ އިތުރުން ފެއިލްވެފައިވީ ނަމަވެސް ފަރާތުން ބިލްކުރެވިފައިވާ އެއްވެސް ފޮޓޯ އޮތްނަމަ އެކަންވެސް ހިމެނޭނެއެވެ)، އަދި nymbot.failed ކިތneވަ로 މަފުކުވާފައިވާކަން ބުނެދޭނެއެވެ. އެންމެހާ ފޮލްޓްވެއްbed، ރިކުއެސްޓް ރީޓަންނުނެރެވޭނެއެވެ. 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 }
}

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 SDKs' images.edit ވަރަށް ފުރިހަމައެވެ. ޕްރޯ ޖެނަރޭޓަރުތަކަށް އެދެގެން އެކަން އެހެންވެސް ކުރެވިދާނެ edit މޮޑެލް ލިސްޓުން އެކAcceptކޮށްލައްވާ.

POST https://nymbot.ai/api/v1/images/edits — އޭޕީއައި ކީއެއް (API key) ބޭނުންވަނެއިރު، ނުވަތަ ކޮންމެ ރިކުއެސްޓަކުން ލައިޓްނިންގ ފައިމަންޓެއްދަދި ސި肢 އީ multipart/form-data, 32 MB އާ ހަމައަށް.

ތިބާ އަޕްލޯޑުކުރާ ފޮޓޯ ރަނގަޅު ގޮތެއްގައި ތައްޔާރުކުރެވިފައިވާ PNG, JPEG, WebP ނުވަތަ GIF ކަމަށް ޗެކްކުރެވޭނެއެވެ. އަދި މީގެ އަސްލީ ޓައިޕް އޮންނާނެއެވެ. މީގެ އިތުރުން، ޖެނަރޭޓަރުތަކުން އެމީޑިއާ ހޯދާނީ ލިންކްގެ މ尺度 އިންވާތީ، މި ފޮޓޯ ފަންޑަމަންޓަލީ ޕަބްލިކް ބްލޮސަމް (Blossom) ހޯސްޓަކަށް އަޅާނެއެވެ. މީކީ ފަންޑަމަންޓަލީ ޕަބްލިކް ކަމުގައި ಪರಿಗಣުއްވާށެވެ. އީޑިޓް ކުރުމުގައި މައްސަލައެއްވެއްbed އެއްވެސް ފީއެއް ނު chargedވާނަމަ، ހޯސްޓްކުރެވިފައިވާ ކޮޕީ މުއްސަނދިކަން ނެތި ފޮހެވިދާނެއެވެ. މީގެ ޖަވާބަކީ ޖެނަރޭޝަން ފަރުމާތަ އާދައިގެ ފަރުމާތަ އެއްޗެހިކަމެވެ. މި ހިދުމަތުގެ އަގަކީ ޖެނަރޭޓަރުގެ އަގެވެ. ބައެއް ޖެނަރޭޓަރުތަކުގައި އަންނާ ފޮޓޯގެ އަގުވެސް ހިމެނޭނެއެވެ.

ޖަވާބު

{
  "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 }
}

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"));

ވީޑިއޯ

ވީޑިއޯއެއް ތައްޔާރުކުރަން މިންވަތަކެއް ހިނގާނެތީ، އެއީ ބެކްގްރައުންޑުން (background) ހިނގާނެ ކަމެކެވެ. ކޮންމެހޭމެހޭ އެކަން ހުށަހަޅައި، ވަގުތުން އައިޑީއެއް (id) ހުރިހާލައި، އެކަން ނިމޭންދެން އެ އައިޑީއާ ބެހޭގޮތުން ސުވާލުކުރެއެވެ. ކޮންމެ ވީޑިއޯ ޖެނަރޭޓަރަކީވެސް ޕްރޯ ބެލެންސް (Pro balance) ބޭނުންކުރާ އެއްޗެކެވެ.

POST https://nymbot.ai/api/v1/videos — އޭޕީއައި ކީއެއް (API key) ބޭނުންވަނެއިރު، ނުވަތަ ކޮންމެ ރިކުއެސްޓަކުން ލައިޓްނިންގ ފައިމަންޓެއް. އަދคืนކުރެވޭ ތަކެތި 202.

ޖެނަރޭޓަރު، ރެޒޮލިއުޝަން އަދި ދިގުމިނުން ކަނޑައަޅާ އަގު، ހުށަހަޅާ ވަގުތު ވަރުނުނުވަތަ ކަނޑައެޅިފައިވާ ވަރަށް؛ އެހެންކަމުން ސާވިސް ފޯރުކޮށްދޭ ފަރާތުން މަސައްކަތް ಅಂಗీކުރި ފަހު، ތިބާގެ Pro ބެލެންސްއިން އެ އަގު ކެਟިގެންދާނެ، އަދި ދައްކާނީ cost, estimated_cost އަދި nymbotފަރާތުން މި މަސައްކަތް ކުރަން އުއްމީދު ނުކުރަމުން އައިސް، އެއްވެސް ފީއެއް ނު charged ކުރެއެވެ. އެހެންނަމަވެސް ރެންޑަރ ކުރުމުގައި ފަހުން މައްސަލައެއް އައިސް، ނުވަތަ ނިންމާލިފައިވާ ކްލިޕް ސްޓޯކުރުމަށް ނުވަތަ ރެންޑަރ ނުވަތާ ފައިސާ ބިލްކުރެވިފައިވާ ކަން އެނގުނުނަމަ، އެ ފީ އެއް ފަހަރު އޮޓޯމެޓިކައިކްކަމުން ރިފަންޑް ކުރެވޭނެއެވެ. އެއް ގަޑިއަކަށްވުރެ ގިނަ ވަގުތު ހިނގަމުންދާ ރެންޑަރެއް ހުއްޓުވනු -> އާއި، އެކަމަކ៏ އެ ފީ ނުނިදහާނެއެވެ. އެއީ ފަރާތުން ރެންޑަރެއް ގަބޫލުކުރިހިނިވަތަ އެއަށް ބިލް ކުރާތީއެވެ. ރިފަންޑް ކުރުމުން ކްރެޑިޓްސް އަނބުރާ ރިކަވަްވާނެއެވެ، ނަމަވެސް ކީ (key) ގެ ހިސާބު ބަދަލުނުވާނެއެވެ.

ޖަވާބު (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 ފެށޭނީ އޭގެ ފެށުންގެ ގޮތުން in_progress, ނުވަތަ completed ވީޑިއޯއާއެކު ފުރިހަމަވެފައިވާ data ޖެނަރޭޓަރު ވަގުތުން އެތަނަށް އަނބުރާ އައިސްފަރުމުން.

ވީޑިއޯއެއް ބަލަމުން

GET https://nymbot.ai/api/v1/videos/{id} — އެކަން ކުރަން އޮންނަނީ އެކަން ހުށަހެޅި nym އަށް ގުޅޭ ކީއެއް ބޭނުންނެވެ. ކިނަވެސް އޭގެ މިންވަރު ހަމަވެފައިވާ ކީއަކަށް ޗެކް ކުރުމުގެ ފުރުސަތު އޮންނާނެއެވެ.

އެއިން ޖަވާބުދެއެވެ 202 ވީޑިއޯ ތައްޔާރުކުރަމުންދާ ވަގުތު އަދި 200 އެކަން ނިމިގެން ނުވަތަ ފެއިލްވެގެން ވަނީފަހު، ކޮން 5 އިން부터 10 ސިކުންތުތަކ마다 ސުވާލު ކުރޭ. ކޮ Each check އަކީ ޕްރޮވައިޑަރ ވަންތަނަކުން އެއް ފަހක් ސުވާލުކޮށް އެއްވަގުތުއްker ޖަވާބު ދިނުމެވެ; އޭގެތެރޭގައި ވީޑިއޯގެ ވަގުތު ދެން އިންތިޒާރު ކުރަމެއް ނުވާނެއެވެ. ޖޮބެއް ހުށަހަޅައިފަހު އެއީ 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 އިތުރުކޮށް ބާއްވާލެވޭ މަސައްކަތެއްގައި އުފެދުވާ މައްސަލައެއްގައި އޮވެއެވެ error ({"code": "generation_failed", "message": …}); އިތާ ރިފަންޑް ކުރެވިފިނަމަ، cost 0 އަދި nymbot ޖޮޑުކުރެއެވެ refunded_credits އަދި refunded_satsނިންމާލާފައިވާ ଭީޑިއޯ އަކީ އާލެއިކް ފޮޓޯތަކެވީ ފަދައިން، ޕަބްލިކް Blossom host އަކީއެވެ.

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);

ލިޔުން އަޑަށް ބަދަލުކުރުން

ލިޔެކاتبާފައިވާ ލިޔުން އަޑުއަހައިދޭ އަދި އޭގެ އޯޑިއޯ ފައިލް އެކަނި އަނބުރި ފޮނުވައިދޭއ로، ލިންކެއް ނޫން. މިއީ OpenAI ގެ speech endpoint، އެހެންކަމުން audio.speech.create OpenAI SDKތަކުގައި މަސައްކަތްކުރާނެ ގޮތެވެ.

POST https://nymbot.ai/api/v1/audio/speech — އޭޕީއައި ކީއެއް (API key) ބޭނުންވަނެއިރު، ނުވަތަ ކޮންމެ ރިކުއެސްޓަކުން ލައިޓްނިންގ ފައިމަންޓެއް.

ސްޓޭންޑާޑް ވައިސް ކޮނެކު އެކި ކުލަވަޅުތަކެއް ނެތި، އެޕްގައިވާ ފަދައިން އެކި ރިކުއެސްޓަކު 3 ސްޓޭންޑާޑް ކްރެޑިޓް (30 sats) ހިނގާނެއެވެ. Aura 2 އަކީ Pro މިންވަރެއްގެ އެއްޗެއްނެ로، އަދި މީގެ އަގު ބަލައިގަންނާނީ ތިބާ ފޮނުވާ ކެރެކްޓަރުތަކުގެ އަދަދުންނެވެ. ރެސްޕޮންސް ބޮޑީއަކީ އޯޑިއޯއެވެ، އަދި އޭގެ ގުޅުންހުރި Content-Type; އަގުވަނީ X-Nymbot-Cost-Sats ހެޑަރ. ސްޕީޗް މޮޑެލް މަސައްކަތް ނުކުރަމުންދިޔަ ނަމަ، އެއްވެސް ފީއެއް ނުގާނެއެވެ.

ޖަވާބު

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

(audio bytes)

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 English speakers އާއި MeloTTS ގެ ހަތެއް ބަސްތަކެކެވެ.

GET https://nymbot.ai/api/v1/audio/models — ކީއެއް ނުބޭނުން.

GET https://nymbot.ai/api/v1/audio/voices?language=en — ކީއެއް ނުބޭނުން.

ޖަވާބު (އަޑުތައް)

{
  "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 }
  ]
}

މޮޑެލްތަކުގެ ލިސްޓުން answers ދެއެވެ {"object": "list", "data": {"tts": […], "stt": […]}}މި ބަހުގެ މޮޑެލްތަކުން ކޮ Each speech model gives its balance, price, އިންދާދީ މިންވަރާއި އަގު ދަނީ އެއީ އޭގެ balance, price, ތަފާތުކަމެވެ. 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 ގެ transcription endpoint އެވެ، އެހެންކަމުން audio.transcriptions.create މަސައްކަތް ކުރެއެވެ.

POST https://nymbot.ai/api/v1/audio/transcriptions — އޭޕީއައި ކީއެއް (API key) ބޭނުންވަނެއިރު، ނުވަތަ ކޮންމެ ރިކުއެސްޓަކުން ލައިޓްނިންގ ފައިމަންޓެއްދަދި ސި肢 އީ multipart/form-data.

WAV, WebM, MP4 އަދި Ogg ފައިލްތަކަށް, އެއްވެސް ކަމެއް ކުރިއަށް ނުދާވަels އެ ފައިލްތަކުން ދި𝙉ގަވަތް ކިޔައިގަނެއެވެ. އެހެންކަމުން 30 މިނެޓުން މަތިވެވަ� ރެކޯޑިންގ 하나 ރިޖެކްޓްކުރެއެވެ (3 ސިކުންތެއްގެ މުއްދަތެއް ދީފަށެވެ). WAV ފައިލެއްގެ ދި𝙉ގަވަތް އެނގުމަކީ އޭގެ ސެމްޕަލް ރޭޓް، ޗެނަލްސް އަދި ސެމްޕަލް ސައިޒުންނެވެ. MP3 ފަދަ އެހެން ފޯމެޓްތަކުގެ ދި𝙉ގަވަތް ކުރިން ކިޔައިގަނެވޭނެ ނޫނެވެ. އެހެންކަމުން އެތަކުގެ މಿತಿ އޮންނަނީ ފައިލުގެ ސައިޒުންނެވެ: އެންމެ ዝቅއިEmbى ބިޓްރޭޓް ކަމުގައި Nymbot ލަފާކުރާ 8 kbps އަށް، 30 މިނެޓަކީ 1.8 MB އެވެ. އެފަދަ ފޯމެޓެއްގައި އެއަށްވުރެ ބޮޑު ފައިލެއް އޮތުމުން ރިޖެކްޓްކުރެއެވެ 413 audio_too_long އެންމެ ފުރަތަމަ ކޮންމެ އެއްޗެއް ހުއްދަވުމުގެ ކުރިން. ދިގު ރެކޯޑިންގތައް WAV, WebM, MP4 ނުވަތަ Ogg ފޯމެޓުން ފޮނުވާށެވެ. އަދި Whisper އިން 30 މިނެޓަށްވުރެ ގިނަ ވަގުތެއް ރިޕޯޓް ކުރިނަމަ، އެުދާ込 ބޭނުންތަކަކީ އޭގެ ސަބަބުން މեր ބޭނުންތެރިކަން އުއްކުންތެރިވުމެވެ. 413 audio_too_long, އަދި Whisper ރަންވިތީ، 30 މިނެޓު Charge ކުރެވިފައިވެއެވެ.

އޯޑިއޯގެ ދިގުމިނަށް ބަލައި، ސިކުންތަކަށް ރައުންޑްކޮށް ފައިސާ ދައްކަންވާނެއެވެ: އެއީ ފައިލްގައިވާ ދިގުމިނާއި، Whisper އިން ރިޕޯޓުކުރާ ދިގުމިނާއި، އަދި ފައިލްގެ ސައިޒުން ކުރެވޭ އެންމެ ކުރު ދިގުމިނުގެ ތެރެއިން އެންމެ ދިގު ދިގުމިނެވެ. މިއީ Whisper ގެ މިނެޓުތަކަކަށް ދައްކަންޖެހޭ އަގާއި، އާންމު ފީ އަދި މާޖިން ހިމACނުގައެވެ. އަދި އެކި ކޮންމެ ރިކުއެސްޓަކަކަށްވެސް ވީs 0.05 ކްރެޑިޓް ހުއްޓަކަށްވެސް ދައްކަންވާނެއެވެ. އެކަމަކީ، އެއަށް ފައިސާ ދެއްކޭނީ ސްޓޭންޑާޑް ބަލެންސްގައި އެއަށް އެކަށީގެންވާ އަދަދެއް ހުރިނަމަ އެއިންނެވެ، ނަމަވެސް އެހެންނަމަ Pro ބަލެންހިންގާނެއެވެ; a 402 އެއްމާ އޮންނަ ބެލެންސްއިން ކޮން amount ޖެހޭނަމޫތޯ އެކަން ދަstur ބަޔާންކޮށްދެއެވެ. އެޕްގޭމްގައި، އޯލައިން ވަރިން ރެކޯޑްކުރެވިފައިވާ މެސެޖެއް ލިޔެލުމަކީ އެއްވެސް ފީއެއް ނުލިބޭ ކަމެއް ކަމުގައިދާނެއެވެ؛ ނަމަވެސް API އިން ބޭނުންކުރާއިރު، އެކަމަށް އަބަދުވެސް ފީ charged ކުރެވޭނެއެވެ. Whisper މަސައްކަތް ނުކޮށްފިނަމަ، އެއްވެސް ފީއެއް charged devey na.

ޖަވާބު

{
  "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 ނޫން ތިންކޮޅအတွက်، ޚަރަދު ހިމަނެނީ ހެޑަރުތަކުގައެވެ.

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);

ބަހުންދެކޮށްވާ ދައްކާފައިވާ ކަންތައްތައް އEnglish އަށް ތަރުޖަމާކުރުން

POST https://nymbot.ai/api/v1/audio/translations — އޭޕީއައި ކީއެއް (API key) ބޭނުންވަނެއިރު، ނުވަތަ ކޮންމެ ރިކުއެސްޓަކުން ލައިޓްނިންގ ފައިމަންޓެއްދަދި ސި肢 އީ multipart/form-data.

ޓްރާންސްކްރިޕްޝަން ފަދައިން، އެކަންވެސް އެކަދަ ފީލްޑްތަކާއެކު، އެކަންފަދައިން ނޫންނޫން ތަންތަނެއް ފިޔަވައި language, މಿತಿތަކާއި އަގު، ނަމަވެސް}`, އެއްވެސް ބަހަކުން ދެއްކި ނަމަވެސް ލިޔުން އަންނަނީ އިނގިރޭސި ބަހުންނެވެ. OpenAI SDKs އެއަށް ގޮވާލަނީ 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);

Embëdings

ސަރޗް ކުރުމަށާއި، ކުލަސްތަކުގައި ބެހެއްޓުމަށާއި، އަދި އެއްވަރު ކަންތައްތައް ފယ်ކުރުމަށްޓަކައި ލިޔުންތަކަކީވެސް ވެކްޓަރުތަކަކަށް ބަދަލުކުރެއެވެ. މޮޑެލްތަކަކީ ކްލައުޑްފްލެއަރީގައި ހިންގާ އެއްޗެހިތަކެއެވެ އަދި އާންމު ބެލެންސް ބޭނުންކުރެއެވެ.

POST https://nymbot.ai/api/v1/embeddings — އޭޕީއައި ކީއެއް (API key) ބޭނުންވަނެއިރު، ނުވަތަ ކޮންމެ ރިކުއެސްޓަކުން ލައިޓްނިންގ ފައިމަންޓެއް.

މޮޑެލްސް ລިސްޓަކީ ކޮން މޮޑެލްތަކެއް ހިމެނޭކަމާއި، އެއީ ކޮން އަދަދެއްގެ ފީއެއް ކުރަންޖެހޭކަން ދެނެގަތުމަށް ބޭނުންކުރާ އެންމެ އިތުބާރުހުރި މައުލޫމާތުގެ ސޫސްތެކެވެ. އެ ކެޓަލޮގުގައި އަގު ކަނޑައެޅިފައިވާނަމަ، އެދެކު Google ގެ EmbeddingGemma (އިދާރީ ކަމަށް އެދި ކުރުކޮށްލެވޭވެކްޓަރުތަކާއެކު) އެތަނުގައިވެ ފެންނާނެއެވެ. Embeddings ބޭނުންކުރާނީ އިންޕުޓް ޓޯކަންތަކާ ގުޅިގެންނެވެ. އަދި ކޮންމެ ރިކުއުސްޓަކަކަށް 0.05 ކްރެޑިޓްގެ އަދަދެއްގެ މިންނަމެއް (minimum) ކުރަންޖެހޭނެއެވެ; އެއީ ކޮންމެ އިންޕުޓަކަކަށް ނޫން، ކޮންމެ ރިކުއުސްޓަކަށް އެވެ. އެހެންކަމުން، ވަރިގަޑި ލިޔުންތަކެއް ވަކިން ވަކިން ފޮނުވުމުގެ ބަދަލުގައި، އެތަކެއް އެއް ރިކުއުސްޓަކުގައި ބެހެއްޓުމަކީ ވަރަށް ހެޔޮ އަދަދެއްގައި ކުރެވޭ ކަމެކެވެ.

ޖަވާބު

{
  "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 }
}

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);