Nheyo yezivo / Vanakovaka micheto

Mifananidzo, inzwi nemashoko anomirira zvinhu

Zvinovaka zvinobva kuapp, nezvinhu zvinovaka kutsvaga: mifananidzo, video, kutaura, kunyora zvataurwa nezvakanyorwa uye embeddings, imwe neimwe ichibhadharwa pakuishandisa kubva muhurongwa hwako hwemari.

Peji ino yakaturikirwa nemuchina kuti zvirerukire. ChiRungu chepakutanga ndiyo shanduro inoshanda.

Kugadzira mifananidzo

Inogadzira mifananidzo imwe kusvika ina kubva pane zvinyorwa zvakapiwa uye inozvigadzirira ikadaro. Ndiri mhando imwe chete yemakanza akadai se ?image muchiruramu (app).

POST https://nymbot.ai/api/v1/images/generations — inoda API key, kana kuti kubhadharwa kweLightning panguva imwe chete pachiitwa chikumbiro.

MaID anobva kupi GET /api/v1/models?type=image. Generator yematanho akajairika, @cf/black-forest-labs/flux-1-schnell, inodhura ma 5 standard credits (50 sats) mufananidzo mumwe. Mumwe chete wegenerator anopedza Pro credits pachengeto chavo, nefee yakajairika uye margin, sezvakaita mu iwo app. n Mutengo wemifananidzo n kakawanda zvakanyanya. Nharaunda generator isingatongi haisi kusekwa asi kusiirwa; generator yemagadzirirwo akajairika inoshandisa prompt chete.

resolution haishandiswi: generator imwe neimwe inogadzira saizi yayo. Ne url, mufananidzo wega wega unokwenya paBlossom host yakavhurika uye unowana link yayo (mishandisi mishoma chete inoisa link yavo pachavo, inopfuudzwa). Munhu wese ane link anogona kuivhura uye haizokwaniswe kubviswa zvakare; onai API inogona kuona chii. Na b64_json mufananidzo unodzoka mupinduro uye haupakwi zvachose. Mufananidzo watumirwa sezvinhu a data: URL murini image_url inoongororwa nenzira imwe chete yakafanana ne... shandura uye yakatumirwa kuBlossom pakutanga kuitira kuti generator ikwanise kuitora; inozodzedzwa zvakare kana chikumbiro chikaora pasina kubhadharwa.

Kana dzimwe dze n mifananidzo inofamba zvakanaka inofamba, unobhadharwa chete ne iyo yakabudirira (pamwe chete nayo yose yamupatidzi akakubhadharisai kunyangwe yakapfava), uye nymbot.failed anoti kwakawanda sei vasipo. Kana zvose zvakundikana, chikumbiro chinodzoka 502.

Mhinduro

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

Kuchinja mifananidzo

Inochenesa mifananidzo yaunoburitsa, ichitevedzera mirayiro. Iyi ndiyo edit endpoint yeOpenAI, saka OpenAI SDKs' images.edit inoishanda sezviri. Mazvakaungana anogona kuita chete ne edit muchero we mazita emudhomu gambata izvi.

POST https://nymbot.ai/api/v1/images/edits — inoda API key, kana kuti kubhadharwa kweLightning panguva imwe chete pachiitwa chikumbiroMuviri ndiyo multipart/form-data, kusvika pa 32 MB.

Mufanidzo waunoburitsa anochengetedzwa kuti uve PNG, JPEG, WebP kana GIF yakarongeka, inotumirwa sezvakaipa kwayo, uye inogadzirwa paBlossom host yakamhurira, nekuti masaina anotora zvinhu zvavo kuburikidza nelink. Uite sezvakanaka kuti zviri pachena. Kana kugadziridza kukapfava uye pasina mari ichitorwa, kabhidhi kakamhurira kanopedzwa zvakare. Mhinduro ine chimiro chakafanana neyekugadzirisa. Mari inobhadharwa ndeyemasaina, uye kune mamwe masaina inosanganisira mari yemufanidzo waunopa.

Mhinduro

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

Vhidhiyo

Video inotora maminitsi, saka inoshanda kumashure. Unoinogumisa, unowana id yakatsananguka, uye unobvunza nezve id kusvikira yapera. Generator yemavhidhiyo dzese dzinopedza mari yePro balance.

