علم جو بنياد ترقی ڪندڙ
تصویر، آڊیو ۽ ایمبیڊنگ
ان اپليڪيشن جي جنرات، ۽ تلاش جي بنديون: انځورون، ویڈیو، ڳالھائڻ، ترجمو ۽ داخل ٿيڻ، هر هڪ توهان جي حساب کان استعمال لاء.
هي صفحو سهولت لاءِ مشين سان ترجمو ٿيل آهي. انگريزي اصل نسخو آهي جيڪو لاڳو ٿئي ٿو.
تصوير پيدا ڪرڻ
اُن وقت اُنھن کي اُن وقت اُنھيءَ وقت اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زماني ۾ اُنھيءَ زمان ?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 تائین |
sizeaspect_ratioqualitynegative_promptoutput_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). |
413 | 20 مگابٽ کان وڌيڪ (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" اھو ویجھی تناسب بڻجی ویندو آھی |
resolutionquality | اسٽرنگ | نہ نہ | هڪ جي جنوري 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-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 سيڪڙو |
نمونن جي فہرست سچ جي منبع آهي جن لاء موجود آهن ۽ انهن کي خرچ ڪن ٿا؛ گوگل جي 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);