پایگاه دانش / توسعه دهندگان

تصاویر، صوتی و انبوه

ژنراتورها از برنامه، و بلوک های ساختار برای جستجو: عکس ها، ویدئو، سخنرانی، نقل و نصب، هر یک برای استفاده از حساب شما.

این صفحه برای سهولت به صورت ماشینی ترجمه شده است. نسخه اصلی انگلیسی نسخه ای است که اعمال می شود.

ایجاد تصاویر

یک تا چهار عکس از یک دستورالعمل ایجاد می کند و آنها را هنگامی که انجام می شود باز می گرداند. ?image در App

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 sats) یک تصویر. هر ژنراتور دیگر صرف اعتبار Pro در قیمت خود را، با هزینه معمول و مزایای، به عنوان در این app. n قیمت عکس n یک زمینه که یک ژنراتور دریافت نمی کند، به جای آنکه رد شود، از آن خارج می شود؛ ژنراتور استاندارد فقط از پمپ استفاده می کند.

resolution استفاده نمی شود: هر ژنراتور اندازه خود را ایجاد می کند. urlهر تصویر به یک میزبان عمومی Blossom اپل می شود و شما لینک آن را دریافت می کنید (کثیری از ژنراتورها تنها یک لینک از خودشان را باز می دهند که به آن انتقال می شود). آتش چه می بیندبا b64_json عکس در پاسخ باز می گردد و هرگز بارگذاری نمی شود. data: URL در image_url بررسی می شود به همان شکل که یک Edit و اول به 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);

تصاویر Edit

تغییر یک تصویر که شما ارسال می کنید، به دنبال یک دستورالعمل است.این نقطه انتهای Edit OpenAI است، بنابراین OpenAI SDKs images.edit کار می کند همانطور که است. فقط ژنراتورهای Pro با edit در لیست مدل آن را بپذیرید.

POST https://nymbot.ai/api/v1/images/edits - نیاز به کلید API، یا پرداخت Lightning بر اساس درخواستاین بدن است multipart/form-dataتا 32 MB

تصویر که شما اپل می کنید به عنوان یک 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"));

ویدیو

یک ویدئو چند دقیقه طول می کشد، بنابراین در زمینه اجرا می شود. شما آن را ارسال می کنید، بلافاصله یک هویت دریافت می کنید و درباره هویت بپرسید تا زمانی که تمام شود.

POST https://nymbot.ai/api/v1/videos - نیاز به کلید API، یا پرداخت Lightning بر اساس درخواستبازگشت 202.

قیمت زمانی است که شما ارسال می کنید، از ژنراتور، صدور و طول، بنابراین آن را از توازن حرفه ای خود محاسبه می شود هنگامی که ارائه دهنده کار را قبول می کند، و به عنوان نشان داده می شود. cost, estimated_cost و nymbotاگر ارائه دهنده این کار را رد کند، هیچ چیز محاسبه نمی شود.اگر rendering بعداً ناکام می شود، یا کلپ کامل نمی تواند ذخیره شود و ارائه دهنده آن را حساب نکرده است، هزینه یک بار، به طور خودکار بازگردانده می شود. یک rendering که هنوز بعد از یک ساعت ادامه دارد، رد می شود و هزینه خود را حفظ می کند، زیرا ارائه دهنده یک render را حساب می دهد هنگامی که آن را پذیرفته است.

پاسخ دادن (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، مانند تصاویر تولید شده است.

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 در OpenAI SDKs کار می کند.

POST https://nymbot.ai/api/v1/audio/speech - نیاز به کلید API، یا پرداخت Lightning بر اساس درخواست.

صدای استاندارد هزینه یک 3 اعتبار استاندارد (30 sats) یک درخواست، به عنوان در برنامه است. Aura 2 است Pro، قیمت توسط شخصیت های شما ارسال می شود. Content-Typeاین هزینه ها در X-Nymbot-Cost-Sats اگر مدل سخنرانی ناکام شود، هیچ چیز محاسبه نمی شود.

پاسخ

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

(audio bytes)

cURL

curl https://nymbot.ai/api/v1/audio/speech \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "aura-2", "voice": "luna", "input": "Your invoice has been paid."}' \
  --output speech.mp3

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

audio = client.audio.speech.create(
    model="aura-2",
    voice="luna",
    input="Your invoice has been paid.",
)
audio.write_to_file("speech.mp3")

JavaScript

import { writeFile } from "node:fs/promises";
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const audio = await client.audio.speech.create({
  model: "aura-2",
  voice: "luna",
  input: "Your invoice has been paid.",
});
await writeFile("speech.mp3", Buffer.from(await audio.arrayBuffer()));

مدل های صوتی و صدا

دو لیست عمومی برای انتخاب یک مدل سخنرانی و صدا، یا یک مدل ترجمه وجود دارد 41 Aura 2 زبان انگلیسی و چهار زبان MeloTTS.

GET https://nymbot.ai/api/v1/audio/models نیازی به کلید ندارد.

GET https://nymbot.ai/api/v1/audio/voices?language=en نیازی به کلید ندارد.

پاسخ ها (Voices)

{
  "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، یا پرداخت Lightning بر اساس درخواستاین بدن است multipart/form-data.

برای فایل های WAV، WebM، MP4 و Ogg، طول آن قبل از انجام هر کاری از فایل خوانده می شود، بنابراین ضبط بیش از 30 دقیقه به جلو (با 3 ثانیه) رد می شود. طول یک فایل WAV از نرخ نمونه، کانال ها و اندازه نمونه خود می آید. طول فرمت های دیگر، مانند MP3، نمی تواند به جلو خوانده شود، بنابراین آنها توسط اندازه محدود می شوند: در کمترین نرخ بیتی Nymbot فرض می کند، 8 kbps، 30 دقیقه است 1.8 MB، و یک فایل بزرگ تر در این فرمت با 413 audio_too_long ارسال ضبطات طولانی تر به عنوان WAV، WebM، MP4 یا Ogg. اگر پس از شنیدن گزارش بیش از 30 دقیقه، درخواست را رد می کند. 413 audio_too_longو از آنجایی که شنوایی اجرا شد، 30 دقیقه شارژ می شود.

شما برای طول صوتی پرداخت می کنید، به ثانیه دور شده: طولانی ترین خواندن از فایل، طول گزارش های Whisper، و حداقل اندازه فایل اجازه می دهد، در قیمت هر دقیقه از Whisper با هزینه معمول و مزایای، و حداقل 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 نیستند، هزینه در عنوان است.

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

Embeddings

متن را به ویکتورها برای جستجو، جمع آوری و deduplication تبدیل می کند.The models run on Cloudflare and spend the standard balance.

POST https://nymbot.ai/api/v1/embeddings - نیاز به کلید API، یا پرداخت Lightning بر اساس درخواست.

لیست مدل ها منبع حقایق است که برای آنها در دسترس هستند و چه هزینه دارند؛ 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);