مواد ڏانهن وڃو
واپس Nymbot

علم جو بنياد ترقی ڪندڙ

تصویر، آڊیو ۽ ایمبیڊنگ

ان اپليڪيشن جي جنرات، ۽ تلاش جي بنديون: انځورون، ویڈیو، ڳالھائڻ، ترجمو ۽ داخل ٿيڻ، هر هڪ توهان جي حساب کان استعمال لاء.

تصوير پيدا ڪرڻ

اُن وقت اُنھن کي اُن وقت اُنھيءَ وقت اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زمان ?image ایپ ۾

POST https://nymbot.ai/api/v1/images/generations - ھڪ API ڪنجی جی ضرورت آھی، یا توهان جي درخواست تي Lightning ادا ڪرڻ.

اِهو منجھان GET /api/v1/models?type=imageجيتري جي معيار، @cf/black-forest-labs/flux-1-schnellھڪ تصویر جی قیمت فلیٽ 5 معیاری ڪریڊٽ (50 سیٽ) آھی۔ ہر ٻیو جنریٽر پنھنجی قیمت تی پرو ڪریڊٽ خرچ ڪری ٿو، عام فیس ۽ مارجن سان، جیئن ان App. n سينگيءَ جو خرچ n هڪ جينر جي جنوريٽ نه آهي، پر ان جي قبول نه ڪيو ويندو آهي؛ معيار جنوريٽ صرف ان کي استعمال ڪري ٿو.

فیلڊقسمضروری آھیوضاحت
modelاسٽرنگهاہڪ جنریٽر ID، جہڙوڪ nano-banana.
promptاسٽرنگهاڇا ڇڪیو وڃی۔ صرف پہرین 2, 000 اکرن جو استیمال ڪیو ویندو آھی۔
nانٽرونہ نہ1 - 4 - 1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 - 1 num_images.
sizeاسٽرنگنہ نہمثال طور، مثال طور، مثال طور "16:9"، یا ہڪ اوپنائی سائیز جہڙوڪ "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اسٽرنگنہ نہشروع ڪرڻ لاء: هڪ https:// ان ۾ وڌيڪ 4،096 حُڪمن سان ڪو استعمال ڪرڻ وارو نام يا پاسپورٽ نه آهي. data:image/…;base64 یو آر ایل (پی این جی، جی پی ای جی، ویب پی یا GIF ؛ SVG نہ) editانھن جی ضرورت آھی جن سان requires_image_url.

resolution استعمال نہ ڪیو ویو آھی ہر جنریٽر پنھنجی سائیز ٺاہی ٿو urlهر صورة کي هڪ عام Blossom میزبان تي اپ لوڊ ڪيو وڃي ٿو ۽ توهان ان کي رابطي حاصل ڪندؤ (سڀ جنوريز صرف انهن لاءِ هڪ رابطي واپس ڏيندا آهن، جيڪو انهن کي منتقل ڪيو وڃي ٿو). API ڇا ڏسی سگہی ٿوسان گڊ 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جنریٽر ناڪام ٿیو (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);

تصويرن کي

ھڪ تصویر کی تبدیل ڪری ٿو جیڪا توہان اپ لوڊ ڪیو ٿا، ہڪ پرامپٽ جی پٺیان ہی اوپنائی جو ترمیم آخری پوائنٽ آھی، تنہنڪری اوپنائی ایس ڊی ڪی ' images.edit ڪم ڪری ٿو جیئن اھو آھی صرف پرو جنریٽرز سان edit ماڊل لسٽ ۾ ان کی قبول ڪریو

POST https://nymbot.ai/api/v1/images/edits - ھڪ API ڪنجی جی ضرورت آھی، یا توهان جي درخواست تي Lightning ادا ڪرڻجسم ائین آھی۔ multipart/form-dataاهو 32 MB تائين آهي.

فیلڊقسمضروری آھیوضاحت
imageفليٽهابيان ڪرڻ لاء تصوير: PNG، JPEG، WebP يا GIF، تائين 20 MB. image[]؛ پہریون ہڪ استعمال ڪیو ویندو آھی
promptاسٽرنگهاڇا بدلائيندو آهي.
modelاسٽرنگهاجنرگر سان گڏ edit.
nانٽرونہ نہ1 کان 4 تائین
size
aspect_ratio
quality
negative_prompt
output_format
اسٽرنگنہ نہجي نسل ۾ .
response_formatاسٽرنگنہ نہ"b64_json" (ھتی ڊیفالٽ) یا "url".

