Xiseketelo xa vutivi / Vaakuli wa swiendli

Swifaniso, mavuriso na embeddings

Swididisi swo humaka eka app, na swivumbeko swa ku xavisa: xifaniso, video, ku vulavula, ku tsala na embeddings, xin’wana na xin’wana xi hlawulelwa ku tirhisiwa hi ku huma eka mitshelo ya wena.

Tluka leri ri hundzuluxeriwe hi muchini leswaku ri olova. Original ya Xinghezi i version leyi tirhaka.

Ku hlamusela mavumbuluxu

Yi endla mavunga yo ya nkarhu van'we kuya eka van'we hi ku landzela ntolovelo naswona yi ya eka hi ku va ri swi lulamile. I nhlokovelo ya vahengi leyi fanaka na ?image eka app.

POST https://nymbot.ai/api/v1/images/generations — e needa key ya API, kumbe xi hlayisaka hi Lightning hi xinkongomelo xin'we na xikongelo xin'we.

Ma-id ma huma kwihi GET /api/v1/models?type=image. Xitirho xa xiyimo xa xitirho, @cf/black-forest-labs/flux-1-schnell, swikwembu swa 5 standard credits (50 sats) xitshuri ka xifaniso xin'we. Swikwembu swin'wana eka generator xin'wana na xin'wana xi tirhisa Pro credits hi xihundla xa xona, hi xikwembu xa xivalo ni margin, hi ku fana na application ya. n Swikongomisi swa swifaniso n swinharhi swo tanihi. Xiphemu lexi generator a xi nga xi teki xi hihetliwa ku tlula ku nga xi amukeli; generator ya xiyimo yi tirhisa prompt ntsena.