POST https://nymbot.ai/api/v1/videos — inoda API key, kana kuti kubhadharwa kweLightning panguva imwe chete pachiitwa chikumbiro. Kudzorera 202.

Mutengo wakatsigirira kana wapa, kubva kuugenerata, resolution uye urefu, saka unobhadharwa kubva pamari yako yePro kana muanoora wenyaya anobvuma basa racho, uye unoratidzwa se cost, estimated_cost uye nymbotKana muenzanisi akatadza kuita basa, hapana chinobhadharwa. Kana render ikazozvidzingira mberi, kana clip yakapedzwa isingakwanisi kuchengetwa uye muenzanisi asina kubhadharisa nezvayo, mari inodzorerwa kamwe chete, nenzira yezvinhu. Render iri kuramba ichibuda mushure mehora imwe inodziviswa, uye inoramba iine mari yayo, nekuti muenzanisi anobhadharisa render kana akagamuchira. Kudzorera mari kunodzosa ma credits asi hakuderedzi kushandiswa kwekey count.

Mhinduro (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 inotanga sezvinoti in_progress, kana completed nevideo yakapinda kare data panguva genarata yakadzosa iyo pakarepo.

Kutarisa vhidhiyo

GET https://nymbot.ai/api/v1/videos/{id} — inoda kiyi inenge yaive ye-nym yakatumira izvi. Kiyi yakasvika pakugumira inogona zvichiri kuongorora.

Inopindura 202 panguva video ichigadzirwa uye 200 kana zvapera kana zvakundikana. Bvunza masekondi 5 kusvika ku10. Bvunzo imwe neimwe inobvunza muenzanisi kamwe chete uye inopindura pakarepo; haina kumirira vhidhiyo. Basa rinochengetwa kwemazuva 24 mushure mekunge rakapiwa. GET /api/v1/videos nyanatsa mabasa mashanu ekupedzisira emukuki se {"object": "list", "data": […]}.

Mhinduro (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 ndiko in_progress, completed kana failed. A basa rakakundikana rinotakura error ({"code": "generation_failed", "message": …}); kana mari yacho yakadzorerwa, cost ndeye 0 uye nymbot kuwedzera refunded_credits uye refunded_satsVideo yakagadzirwa iri paBlossom host yakavhurika, sezvako mifananidzo yakagadzirwa.

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

Zvinyorwa kuita kutaura

Anodetemba mashoko nenzwi uye anodzorera file yerunzwisisa pachishandiswa, kwete link. Inzvimbo yeOpenAI yekutaura, nenguva iyo audio.speech.create mu OpenAI SDKs kunoshanda.

POST https://nymbot.ai/api/v1/audio/speech — inoda API key, kana kuti kubhadharwa kweLightning panguva imwe chete pachiitwa chikumbiro.

Mwari wezwi rinozivikanwa anodhura makomichi matatu (30 sats) pakuita chikumbiro chegumigumigu, sezvinofambirana neapp. Aura 2 ndiyo Pro, inodhura zvichienderana nemashoko aunotuma. Mhinduro yemuviri ndeyezwi, ine zvakafanana Content-Type; mutengo uri mu X-Nymbot-Cost-Sats mukoshi. Kana modeli yekutaura ikafaire, hapana chinobhadharwa.

Mhinduro

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

Mamodeli ezwiye nemadzimambo ezwi

Mapeji maviri akatenderwa ekusarudza muenzaniso wekutaura nematauriro, kana muenzaniso wekushandura mazwi kuita zvinyorwa. Pane 41 Aura 2 English speakers neMeloTTS mitauro mina.

GET https://nymbot.ai/api/v1/audio/models — hapana jesi rinodiwa.

GET https://nymbot.ai/api/v1/audio/voices?language=en — hapana jesi rinodiwa.

Mhinduro (mizwi)

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

Mamodeli anonyora mhinduro {"object": "list", "data": {"tts": […], "stt": […]}}. Modhi imwe neimwe yematauriro inopa balance yayo, mutengo, max_input_chars, response_formats, languages uye default_voice; model yekunyora zviri kutaura inopa mazita ayo anozivikanwa nayo, max_file_bytes, max_seconds, maformat nemutengo wechiminitsi imwe.

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

Kutaura kuita zvinyorwa

Inonatsurudza rekoti kuita zvinyorwa neWhisper. Iyi ndiyo OpenAI's transcription endpoint, saka audio.transcriptions.create inoita basa.

POST https://nymbot.ai/api/v1/audio/transcriptions — inoda API key, kana kuti kubhadharwa kweLightning panguva imwe chete pachiitwa chikumbiroMuviri ndiyo multipart/form-data.

Kune mafayera eWAV, WebM, MP4 neOgg, urefu wenguva unodzidzwatwa kubva mufayera asati matanga kutonga chinhu, saka kurekodha kwenguva inopfuura maminitsi makumi matatu kunorambidzwa pakutanga (nekupatsanurwa masekonzi matatu). Urefu hwefayera reWAV unobva pakuverengwa kwe sample rate, nhanho (channels) uye ukuru hwe sample size. Urefu hwemafambisire mamwe, semuenzaniso MP3, haukwanisi kuverengwa pakutanga, saka anobatwa neukuru hwacho: pakuverengwa kwe bitrate yepasi pane zvose inofungwa neNymbot, 8 kbps, maminitsi makumi matatu i 1.8 MB, uye fayera rakakura zvakanyanya mufambisire uyu runorambidzwa ne 413 audio_too_long asati zvinhu zvichitanga. Tumirai mairekodi akareba akaita seWAV, WebM, MP4 kana Ogg. Kana Whisper ikachikudza inopfuura imhando 30, chikumbiro chinorambidzwa ne 413 audio_too_long, uye sezvo Whisper yakashanda, amani makumi matatu anobhadharwa.

Munobhadhara nekuda kwechara kwerekarekwere (audio) kwakareba, kwakakomberedzwa kusvika pamasekonzi: chirevo chakareba pachokwadi chinobva kureva mubhuku, chirevo chinopiwa neWhisper, uye chidiki chacho chinobvumidzwa nekukura kwebhuku, pamutengo weWhisper wepamaminitsi ano, pamwe chete nemutengo wezvakajairika nemukana wekubhadhara, uye kudarika 0.05 credit pese pese kwekuda kwaitwa; Inobhadharwa kubva pane yemanyorerwo akajairika kana ikwanisa kubhadhara mari iyoyo, uye kubva paPro kana isingakwanisi; a 402 anobatsira kuti imwe imwe balance inoda ani. Mumapp, kunyora mashoko ekuita nenyaya inogona kunge isina mubhadharo; paAPI inzvimbo inobhadhariswa kwese kwese. Kana Whisper ikakundikana, hapana chinobhadharwa.

Mhinduro

{
  "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 inodzorera magadzirirwo emashoko asina kurukwa, srt uye vtt dzidza dzezviri pasi, uye verbose_json anowedzera mutauro, kureba kwenguva uye zvikamu zvine nguva. Kune matatu aya asiri JSON, mutengo uri muna 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);

Kushandura kutaura kuenda kuChirungu

POST https://nymbot.ai/api/v1/audio/translations — inoda API key, kana kuti kubhadharwa kweLightning panguva imwe chete pachiitwa chikumbiroMuviri ndiyo multipart/form-data.

Sezvakaitwa nekunyora zviri kutaura, nemakombani akafanana kunze kwekuti language, miganiso ne mutengo, asi zvinyorwa zvinodzoka nemutauro weChirungu pasinei nekuti mutauro upi wakashandiswa. OpenAI SDKs dzinodziidza nekuti 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

Anovandudza zvinyorwa kuita ma vectors ekutsvaga, kudyidzana kwemashoko, uye kubvisa zvakafanana. Ma models anoshanda paCloudflare uye anoshandisa mari yakatarwa.

POST https://nymbot.ai/api/v1/embeddings — inoda API key, kana kuti kubhadharwa kweLightning panguva imwe chete pachiitwa chikumbiro.

Chitsauko chezvinhu zvose chaunoziva pamusoro pekana zvinowanikwa uye mutengo wacho ndechinhu chinonzi chitsauko chemamodeli; Google's EmbeddingGemma, ine mavhekita madiki kana zvichikumbwa, inobatwawo ipapo kana katalogo ichiva nemutengo wayo. Maembeddings anoverengwa maererano neimwe token yekupinda, uye 0.05-credit minimum inoshandiswa pane chikumbiro chimwe chete, kwete pane imwe imwe input, saka kuunganidza zvinyorwa zvakawanda mune chimwe chikumbiro kunodhura zvakanyanya pane kuzvitumira rimwe nerimwe.

Mhinduro

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