توہان جی اپ لوڊ ڪیل تصویر کی چ-ی طرح سان ٺہیل PNG، JPEG، ویب پی یا GIF طئور چیڪ ڪیو ویندو آھی، ان کی ان جی حقیقی قسم جی طئور تی موڪلیو ویندو آھی، ۽ عوامی بلوم میزبان تی رکیو ویندو آھی، ڇاڪاڻ تہ جنریٽر لنڪ ذریعی پنھنجی ان پٽ حاصل ڪندا آھن۔ ان کی عوامی طئور تی وٺو۔ جیڪڏھن ترمیم ناڪام ٿئی ٿی ۽ ڪجھ بہ چارج نہ ڪیو وڃی، میزبان ڪاپی وری ختم ٿی ویندی آھی۔ جواب نسل جی شڪل وانگر آھی۔ قیمت جنریٽر جی قیمت آھی، جنہن ۾ ڪجھ جنریٽرن لاء ان پٽ تصویر لاء چارج شامل آھی

جواب ڏیو

{
  "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).
41320 مگابٽ کان وڌيڪ (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 بابت پڇو جیستائین اہو نہ ٿی وڃی۔ ہر ویڊیو جنریٽر پرو بیلنس خرچ ڪری ٿو

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 جواب ۾ ۽ قیمت جي پٺيان.
aspect_ratioاسٽرنگنہ نہمثال طور "16:9" یا "9:16"ہڪ سائیز جیئن "1280x720" اھو ویجھی تناسب بڻجی ویندو آھی
resolution
quality
اسٽرنگنہ نہهڪ جي جنوري resolutions ماڊل لسٽ ۾، جیئن "720p" یا "1080p"اھو قیمت مقرر ڪری ٿو۔ ٻی ڪنھن بہ شیء سان انڪار ڪیو ویندو آھی unsupported_resolution.
image_urlاسٽرنگنہ نہشروع ڪرڻ لاء: هڪ https:// لنڪ یا ای data:image/… URL، جنهن کي هڪ عام Blossom میزبان تي اوليو ويندو. requires_image_url.

قیمت مقرر ڪئی وئی آھی جڏھن توہان جمع ڪیو ٿا، جنریٽر کان، ریزولیوشن ۽ ڊیگہہ، تنہنڪری اھو توہان جی پرو بیلنس مان چارج ڪیو ویندو آھی جیئن ئی فراہم ڪندڙ نوڪری قبول ڪری ٿو، ۽ ڏیکاریو ویو آھی 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 شروع ڪرڻ لاء in_progressيا completed ویڊیو سان اڳ ۾ ئی data جڏھن جنریٽر ان کی سڌو موٽایو۔

ویڊیو تی چیڪ ڪری رھیو آھی

GET https://nymbot.ai/api/v1/videos/{id} توهان کي ان جي ضرورت آهي جو توهان کي ان جي ضرورت آهي جو توهان کي ان جي ضرورت آهي جو توهان کي ان جي ضرورت آهي.

اھو جواب ڏئی ٿو 202 جڏھن تہ ویڊیو ٺاہی پئی وڃی ۽ 200 ھڪ دفعو اھو ختم ٿی ویو یا ناڪام ٿی ویو۔ ہر 5 کان 10 سیڪنڊن ۾ پڇو۔ ہر چیڪ مہیا ڪندڙ کان ہڪ ڀیرو پڇی ٿو ۽ ھڪ ئی وقت جواب ڏئی ٿو اھو ڪڏھن بہ ویڊیو جو انتظار نٿو ڪری 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ڪو به ڪم ناپسند ٿي سگهي ٿو. 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پرو توازن کي ویڈیو کي ڪڍي نه ٿو سگھي.
404اہڙو ڪو جنریٽر نہ آھی (model_not_found)، یا توھان جی NIM لاء ان ID ذریعی ڪا نوڪری ناہی، یا اھو 24 ڪلاڪن کان وڌیڪ پراڻو آھی (video_not_found).
429توھان جی NIM وٽ اڳ ۾ ئی 10 ویڊیوز رینڊرنگ آھنvideo_jobs_limit) انھن تی چیڪ ڪریو ۽ ھڪ ڀیرو ختم ٿیڻ کان پوء وڌیڪ جمع ڪریو
502جنريئر ڪم جو رد ڪيو آهي. ڪنهن به شيء کي چارج نه ڪيو آهي جيستائين پروفيسر ان تي چارج ڪيو آهي.
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 اوپنائی SDKs ۾ ڪم ڪری ٿو

POST https://nymbot.ai/api/v1/audio/speech - ھڪ API ڪنجی جی ضرورت آھی، یا توهان جي درخواست تي Lightning ادا ڪرڻ.

فیلڊقسمضروری آھیوضاحت
modelاسٽرنگنہ نہموسيقي نموني کان آڊیو ماڊل لسٽڊیفالٽ: معیاری آواز، @cf/myshell-ai/melotts. aura-2 اهو Deepgram Aura 2 آهي.
inputاسٽرنگهاپڙھڻ لاء متن: معیاری آواز لاء 800 اکرن تائین، آورا 2 لاء 2, 000
voiceاسٽرنگنہ نہمان ہڪ آواز ID آواز جی فھرست: ہڪ آورا اسپیڪر جہڙوڪ luna يا aura-2-luna-en)، یا ہڪ میلوٽس ٻولی (en, es, fr, zh). اوپنائی آواز جا نالا جہڙوڪ alloy قبول ڪیا ویا آھن ۽ ماڊل جی ڊیفالٽ آواز ڏیو
languageاسٽرنگنہ نہٻولیء جو ڪوڊ جیئن تہ esآواز کان سواء، اھو ان ٻولیء لاء ہڪ چونڊیندو آھی۔ ہڪ آواز جیڪو ٻی ٻولی ڳالھائیندو آھی موٽندو آھی 422 voice_language_mismatch، ۽ ہڪ ٻولی ماڊل لاء ڪو آواز ناہی 422 unsupported_language.
response_formatاسٽرنگنہ نہمعیاری آواز موٽندو آھی mp3 صرف آورا 2 موٽندی آھی mp3 (ڊیفالٽ)، opus, aac, flac, wav یا pcm.
speedنمبرنہ نہقبول ڪیو ویو ۽ نظر انداز ڪیو ویو

