Baza e njohurive / Zhvilluesit

Imazhe, audio dhe embeddings

Gjeneratorët nga aplikacioni, dhe blloqet e ndërtimit për kërkim: imazhe, video, fjalim, transkriptim dhe embeddings, secili faturuar për përdorim nga bilanci juaj.

Kjo faqe është përkthyer me makinë për lehtësi. Origjinali në anglisht është versioni që zbatohet.

Krijimi i imazheve

Bëhet një deri në katër imazhe nga një thirrje dhe i kthen ato kur ato janë bërë. ?image Në aplikacionin

POST https://nymbot.ai/api/v1/images/generations - ka nevojë për një çelës API, ose Pagesa Lightning sipas kërkesës.

ids vijnë nga GET /api/v1/models?type=imagePër gjeneratorin e përgjithshëm, @cf/black-forest-labs/flux-1-schnell, kushton një flat 5 kredite standarde (50 sats) një foto. Çdo gjenerator tjetër shpenzon kredite Pro në çmimin e vet, me tarifën e zakonshme dhe marzhin, si në Aplikacioni. n Fotografia kushton n Një fushë që një gjenerator nuk merr bie në vend që të refuzohet; gjeneratori standard përdor vetëm këshillën.

resolution nuk përdoret: secili gjenerator bën madhësinë e vet. url, çdo foto është ngarkuar në një Blossom host publik dhe ju merrni lidhjen e saj (disa gjeneratorë vetëm dorëzojnë një lidhje të tyre, e cila është transmetuar). Çfarë mund të shohë zjarriMe b64_json imazhi kthehet në përgjigje dhe nuk ngarkohet kurrë. data: URL në image_url kontrollohet në të njëjtën mënyrë si një Editë dhe ngarkuar në Blossom së pari në mënyrë që gjeneratori mund të marrë atë; ajo fshihet përsëri në qoftë se kërkesa dështon pa faturim.

Nëse disa nga n fotot dështojnë, ju merrni ato që punuan, janë të ngarkuara vetëm për ato (plus çdo ofruesi faturuar pavarësisht dështimit), dhe nymbot.failed tregon se sa janë të humbur.Nëse të gjithë dështojnë, kërkesa kthehet 502.

Përgjigje

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

Redaktimi i imazheve

Ndryshon një imazh që ngarkoni, duke ndjekur një këshillë.Kjo është pika e fundit e redaktimit të OpenAI, kështu që OpenAI SDK's' images.edit funksionon siç është. vetëm gjeneratorët Pro me edit në listën e modeleve të pranojë atë.

POST https://nymbot.ai/api/v1/images/edits - ka nevojë për një çelës API, ose Pagesa Lightning sipas kërkesësTrupi është multipart/form-dataDeri në 32 MB

Imazhi që ngarkoni kontrollohet për të qenë një PNG, JPEG, WebP ose GIF i formuar mirë, i dërguar si lloji i tij i vërtetë, dhe i vendosur në një bllokues publik, sepse gjeneratorët marrin hyrjen e tyre me lidhje. Trajtojeni atë si publik. Nëse redaktimi dështon dhe asgjë nuk ngarkohet, kopja e hostuar fshihet përsëri. Përgjigja ka të njëjtën formë si për gjenerimin. Çmimi është çmimi i gjeneratorit, i cili për disa gjeneratorë përfshin një tarifë për imazhin e hyrjes.

Përgjigje

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

Video të

Një video merr minuta, kështu që ajo shkon në sfond. ju paraqisni atë, merrni një id menjëherë, dhe pyesni për id derisa të bëhet. çdo gjenerator video shpenzon bilancin Pro.

POST https://nymbot.ai/api/v1/videos - ka nevojë për një çelës API, ose Pagesa Lightning sipas kërkesësKthim 202.

Çmimi është i fiksuar kur ju dërgoni, nga gjeneratori, rezolucioni dhe gjatësia, kështu që ajo ngarkohet nga bilanci juaj Pro sapo ofruesi pranon punën, dhe tregohet si cost, estimated_cost dhe nymbotNëse ofruesi refuzon punën, asgjë nuk ngarkohet.Nëse renditja më vonë dështon, ose klipi i përfunduar nuk mund të ruhet dhe ofruesi nuk ka faturuar për të, tarifa rimbursohet një herë, automatikisht.Një renditje që është ende duke shkuar pas një ore heq dorë, dhe mban tarifën e saj, sepse ofruesi faturon një renditje sapo e pranon atë.Një rimbursim kthen kreditet, por nuk ul numrin e shpenzimeve të çelësit.

