بنکەی زانیاری / گەشەپێدەران

وێنە، دەنگ و ئۆمبێدینگ (embeddings)

دروستکەرەکانی ناو ئەپەکە، و پێکهاتە بنەڕەتییەکانی بۆ گەڕان: وێنە، ڤیدیۆ، دەنگ، وەرگێڕانی دەنگ بۆ نووسین و ئیمبێدینگەکان، هەر دانەیەک بەپێی بەکارهێنان لە هاوسەنگەکەتەوە پارەی لێ دەخرێتەوە.

ئەم لاپەڕەیە بە ئامێری وەرگێڕدراوە بۆ ئاسانکاری. ئەسڵی ئینگلیزی ئەو وەشانەیە کە کاری پێدەکرێت.

دروستکردنی وێنە

لە ڕێگەی ڕەوانییەکەوە (prompt) یەک بۆ چوار وێنە دروست دەکات و کاتێک تەواو بوون دەیکاتەوە. هەمان کۆمەڵەی دروستکەرە وەک ?image لە ئەپەکەدا.

POST https://nymbot.ai/api/v1/images/generations — پێویستی بە کلیفی API هەیە، یان پارەدانێکی لەایتنینگ بە هەر داواکارییەک.

ناسنامەکان لە کوێوە دێن GET /api/v1/models?type=image. جەنەراتۆری ستاندارد، @cf/black-forest-labs/flux-1-schnell، هەر وێنەیەک تەنها ٥ کرێدی ستاندارد (٥٠ sats) تێدەچێت. هەر گێڕەرەوەیەکی تر کرێدی Pro بە نرخەکەی خۆی بەکار دەهێنێت، لەگەڵ کرێ و قازانجی ئاسایی، وەک لە ئەپەکە. n نرخی وێنەکان n هەنگاوێکی زیاتر. کێڵگەیەک کە جەنێریتەرەکە ناگرێتەوە، لە جیاتی ڕەتکردنەوە، دروبڕاوە؛ جەنێریتەری ستاندارد تەنها پرۆمپتەکە بەکاردێنێت.

resolution بەکارنایەتەوە: هەر جێگیرکەرێک قەبارەی خۆی دروست دەکات. لەگەڵ url، هەموو وێنەیەک باردەکرێتە سەر میزەپانتێکی گشتیی Blossom و تۆ لینکەکەی دەستت دەکەوێت (تەنها چەند ژەنێرێک لینکەکەی خۆیان دەدەنەوە، کە دەگوازرێتەوە). هەر کەسێک لینکەکە هەبێت دەتوانێت بیکاتەوە و دووبارە ناگیرێتەوە؛ سەیری بکە APIەکە چی دەبینێتلەگەڵ b64_json وێنەکە دەگەڕێتەوە لە وەڵامەکەدا و هەرگیز بار ناکرێت. وێنەیەک وەک data: URL لەناو 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 }
}

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

دەستکاری کردن af وێنەکان

وێنەیەک دەگۆڕێت کە بەرز دەکەیتەوە، بەپێی داواکارییەک (prompt). ئەمە خاڵی دەستکاریکردنی OpenAIیە، بۆیە SDK-ەکانی OpenAI... images.edit وەک خۆی کار دەکات. تەنها بەرهەمهێنەرانی Pro بە... edit لە لیستی مۆدێلەکە ڕەزی پێ بکە.

POST https://nymbot.ai/api/v1/images/edits — پێویستی بە کلیفی API هەیە، یان پارەدانێکی لەایتنینگ بە هەر داواکارییەکجەستە بریتییە لە multipart/form-data، تا ٣٢ مێگابایت.

وێنەی ئەوەی پێت ئەپڵۆد دەکەیت پشکنین بۆ دەکرێت تا دڵنیاببنەوە کە PNG، JPEG، WebP یان GIFێکی دروستە، و بە جۆرە ڕاستەکەی بۆ ناردراوە، و لە میواندارییەکی گشتیی Blossom دەنوسرێتەوە، چونکە بەرهەمهێنەرەکان داخڵی خۆیان لە ڕێگەی لینکەوە دەهێننەوە. وەک شتێکی گشتی مامەڵەی لەگەڵ بکە. ئەگەر دەستکاریکردنەکە سەرکەوتوو نەبوو و هیچ بڕە پارەیەک نەگیرایەوە، کۆپیی میوانداریکراوەکە دووبارە دەسڕێتەوە. وەڵامەکە هەمان شێوەی هەیە وەک ئەوەی بۆ بەرهەمهێنان بێت. نرخەکە نرخی بەرهەمهێنەرە، کە بۆ هەندێک بەرهەمهێنەر بڕە پارەیەک بۆ وێنەی داخڵکراو لەخۆدەگرێت.