معیاری آواز جی قیمت ھڪ درخواست تی فلیٽ 3 معیاری ڪریڊٽ (30 سیٽ) آھی، جیئن ایپ ۾ آھی۔ آورا 2 پرو آھی، قیمت انھن ڪردارن جی آھی جیڪی توہان موڪلیو 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)
حالتڪڏھن
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 آورا 2 انگریزی ڳالہائیندڙ ۽ چار میلوٽس ٻولیون

GET https://nymbot.ai/api/v1/audio/models - ڪا ڪنجی جی ضرورت ڪانہی۔

GET https://nymbot.ai/api/v1/audio/voices?language=en - ڪا ڪنجی جی ضرورت ڪانہی۔

فیلڊقسمضروری آھیوضاحت
languageتار (سوال)نہ نہفقط هن زبان لاءِ آواز آهي.
modelتار (سوال)نہ نہان نموني لاءِ فقط آواز آهي.

جواب (آواز)

{
  "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 سان ھڪ ریڪارڊنگ کی متن ۾ تبدیل ڪری ٿو ہی اوپنائی جو ٽرانسڪرپشن آخری پوائنٽ آھی 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 منٽن سان). WAV فائلن جي طول سندس نموني فٽ، چینلن ۽ نموني سائز مان آڻي ٿو. MP3 وانگر، ٻين فارمن جي طول، اڳي نه پڙهي سگھي ٿو، پوءِ انهن جي سائز تي محدود آهن: وڌيڪ بائٹ فٽ تي Nymbot فرض ڪري ٿو، 8 kbps، 30 منٽن ۾ 1.8 MB آهي. 413 audio_too_long ڪجھ بہ ہلائڻ کان اڳ۔ گہڻی ریڪارڊنگ موڪلیو جیئن تہ ڊبلیو ای وی، ویب ایم، ایم پی 4 یا اوگ۔ جیڪڏھن وسپر پوء 30 منٽن کان وڌیڪ رپورٽ ڪری ٿو، درخواست سان انڪار ڪیو ویندو آھی 413 audio_too_long، ۽ جڏھن کان وسپر ڊوڙی رھیو آھی، 30 منٽ چارج ڪیا ویا آھن

توہان آڊیو جی ڊیگہہ لاء ادا ڪیو ٿا، ٻئی تائین گول ڪیو: فائل مان پڙھڻ جی ڊیگہہ جی ڊگہی ڊیگہہ، وائیسپر رپورٽ جی ڊیگہہ، ۽ گھٽ ۾ گھٽ فائل جی سائیز جی اجازت ڏئی ٿی، وائیسپر جی فی منٽ جی قیمت تی عام فیس ۽ مارجن سان، ۽ گھٽ ۾ گھٽ 0. 05 ہڪ درخواست کی ڪریڊٽ ڪیو 402 هر تعادل جي ضرورت کي ڏيندو آهي. اپليڪيشن ۾، آواز پيغام جي ترجمي ڪرڻ آزاد آهي. API تي اهو هميشه چارج ٿيندو آهي.

جواب ڏیو

{
  "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 ایم بی کان مٿی آھی (file_too_largeان کان سواءِ ٻيو ڪو به نه هو، پر ان کان سواءِ ٻيو ڪو به نه هو، پر ان کان سواءِ ٻيو ڪو به هو.audio_too_long).
502اُن سان ڪُوڙ نه ڪُوڙ، ڪُوڙ ڪُوڙ ڪُوڙ نه ڪُوڙ.

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ان کانسواءِ، محدودي ۽ قیمت آهي، پر ان کي هر زبان ۾ انگلينڊ ۾ موٽايو ويو آهي. 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);

ایمبیڊڊڊ

ڳولا، ڪلسٽرنگ ۽ ڊیڊپلیشن لاء متن کی ویکٹر ۾ بدلائی ٿو ماڊل ڪلائوڊ فلیئر تی ھلندا آھن ۽ معیاری بیلنس خرچ ڪندا آھن

POST https://nymbot.ai/api/v1/embeddings - ھڪ API ڪنجی جی ضرورت آھی، یا توهان جي درخواست تي Lightning ادا ڪرڻ.

فیلڊقسمضروری آھیوضاحت
modelاسٽرنگهاهڪ نموني نموني کان GET /api/v1/models?type=embedding.
inputجيتري يا قسمن جي قسمنهاان کان پوء، توهان کي توهان جي فون تي شامل ڪرڻ جي ضرورت نه آهي، توهان جي فون تي شامل ڪرڻ جي ضرورت نه آهي.token_input_unsupportedهر قسم جي نمونن جي ضرورت آهي. context_length، اٽڪل چار بائٽس ھڪ ٽوڪن جی حساب سان گنو ویو
encoding_formatاسٽرنگنہ نہfloat (ڊیفالٽ) یا base64 (لٽل-اینڊین 32-بٽ فلوٽس)
dimensionsانٽرونہ نہهڪڙي نموني يا هڪڙي نموني سان. supported_dimensions انھن مان ہڪ ؛ ویکٹر پوء ننڍو ڪیو ویندو آھی ۽ عام ڪیو ویندو آھی۔ ٻیو ڪجھ بہ انڪار ڪیو ویندو آھی
نمونياندازيمعنيٰ
@cf/baai/bge-m31024 ڪیتریون ٻولیون8, 192 ٽوڪن
@cf/qwen/qwen3-embedding-0.6b1024 ڪیتریون ٻولیون8, 192 ٽوڪن
@cf/baai/bge-large-en-v1.51024 انگریزی512 سيڪڙو
@cf/baai/bge-base-en-v1.5768 - انگلينڊ512 سيڪڙو
@cf/baai/bge-small-en-v1.5384 انگریزی512 سيڪڙو

نمونن جي فہرست سچ جي منبع آهي جن لاء موجود آهن ۽ انهن کي خرچ ڪن ٿا؛ گوگل جي EmbeddingGemma، وڌيڪ مختصر فڪرن جي درخواست تي، ان ۾ موجود آهي، جڏهن ڪاليج ۾ ان لاء هڪ قيمت آهي.

جواب ڏیو

{
  "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_input_unsupportedان کان وڌيڪ 100 ڪلاڪ (too_many_inputs) ؛ ماڊل کان وڌیڪ وقت تائین ہڪ ان پٽ وٺندو آھی (input_too_longاُنهن جو مطلب آهي ته اُن کي ڪنهن به قسم جي نموني نموني نه آهي.unsupported_dimensions).
402معیاری بیلنس تمام گھٽ آھی ایمبیڊنگس ڪڏھن بہ پرو بیلنس استعمال نہ ڪندا آھن
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);