Përgjigje (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 fillon si in_progressose completed Videoja tashmë në data kur gjeneratori e ktheu atë menjëherë.

Kontrolloni në një video

GET https://nymbot.ai/api/v1/videos/{id} - ka nevojë për një çelës që i përket nym që e ka dorëzuar atë.

Përgjigjet 202 Ndërsa videoja është duke u realizuar dhe 200 kur ajo është e përfunduar ose ka dështuar. Pyetni çdo 5 deri në 10 sekonda. Çdo kontroll pyet ofruesin një herë dhe përgjigjet në të njëjtën kohë; ajo kurrë nuk pret për video. Një punë mbahet për 24 orë pasi është dorëzuar. GET /api/v1/videos liston 50 punët e fundit të çelësit si {"object": "list", "data": […]}.

Përgjigje (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 është in_progress, completed ose failedNjë punë e dështuar sjell error ({"code": "generation_failed", "message": …}Në qoftë se është kthyer, cost 0 dhe nymbot shtesë refunded_credits dhe refunded_satsVideoja e përfunduar është në një host publik Blossom, si fotot e gjeneruara.

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

Teksti në fjalim

Lexon tekstin me zë të lartë dhe kthen vetë skedarin audio, jo një lidhje. audio.speech.create në OpenAI SDKs punon.

POST https://nymbot.ai/api/v1/audio/speech - ka nevojë për një çelës API, ose Pagesa Lightning sipas kërkesës.

Zëri standard kushton një 3 kredite standarde standarde (30 sats) një kërkesë, si në aplikacion. Aura 2 është Pro, çmimi sipas karaktereve që ju dërgoni. Trupi i përgjigjes është audio, me një përputhen Content-TypeÇmimi është në X-Nymbot-Cost-Sats Nëse modeli i fjalës dështon, asgjë nuk ngarkohet.

Përgjigje

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

Modelet audio dhe zërat

Dy listat publike për të zgjedhur një model të fjalës dhe zërin, ose një model transkripti.Ka 41 folës Aura 2 anglisht dhe katër gjuhë MeloTTS.

GET https://nymbot.ai/api/v1/audio/models Nuk ka çelës të nevojshëm

GET https://nymbot.ai/api/v1/audio/voices?language=en Nuk ka çelës të nevojshëm

Përgjigje (zëri i tyre)

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

Lista e modeleve përgjigjet {"object": "list", "data": {"tts": […], "stt": […]}}Çdo model i fjalës jep ekuilibrin e vet, çmimin, max_input_chars, response_formats, languages dhe default_voiceModeli i transkriptimit jep pseudonimet e tij, max_file_bytes, max_seconds, formatet dhe çmimi për minutë.

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

Fjalimi në tekst

Shndërron një regjistrim në tekst me Whisper.Kjo është pika e fundit e transkriptimit të OpenAI, kështu që audio.transcriptions.create Punë

POST https://nymbot.ai/api/v1/audio/transcriptions - ka nevojë për një çelës API, ose Pagesa Lightning sipas kërkesësTrupi është multipart/form-data.

Për WAV, WebM, MP4 dhe skedarët Ogg gjatësia lexohet nga skedari para se çdo gjë të kandidojë, kështu që një regjistrim mbi 30 minuta është refuzuar përpara (me 3 sekonda). Gjatësia e një skedari WAV vjen nga shkalla e mostrës së saj, kanalet dhe madhësia e mostrës. Gjatësia e formateve të tjera, të tilla si MP3, nuk mund të lexohet përpara, kështu që ato janë të kufizuara nga madhësia: në shkallën më të ulët bit Nymbot supozon, 8 kbps, 30 minuta është 1.8 MB, dhe një skedar më i madh në një format të tillë është refuzuar me 413 audio_too_long Dërgoni regjistrime më të gjata si WAV, WebM, MP4 ose Ogg. Nëse Whisper pastaj raporton më shumë se 30 minuta gjithsesi, kërkesa refuzohet me 413 audio_too_long, dhe pasi Whisper ka shkuar, 30 minuta janë ngarkuar.

Ju paguani për gjatësinë e audios, të rrumbullakosur deri në sekondë: gjatësia më e gjatë e lexuar nga skedari, gjatësia e raportit Whisper, dhe më pak madhësia e skedarit lejon, në çmimin për minutë të Whisper me tarifën e zakonshme dhe marzhin, dhe të paktën 0.05 kredi një kërkesë. 402 Në aplikacion, transkriptimi i një mesazhi zë mund të jetë i lirë; në API ajo është gjithmonë e ngarkuar.

Përgjigje

{
  "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 kthen tekstin e qartë, srt dhe vtt Kthimi i nëntitujve dhe verbose_json shton gjuhën, kohëzgjatjen dhe segmentet e kohëzgjatura. Për tre që nuk janë JSON, kostoja është në krye.

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

Përkthimi i fjalimit në anglisht

POST https://nymbot.ai/api/v1/audio/translations - ka nevojë për një çelës API, ose Pagesa Lightning sipas kërkesësTrupi është multipart/form-data.

E njëjta si transkripti, me të njëjtat fusha përveç language, kufijtë dhe çmimi, por teksti kthehet në anglisht pavarësisht nga gjuha e folur. 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

Shndërron tekstin në vektorë për kërkim, grumbullim dhe deduplikim.Modelet drejtohen në Cloudflare dhe shpenzojnë bilancin standarde.

POST https://nymbot.ai/api/v1/embeddings - ka nevojë për një çelës API, ose Pagesa Lightning sipas kërkesës.

Lista e modeleve është burimi i së vërtetës për të cilat janë në dispozicion dhe çfarë kushton; EmbeddingGemma e Google, me vektorë më të shkurtër në kërkesë, shfaqet atje edhe kur katalogu ka një çmim për të.

Përgjigje

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