आशयाचेर वचचें
निम्बॉटा कडेन परत वच.

गिन्यानाचो आदार विकसक

प्रतिमा, ऑडियो आनी एम्बेडिंग्स

ऍप्लिकेशनांतले जनरेटर, आनी सोद करपा खातीर बिल्डींग ब्लॉक्सः चित्रां, व्हिडियो, भाशण, प्रतिलेखन आनी एम्बेडिंग, तुमच्या शिल्लक मदल्यान दर एका वापराचें बिल.

प्रतिमा तयार करतात

प्रॉम्प्टांतल्यान एक ते चार चित्रां तयार करता आनी तीं पूर्ण जातकच परतून दिता. हो जनरेटरांचो तोच संच आसता ?image ऍप्लिकेशनांत.

POST https://nymbot.ai/api/v1/images/generations - एपीआय किल्ली जाय, वा दर विनंत्या प्रमाण वीज फारीकणी.

आयडी हांगाच्यान येतात. GET /api/v1/models?type=imageप्रमाण जनरेटर, @cf/black-forest-labs/flux-1-schnell, एका चित्राक सपाट 5 प्रमाण क्रेडिट्स (50 सॅट्स) लागतात. हेर दरेक जनरेटर प्रो क्रेडिट्स स्वताच्या मोलान खर्च करता, सदांच शुल्क आनी मार्जिन घेवन, जशें सकयल दिल्लें आसा. अ‍ॅप. n चित्रांची किंमत n पटींनी चड. जनरेटर घेवंक नाशिल्लें क्षेत्र न्हयकार दिवचे बदला सोडटात; प्रमाण जनरेटर फकत प्रॉम्प्ट वापरतात.

क्षेत्रप्रकारगरजेचेंवर्णन
modelस्ट्रिंगहयएका जनरेटर आयडी, जशें की nano-banana.
promptस्ट्रिंगहयकितें काडचें. फकत पयले 2000 अक्षर वापरतात.
nपूर्णांकना.1 ते 4. पूर्वनिर्धारीत 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 यू. आर. एल. (पी. एन. जी., जे. पी. ई. जी., वेब. पी. वा जी. आय. एफ.; एस. व्ही. जी. न्हय). फकत जनरेटरांखातीर edit; लागिल्लें तांच्याक ज्यांची requires_image_url.

resolution ताचो वापर करचो नाः दरेका जनरेटरान आपलो आकार तयार करता. url, दर एक चित्र भौशीक ब्लॉसम होस्टाचेर अपलोड जाता आनी तुमकां ताची लिंक मेळटा (कांय जनरेटर फकत स्वताची एक लिंक हातांत दितात, जी फुडें पावयतात). लिंक आशिल्ल्या कोणाकूय ती उगडपाक मेळटा आनी ती परतून काडून उडोवंक मेळना; पळय एपीआय कितें पळोवंक शकतावांगडा. b64_json प्रतिसादांत चित्र परत येता आनी केन्नाच अपलोड जायना. एक चित्र म्हणून धाडलां data: URL आनी image_url तशेच तरेन तपासतात संपादीत कर आनी पयलीं ब्लॉसमचेर अपलोड केलें जाका लागून जनरेटराक तें हाडपाक मेळटलें; विनंती अनबिल करपाक अपेस आयल्यार तें परत काडून उडयतात.

जर कांय 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 - एपीआय किल्ली जाय, वा दर विनंत्या प्रमाण वीज फारीकणी. कूड आसा multipart/form-data, 32 एमबी मेरेन.

क्षेत्रप्रकारगरजेचेंवर्णन
imageफाइलहयसंपादन करपाचें चित्रः पी. एन. जी., जे. पी. ई. जी., वेबपी. वा जी. आय. एफ., 20 एम. बी. मेरेन. image[]; पयलो वापरतात.
promptस्ट्रिंगहयकितें बदलपाक जाय.
modelस्ट्रिंगहयजनरेटर आसा edit.
nपूर्णांकना.1 ते 4.
size
aspect_ratio
quality
negative_prompt
output_format
स्ट्रिंगना.जनरेशनच्या बाबतील.
response_formatस्ट्रिंगना."b64_json" (हांगा पूर्वनिर्धारीत) वा "url".