وەڵام

{
  "created": 1790726460,
  "model": "nano-banana",
  "cost": 0.2126,
  "data": [{ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }],
  "nymbot": { "balance": "pro", "charged_credits": 1.817, "charged_sats": 181.7, "balance_credits": 408.791, "balance_sats": 40879.1 }
}

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) وەردەگریت، و پرسیار لەسەر ئایدیەکە دەکەیت تا ئەو کاتەی تەواو دەبێت. هەموو بەرهەمهێنەرێکی ڤیدیۆ هاوسەنگی Pro بەکار دەهێنێت.

POST https://nymbot.ai/api/v1/videos — پێویستی بە کلیفی API هەیە، یان پارەدانێکی لەایتنینگ بە هەر داواکارییەک. گەڕانەوەکان 202.

نرخەکە کاتێک پێشکەشتی دەکەیت جێگیرە، لە ڕێگەی بەرهەمهێنەر، ڕیزبەندی و درێژاییەوە، بۆیە هەر کە دابینکەر کارەکە قبوڵ دەکات، لە باڵانسی Pro ی تۆ دەخرێتەوە و وەک ئەمە نیشان دەدرێت: cost, estimated_cost و nymbotئەگەر دابینکەر کارەکە ڕەتدەکاتەوە، هیچ پارەیەک ناگیرێت. ئەگەر پاشان ڕێندەرەکە شکستی هێنا، یان کلیپە تەواوەکە نەتوانرا پاشەکەوت بکرێت و دابینکەر تێچووەکەی بۆ نەنووسێتەوە، تێچووەکە بە شێوەیەکی ئۆتۆماتیکی جارێک دەگەڕێتەوە. ئەو ڕێندەرەی دوای یەک کاتژمێر هێشتا بەردەوامە وا دادەنرێت کە ڕێژەی گەیشتووە بە کۆتایی، و تێچووەکەی دەمێنێتەوە، چونکە دابینکەر تێچووی ڕێندەرەکە دەنووسێتەوە هەر کە قبوڵیدەکات. گەڕانەوەی پارە (Refund) کرێدیتەکان دەگەڕێنێتەوە بەڵام ژمارەی خەرجکردنی کلیلیەکە کەم ناکاتەوە.

وەڵام (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 کاتێک تەواو بوو یان شکستی هێنا. هەر ٥ بۆ ١٠ چرکەیەک بپرسە. هەر پشکنینێک جارێک لە دابینکەرەکە دەپرسێت و لەوانەیەکدا وەڵام دەداتەوە؛ هەرگیز چاوەڕێی ڤیدیۆکە ناکات. کارەکە بۆ ماوەی ٢٤ کاتژمێر دوای ئەوەی نێردراوە، دەپارێزرێت. GET /api/v1/videos لیستی کۆتا ٥٠ کارەکەی کلیلەکە وەک {"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 یان failedde nakerret . A karêkî شکستی هێناوە هەڵدەگرێت error ({"code": "generation_failed", "message": …}); ئەگەر پارەکەی گەڕاوەبەوە، cost ئایا ٠ و 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ـە، بۆیە audio.speech.create لە ناو OpenAI SDKەکاندا کار دەکات.

POST https://nymbot.ai/api/v1/audio/speech — پێویستی بە کلیفی API هەیە، یان پارەدانێکی لەایتنینگ بە هەر داواکارییەک.

دەنگی ستاندارد بۆ هەر داواکارییەک ٣ کرێدی ستاندارد (٣٠ سات) دەخوازێت، وەک لە ناو ئەپەکەدا. 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()));

مۆدێلەکانی دەنگ و دەنگەکان

دوو لیستی گشتی بۆ هەڵبژاردنی مۆدێلێکی قسەکردن و دەنگ، یان مۆدێلێکی دەنگگۆڕین بۆ دەق. ٤١ قسەکەرێکی ئینگلیزی Aura 2 و چوار زمانی 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 }
  ]
}

لیستی مۆدێلەکان وەڵامەکان دەداتەوە {"object": "list", "data": {"tts": […], "stt": […]}}هەر مۆدێلێکی قسەکردن هاوسەنگی و نرخەکەی دەدات، max_input_chars, response_formats, languages و default_voice؛ مۆدێلی دەسپێکردنی نووسین ناوەکانی تر دەدات، max_file_bytes, max_seconds, شێوازەکان و نرخ بۆ هەر خولەکێک.

cURL

curl https://nymbot.ai/api/v1/audio/models
curl "https://nymbot.ai/api/v1/audio/voices?language=en"

Python

import requests

print(requests.get("https://nymbot.ai/api/v1/audio/models").json())
for voice in requests.get("https://nymbot.ai/api/v1/audio/voices", params={"language": "en"}).json()["data"]:
    print(voice["id"], voice["model_id"])