resolution a nga tirhisiwi: xigeveneri xin’wana na xin’wana xi engetela xitsandza xa xona. Na url, xifanaxi xin'wana na xin'wana xi enetiwa eka Blossom host leyi vulavulaka na un'wana na un'wana naswona u kuma xitshuri xayo (generator xin'wana hi ku pfumala ku nyika xitshuri xa vona, lexi fambisiwaka). Mani na mani loyi a nga na xitshuri a nga swi pfula naswona a swi nga ha kumeki swi tswiwa hi ku tlhela; vona API yi nga vona yiniHi. Na b64_json Xifaniso xi ta humelela eka xihlamulo naswona a xi tshami xi humisiwa. Xifaniso lexi hundzisiweke hi ku riya... data: URL eka image_url swi xunyetiwe hi ndlela yinhi hi ku fana na an kumisa naswona ku lumekerisiwa Blossom tinhla leswi generator yi nga swi tekela; swi huriwile hi ku tlhela loko xikombiso xi nga hundzile ku rihlarihlari.

Loko xin'wana ka xin'wana xa... n xifaneti ti pfala, u kuma lava nga ti tirhisiweke, u hlawulelwa mali ta lava (ku kombisa lava ndzhavuko wa xitirho a nga xi bileseke hambiloko swi pfale), naswona nymbot.failed swi vula leswaku ku riki mani lava nga riki. Loko hinkwaswo swi hunguta, xichavo xi vutirhela ntirho 502.

Mpfuxeto

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

Ku cinca swifaniso

U cinca xifanambu lexi u uphamaka na xikombiso. Hi endzone ya ku cinca ya OpenAI, hi leswaku OpenAI SDKs' images.edit swi tirha hi xiyimo xinhi. Swi vula va generators va Pro hi edit e ka nhlamuselo wa model amukela swona.

POST https://nymbot.ai/api/v1/images/edits — e needa key ya API, kumbe xi hlayisaka hi Lightning hi xinkongomelo xin'we na xikongelo xin'we. Minkarhi i multipart/form-data, ku fika 32 MB.

Xifanaxwana lexi u xi pfumeleraka xi xekiwa leswaku i PNG, JPEG, WebP kumbe GIF leyi nene, leyi enetiweke hi xivumbeko xa yona xa ntiyiso, naswona yi vekiwa eka host ya Blossom leyi vulavukaka, hikuva ma-generator ma kuma swilo swa wona hi xihlamuselo xa xinkhonxho (link). Yi t treat-e hi xifanaxwana xa le kusuhi na le kule. Loko ku cinci swi kula naswona ku nga ri na mali leyi tekakawo, xifanaxwana lexi vekiwawo xi huriwa hi ku tlhela. Mhutsalelo wu va ni xivumbeko xin’we na le xitlhokovetselo xa ku hlamusela (generation). Nhlengo wu ri ni nhlengo wa generator, loyi eka ma-generator eman’weni ya ku kumba mali ya xifanaxwana xa xihlamuselo (input picture).

Mpfuxeto

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

Xihlanganiso

Xihundla xin'we xi teka mintirhu ya minavati, hi leswaku xi tshama xi tirha eka nkarhi lowu ndhavulaka. U ri tsalela, u kuma id hi ku tsandzeka, naswona u kombela hi ta id ku fika loko xi xi endleke. Xihundla xin'we xin'we xa ku hlamusela xihundla xi dya masiyano ya Pro.

POST https://nymbot.ai/api/v1/videos — e needa key ya API, kumbe xi hlayisaka hi Lightning hi xinkongomelo xin'we na xikongelo xin'we. Ku khutlela 202.

Ntlangala wu fijiki loko u tshamisiaka, ku sukela eka generator, resolution ni ndzhaka, ka swona wu tekeleriwa eka Pro balance ya wena hi ku tshama loko muhlayeri a amukela ntirho, naswona wu kombisiwa tanihi cost, estimated_cost na nymbotLoko muhumuki a nga pfumeli ntirho lowu, ku nga ri na xin'wana xin'wana lexi hlawulaka. Loko render yi tshama yi nga pfuki, kumbe clip leyi endliweke yi nga athu kumbe ya nga ha vulavami kambe muhumuki a nga ka a nga xi kumisi, mali leyo yi pfumeleriwa ka nkarhi wowun'we, hi ndlela yo tihlanganisa. Render leyi nga tshama yi tirha hi laha ta anchena hi leించు, yi ya nga endliwa, naswona yi tshama yi ri na mali leyo, hikuva muhumuki wu kumisa mali ya render hi ku amukela. Ku pfumeleriswa swi vuyisela credits kambe swi nga ha hinkisi ku fambisa mali ya key.

Mhangulo (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 swi sungula hi ku ri hi in_progress, kumbe completed hi video nga ku tshama eka data loko generator yi dzindza hi ku tsongo.

Ku hlola hi video

GET https://nymbot.ai/api/v1/videos/{id} — swi lava xihloko lexi xumbumbaka nchumu lowu nga enlarweni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga enlarheni ya nchumu lowu nga en

Yi hlamula 202 loko vidiyo yi rikiwa na na 200 Loko swi herile kumbe swa tshama. Byisa masikondi ya 5 ku ya eka 10. Xihlongo xin'wana na xin'wana xi kombela muhumusi ka nkarhi wu'we wu'we naswona xi hlamula hi ku tsandzeka; a xi lulameli video. Ntirho wu hlayeriwa hi swihangu swa 24 nghana loko wu hundzisiwile. GET /api/v1/videos kumisa vuxokoxoko bya mintirho ya 50 ya mhaka ya vukosi hi ku va {"object": "list", "data": […]}.

Muxavela (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 i in_progress, completed kumbe failed. A ntirhandzi lowu nga tsundzuluki wu hlawula error ({"code": "generation_failed", "message": …}); loko e xi khomisiwe mali hi ku tshova, cost xana 0 na nymbot swi engetile refunded_credits na refunded_satsXihloko xa video lexi faneleke xi ri eka blossom host ya le xiyimo xa le xiyimo, hi ku fana na swifaniso leswi hlamusuriweke.

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

Ku tlangela mahlamu hi voko

Yi hlaya rito hi xivulavuri nahlanu naswona yi khutla faya ya rito yo dyondzisiwa, a hi link. I endpoint ya OpenAI ya ku vulavula, ka leswi audio.speech.create e ka OpenAI SDKs swi tirha.

POST https://nymbot.ai/api/v1/audio/speech — e needa key ya API, kumbe xi hlayisaka hi Lightning hi xinkongomelo xin'we na xikongelo xin'we.

Lia rito ra xiyimo ri xupaxela ma credits ya 3 (30 sats) eka xiyime xin'we xin'we, hi ku ri karhi eka app. Aura 2 i Pro, leyi xupaxeleke hi mavunhele ya leswi u tsindzelaka. Xipatisi xa xikwetsi i audio, hi ku pfananela na Content-Type; xigandu xi ri eka X-Nymbot-Cost-Sats header. Loko model ya vuxokoxoko e hlamulaka, a ku riki na nchumu lowu hi wu hlayisaka.

Mpfuxeto

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

Mi ntsandzo wa mavokisi na mivokolovoko ya ntsako

Mitlantsi ya leinene ya ku khesa model ya speech na mavoko, kumbe model ya transcription. Ku na 41 Aura 2 English speakers na tindzimi ta MeloTTS tin’nyanya tin’nyanya ta four.

GET https://nymbot.ai/api/v1/audio/models — a ku lava xivi.

GET https://nymbot.ai/api/v1/audio/voices?language=en — a ku lava xivi.

Mpfungwavalo (minovela)

{
  "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 }
  ]
}

Mi-model yi hlaya miako. {"object": "list", "data": {"tts": […], "stt": […]}}. Mokhodzi wa model ya vuxaka wu nyika xiphiqo xa xona, xikwembu, max_input_chars, response_formats, languages na default_voice; xitimi xa ku tsalela xihlanganiso xi nyika tindhaviso ta xona, max_file_bytes, max_seconds, swindlelo na ntlawulo wa nga miniti.

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

Ku hlamusela vito hi ku tsala

Yi hundzuluxa nkarhi wa ku rila u vaXiveto hi Whisper. Loko i OpenAI's transcription endpoint, hikona so audio.transcriptions.create swi tirha.

POST https://nymbot.ai/api/v1/audio/transcriptions — e needa key ya API, kumbe xi hlayisaka hi Lightning hi xinkongomelo xin'we na xikongelo xin'we. Minkarhi i multipart/form-data.

Hi file ta WAV, WebM, MP4 na Ogg, nkarhi wu tsaleriwe eka file ku ringheta swilo senseka, hi ta leswi ku tisa ku tsala swilo swi nga tani ku fika minaminti 30 (hi nkarhi wa 3 seconds wa ku tisa). Nkarhi wa file ta WAV wu huma eka sample rate, channels na sample size ya wena. Nkarhi wa mafomati lawa mangwalo, ku fana na MP3, a wu kani ku tsaleriwa ku ringheta, hi ta leswi va kumelekile hi nkarhi wa size: eka bitrate ya nkoka, 8 kbps, minaminti 30 i 1.8 MB, naswona file leyi larger eka mafomati lawa yi tiviwa hi ku nga pfumeliwi hi 413 audio_too_long tsichochena swin'wana swi nga karhi swi tshama swi nga riki. Engetela mani eka WAV, WebM, MP4 kumbe Ogg. Loko Whisper a ri kombela swin'wana eka 30 hi minute, xicelo xi nyikiwa ku nirhi hi 413 audio_too_long, naswona eka Whisper a yi tshama yi tirhile, mintanga ya 30 yi kumbelekile.

U xavela nkarhi wa le ka swiantshelwa swa le ka swa mitsalo, u hlawula ehenhla ku ya eka sekondi: nkarhi wo tala wa nkarhi lowu nga kumisiweke eka fayı, nkarhi lowu Whisper a ri kombisaka, na nkarhi lowu tsengelekeke hi nkulu wa nkarhi lowu fayı wu nga xi ensela, hi xabelo xa Whisper xa nkarhi eka nkarhi, hi xabelo xa xikulu ni xihlawulelo xa xivindzi, naswona hi ntshikilelo wa 0.05 credit eka xikombiso xin'wana na xin'wana. Swi riwa hi xabelo xa xiyimbi loko xi nga kota ku hlayisa xitshirhi lexi, naswona hi Pro loko ku nga ri kona; a 402 swi kombisa leswi xikongomelo xin'wana na xin'wana xin'wana xi nga xi lava. Ekuswiti, ku hundzuluxa mbulavulo wa le ka xiyimo xa le xana swi nga va mahala; eka API swi hlawuriwa hi ku tshama. Loko Whisper wu nga hungami, a ku na xin'wana xin'wana le xi hlawuriwaka.

Mpfuxeto

{
  "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 ku khutsa hi ririmi ra ntsako, srt na vtt khumbeka swivuriso, na verbose_json u kombisa ririmi, nkarhi ni swivulavulelo leswi nga ni nkarhi. Eka swo tlhano leswi nga riki JSON, mali i eka tihereiti.

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

Ku hundzuluxa ku vulavula ku ya eka XINGIRISI

POST https://nymbot.ai/api/v1/audio/translations — e needa key ya API, kumbe xi hlayisaka hi Lightning hi xinkongomelo xin'we na xikongelo xin'we. Minkarhi i multipart/form-data.

Ku fana na transcription, hi mindhavuko leyi fanaka yo kalahleka handle ka language, swikongomiso na xigala, kambe mavunyi ma huma hi Xingirisi ku lava ririmi leri ri nga vulavuriweke hi rona. OpenAI SDKs ti dyondza ti dyondza hi 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);

Swivungetelo

Yi hundzuluxa mavumbulovutxi (text) ku va mavumbulovutxi ya ku xavisa, ku hlengeleta na ku xavisa lava fanaka. Ma-model ya tirhisela eCloudflare na ya tirhisa mbulavutxi wa xiyimo xa le hetele.

POST https://nymbot.ai/api/v1/embeddings — e needa key ya API, kumbe xi hlayisaka hi Lightning hi xinkongomelo xin'we na xikongelo xin'we.

Xikongomelo xa mi-model i xinyandzanisi xa ntiyiso hi leswaku i mani lava nga kona ni leswaku va kogela mali; Google's EmbeddingGemma, hi vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila bya vutshila by

Mpfuxeto

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