तुमी अपलोड करतात तें चित्र बरे तरेन तयार केल्लें पी. एन. जी., जे. पी. ई. जी., वेब. पी. वा जी. आय. एफ. अशें तपासतात, ताचो खरें प्रकार म्हूण धाडटात, आनी भौशीक ब्लॉसम होस्टाचेर दवरतात, कारण जनरेटर लिंका वरवीं आपलें इनपुट हाडटात. ताका भौशीक मानात. संपादन अपेशी थारल्यार आनी कांयच शुल्क घेवंक ना जाल्यार, होस्ट केल्ली प्रत परतून काडून उडयतात. प्रतिसाद जनरेशनच्या आकारा सारकोच आसता. किंमत ही जनरेटरची किंमत आसता, जातूंत कांय जनरेटरां खातीर इनपुट पिक्चराक शुल्क आसता.

प्रतिसाद

{
  "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फोटो २० MB परस चड आसा (file_too_large), वा पुराय विनंती 32 एमबी परस चड.
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"));

व्हिडियो

एक व्हिडिओक मिनिटां लागतात, देखून तो पाखडेंत (background) चलता. तुमकां तो सबमिट केल्यार, लगेच एक id मेळटा, आनी तो सकयल जावचे मेरेन तुमकां त्या id विशीं विचारपाचें आसता. प्रत्येक व्हिडिओ जनरेटर प्रो बॅलन्स (Pro balance) खर्च करता.

POST https://nymbot.ai/api/v1/videos - एपीआय किल्ली जाय, वा दर विनंत्या प्रमाण वीज फारीकणीपरत येता. 202.

क्षेत्रप्रकारगरजेचेंवर्णन
modelस्ट्रिंगहयमदलो व्हिडियो जनरेटर आयडी GET /api/v1/models?type=video, जशें veo.
promptस्ट्रिंगहयकितें जातलें.
durationक्रमांक वा स्ट्रिंगना.सेकंदांत लांबाय, 0 परस चड आनी 60 मेरेन. फकत जनरेटरां वरवीं वापरतात जे तुमकां लांबाय निवडूंक दितात; हेर आपली सदची लांबाय करतात, जी आसा seconds प्रतिसादांत आनी ताचे उपरांत दर.
aspect_ratioस्ट्रिंगना.जशें कि "16:9" अतवी "9:16"; एक आकार जशें "1280x720" सगळ्यांत लागींचें प्रमाण जाता.
resolution
quality
स्ट्रिंगना.जनरेटरांतलो एक resolutions मॉडेल वळेरेंत, जशें "720p" अतवी "1080p"तें मोल थारयता. हेर कितेंय न्हयकारतात unsupported_resolution.
image_urlस्ट्रिंगना.सुरवात करपाचें चित्रः अ https:// लिंक वा ए data:image/… यू. आर. एल., जी पयलीं भौशीक ब्लॉसम होस्टाचेर अपलोड करतात. जनरेटरांक जाय पडटा requires_image_url.

जनरेटरांतल्यान तुमी सादर करतना, रिझोल्यूशन आनी लेंग्थ थारायतात, देखून प्रदात्यान काम मान्य करतकच तुमच्या प्रो बॅलन्सांतल्यान शुल्क घेतात, आनी अशें दाखयतात cost, estimated_cost आनी nymbotजर प्रदाता काम नाकारता, तर कसलेच शुल्क लागत ना. जर रेंडर नंतर फेल जाता, वा तयार करतायललो क्लिप सांबाळपाक शकना ना आनी प्रदाता ताचें बिलिंग केलें ना, तर शुल्क एक फावटी स्वयंचलितपणे परतून मेळटा. एको घटरांतपश्यून सुरू आसपीलें रेंडर सोडून दिवपें पडटा, आनी ताचें शुल्क तशेंच उरता, कारण प्रदाता रेंडर स्वीकारिल्ल्या उपरांत ताचें बिलिंग करता. रिफंड केल्यार क्रेडिट्स परतून मेळटात पूण की (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} - सादर केल्ल्या एन. आय. एम. कडेन संबंदीत आशिल्ल्या किल्लीची गरज आसा. कॅपाक पाविल्ली किल्ली अजूनय तपासूंक शकता.

तें जाप दिता. 202 व्हिडियो तयार करतना आनी 200 एकदां तें सोंपतकच वा अपेशी थारल्या उपरांत. दर 5 ते 10 सेकंदांनी विचारात. दर एक चेक प्रदात्याक एक फावट विचारता आनी एकाच वेळार जाप दिता; तो केन्नाच व्हिडियोची वाट पळयता ना. सादर केल्या उपरांत 24 वरां नोकरी दवरतात. GET /api/v1/videos की (key) च्या शेवटल्या ५० कामांची य़ादी अशा दाखयता. {"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 fauky zalea kam kitem gheita error ({"code": "generation_failed", "message": …}); जर तें परतून मेळ्ळें, cost 0 आनी nymbot जोडटा refunded_credits आनी refunded_satsतयार केल्लो व्हिडियो भौशीक ब्लॉसम होस्टाचेर आसा, जशें तयार केल्लीं चित्रां.

स्थितीकेन्ना?
400नात्र प्रॉम्प्ट; 0 ते 60 भायरली काळाची अवधि (invalid_value); एक रिजोल्यूशन जे जनरेटर दिवनासाक (unsupported_resolution); जनरेटराक चित्र ना जाची गरज आसा (image_required); एक मॉडेल जें व्हिडियो जनरेटर न्हय (invalid_model).
402Pro balance भितर व्हिडिओ покрытияंक पावस ना.
404अशें जनरेटर ना (model_not_found), वा तुमच्‍या nym खातीर त्या ID आनी एक लेगीत काम ना, वा तें २४ तासांच्या परस चड पोरणें (video_not_found).
429तुज्या एन. आय. एम. कडेन पयलींच 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 ओपनएआय एसडीके काम करतात.

POST https://nymbot.ai/api/v1/audio/speech - एपीआय किल्ली जाय, वा दर विनंत्या प्रमाण वीज फारीकणी.

क्षेत्रप्रकारगरजेचेंवर्णन
modelस्ट्रिंगना.एक भाशण प्रतिकृती ऑडियो मॉडेलांची वळेरीडिफॉल्टः प्रमाण आवाज, @cf/myshell-ai/melotts. aura-2 दीपग्राम ऑरा 2.
inputस्ट्रिंगहयवाचपाचो मजकूरः प्रमाण आवाजाक 800 अक्षरां मेरेन, ऑरा 2 खातीर 2,000.
voiceस्ट्रिंगना.एक व्हॉईस आयडी आवाजयोंची यादी: एक Aura स्पीकर जशें की 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 वापरून रेकॉर्डिंग टेक्स्टात बदलता. हें OpenAI चें ट्रान्सक्रिप्शन एंडपॉइंट आसा, सो audio.transcriptions.create काम करता.

POST https://nymbot.ai/api/v1/audio/transcriptions - एपीआय किल्ली जाय, वा दर विनंत्या प्रमाण वीज फारीकणी. कूड आसा multipart/form-data.

क्षेत्रप्रकारगरजेचेंवर्णन
fileफाइलहयरेकॉर्डिंग, २५६ बाईट्स सावन ते २५ MB आनी ३० मिनीटां सावन: WAV, WebM, MP4 वा M4A, Ogg वा Opus, MP3 आनी Whisper वाचता ते हेर फॉर्मॅट्स. MP3 आनी हेर ते फॉर्मॅट्स ज्यांचो लांबोपण पयलीं वाचपाक येना, ते १.८ MB सावन मर्यादित आसात.
modelस्ट्रिंगना.पूर्वनिर्धारीत whisper, जें व्हिस्पर लार्ज व्ही3 टर्बो. whisper-1, whisper-large-v3-turbo आनी @cf/openai/whisper-large-v3-turbo ताचो अर्थ एकूच आसा.
languageस्ट्रिंगना.उलोवपाची भास, जशें की en. सोडल्यार सोदून काडटात.
promptस्ट्रिंगना.अपेक्षा करपाचे शब्द वा स्पेलिंग, जशें नांवां. फकत पयले 1,000 अक्षर वापरतात.
response_formatस्ट्रिंगना.json (पूर्वनिर्धारीत), text, srt, vtt अतवी verbose_json.

डब्ल्यू. ए. व्ही., वेबएम, एमपी4 आनी ऑग फायलीं खातीर कितेंय चलचे पयलीं फायलींतल्यान लांबाय वाचतात, देखून 30 मिण्टां परस चड रेकॉर्डिंग मुखार न्हयकारतात (3 सेकंदांच्या ग्रेस वांगडा). डब्ल्यू. ए. व्ही. फायलाची लांबाय ताच्या सॅम्पल रेट, चॅनल आनी सॅम्पल साइजांतल्यान येता. एमपी3 सारकिल्या हेर फॉरमॅटांची लांबाय मुखार वाचपाक शकना, देखून ते आकारा प्रमाण मर्यादीत आसतातः सगळ्यांत उण्या बिटरेटचेर निम्बॉट गृहीत धरता, 8 के. बी. पी. एस., 30 मिण्टां 1.8 एमबी, आनी अशा फॉरमॅटांतली व्हडली फायल अशे तरेन न्हयकारतात 413 audio_too_long कितेंय चालू जावचे पयलीं. लांब रेकॉर्डिंगां डब्ल्यूएवी, वेबएम, एमपी4 वा ओजीजी म्हुणून धाडचीं. व्हिस्पर मागीर 30 मिण्टां परस चड अहवाल दिता जाल्यार, विनंती न्हयकारतात 413 audio_too_long, आनी व्हिस्पर धांवपाक लागिल्ल्यान 30 मिनटां चार्ज जातात.

तुमी ऑडियोच्या लांबाये खातीर फारीक करतात, दुसरे मेरेन गोल करतातः फायलींतल्यान वाचिल्ल्या लांबायेचो सगळ्यांत चड वेळ, व्हिस्पर अहवालांची लांबाय, आनी फायलाचो आकार उण्यांत उणो परवानगी दिता, व्हिस्पराच्या दर मिनटाक दर दिसा सदचे शुल्क आनी मार्जिन घेवन, आनी उण्यांत उणें 0.05 क्रॅडिट विनंती करतात. ती प्रमाण शिल्लक फारीक करतात जेन्ना ती धरून दवरूंक शकता, आनी नाजाल्यार प्रो कडल्यान; 402 प्रत्येक शिल्लक (balance) कें कितें जाय ते सांगता. ॲप प्रमाणे, व्हॉइस मेसेज लिप्यंतरण (transcribing) मोफत आसूं येवंक शकता; पूण API वरी ते सदाच वायद करपाचें (charged) आसता. जर Whisper फेल जाल्यार, कांयच वायद करचें ना.

प्रतिसाद

{
  "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 भास, काळ आनी वेळ विभाग जोडटात. जे. एस. ओ. एन. नाशिल्ल्या तीन विभागांक किंमत हेडरांत आसता.

स्थितीकेन्ना?
400फाइल ना, उपेगी ऑडियो नाशिल्ली फाइल (invalid_audio), अज्ञात स्वरूप, वा प्रतिलेखन मॉडेल नाशिल्लें मॉडेल (invalid_model).
402खंयचेंच संतुलन ताका कव्हर करूंक शकना.
413ही फाइल 25 एमबी परस चड आसा (file_too_large) वा 30 मिण्टां परस चड वेळाचें रेकॉर्डिंग, वा, जाची लांबाय मुखार वाचूंक शकना अशा फॉरमॅटांत, 1.8 एमबी परस चड (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 - एपीआय किल्ली जाय, वा दर विनंत्या प्रमाण वीज फारीकणी. कूड आसा 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 - एपीआय किल्ली जाय, वा दर विनंत्या प्रमाण वीज फारीकणी.

क्षेत्रप्रकारगरजेचेंवर्णन
modelस्ट्रिंगहयएक एम्बेडिंग मॉडेल कडल्यान GET /api/v1/models?type=embedding.
inputstring vo string-ancho arrayहयएम्बेड करपाचें मजकूर, 100 मेरेन रिकामे नाशिल्ले स्ट्रिंग्स. टोकन अॅरे न्हयकारतात (token_input_unsupported). प्रत्येक इनपुट मॉडेलच्या साटें बसपाक जाय context_length, एक टोकन सुमार चार बाइट्स म्हणून मेजतात.
encoding_formatस्ट्रिंगना.float (पूर्वनिर्धारीत) वा base64 (लिटल-एंडियन ३२-बिट फ्लोट्स).
dimensionsपूर्णांकना.मॉडेलाचो स्वताचो आकार, वा त्या मॉडेला खातीर supported_dimensions तातूंतलो एक; मागीर वेक्टर ल्हान करून सामान्य करतात. हेर कितेंय न्हयकारतात.
मॉडेलआयामसंदर्भ
@cf/baai/bge-m31024, जायत्यो भास८,१९२ टोकन्स
@cf/qwen/qwen3-embedding-0.6b1024, जायत्यो भास८,१९२ टोकन्स
@cf/baai/bge-large-en-v1.51024, इंग्लीश५१२ टोकन्स
@cf/baai/bge-base-en-v1.5768, इंग्लीश५१२ टोकन्स
@cf/baai/bge-small-en-v1.5384, इंग्लीश५१२ टोकन्स

मॉडेलांची वळेरी हो सत्याचो स्त्रोत जाचे खातीर उपलब्ध आसा आनी तांचो खर्च कितलो आसा; विनंतीचेर ल्हान वेक्टर आशिल्लो गूगलाचो एम्बेडिंगगेमा, कॅटलॉगांत ताची किंमत आसता तेन्ना थंयय दिसता. एम्बेडिंग्स दर इनपुट टोकनाक मीटर करतात, आनी 0.05-credit उण्यांत उणें दर विनंतीक लागू जाता, दर एका इनपुटाक न्हय, देखून एका विनंतींत जायते मजकूर बॅच करप ते एका वेळार एक धाडपा परस खूब सवाय आसता.

प्रतिसाद

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