JavaScript

console.log(await (await fetch("https://nymbot.ai/api/v1/audio/models")).json());
const voices = await (await fetch("https://nymbot.ai/api/v1/audio/voices?language=en")).json();
for (const v of voices.data) console.log(v.id, v.model_id);

گۆڕینی قسە بۆ دەق

بە Whisper تۆمارێک دەگۆڕێت بۆ دەق. ئەمە خاڵی کۆتایی نووسینی OpenAIیە، بۆیە audio.transcriptions.create دەکارێت.

POST https://nymbot.ai/api/v1/audio/transcriptions — پێویستی بە کلیفی API هەیە، یان پارەدانێکی لەایتنینگ بە هەر داواکارییەکجەستە بریتییە لە multipart/form-data.

بۆ فایلەکانی WAV، WebM، MP4 و Ogg، درێژی لە پێش ئەوەی هیچ شتێک کار بکات لە فایلەکە دەخوێندرێتەوە، بۆیە تۆمارکردنی زیاتر لە ٣٠ خولەک ڕەت دەکرێتەوە (لەگەڵ ٣ چرکە کاتێکی زیادە). درێژیی فایلێکی WAV لە ڕێگەی ڕێژەی نموونەی (sample rate)، چەکان (channels) و قەبارەی نموونەکە دەست dəگیرێت. درێژی هەندێک فۆرماتی تر، وەک MP3، لە سەرەتاوە ناخوێندرێتەوە، بۆیە لە ڕێگەی قەبارەوە سنووردار دەکرێن: لە کەمترین ڕێژەی (bitrate) کە Nymbot دایاندەنێت، واتە ٨ kbps، ٣٠ خولەک دەبێتە ١.٨ MB، و فایلێکی گەورەتر لەو فۆرماتە ڕەت دەکرێتەوە بە... 413 audio_too_long پێش ئەوەی هەر شتێک کار بکات. تۆمارە درێژترەکان وەک WAV، WebM، MP4 یان Ogg بنێرە. ئەگەر Whisper هەر لەگەڵ ئەوەش ڕاپۆرتێکی زیاتر لە ٣٠ خولەک پێشکەش کرد، داواکارییەکە ڕەت دەکرێتەوە بە: 413 audio_too_long، و لەبەر ئەوەی Whisper کار کرد، ٣٠ خولەک پارە لەسەر دەخرێت.

تۆ پارە بۆ درێژی دەنگییەکە دەدەی، کە بۆ چرکەیەک جاش پڕ دەکرێتەوە: درێژییەkeزۆرترین لەو درێژیانەی لە فایلەکە دەخوێندرێتەوە، ئەو درێژییەی Whisper ڕاپۆرد دەکات، و کەمترین ئەو بڕەی قەبارەی فایلەکە ڕێگەت پێ دەدات، بە نرخەکەی دەکەمminی Whisper لەگەڵ کرێ و مەرجە ئاساییەکان، و بە کەمترین نرخ 0.05 کرێت بۆ هەر داواکارییەک. پارەکە لە هاوسەنگی ستانداردەوە دەدەی کاتێک دەتوانێت ئەو بڕە ڕاگرتووە بڕوات، و ئەگەر نا لە Pro دەدەی؛ a 402 دەخاتە ڕوو هەر یەکێکی هاوسەنگی چی پێویستە. لە ئەپەکەدا، نووسینی نامەیەکی دەنگ ڕەنگە بێبەرامبەر بێت؛ لە API یەکەدا هەمیشە پارەی لێ دەگیرێت. ئەگەر 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 زمانەکە، ماوەکە و بەشە کاتییەکان زیاد دەکات. بۆ ئەو سێ دانەیەی کە JSON نین، تێچووەکە لە هێڵەکانی سەرەوەدا (headers) هەیە.

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 هەیە، یان پارەدانێکی لەایتنینگ بە هەر داواکارییەکجەستە بریتییە لە 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);

ئەمبێدینگ (Embeddings)

دەق دەگۆڕێت بۆ ڤێکتەر بۆ مەبەستی گەڕان، کۆکردنەوە (clustering) و دووبارەبوونەوە (deduplication). مۆدێلەکان لەسەر Cloudflare کار دەکەن و هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوکات هاوک

POST https://nymbot.ai/api/v1/embeddings — پێویستی بە کلیفی API هەیە، یان پارەدانێکی لەایتنینگ بە هەر داواکارییەک.

لیستی مۆدێلەکان سەرچاوەی ڕاستەقینەیە بۆ ئەوەی بزانرێت کامەیان بەردەستن و نرخەکەیان چەندە؛ 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 }
}

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