Þekkingargrunnur / Framleiðendur

Myndir, hljóð og embeddings

Framleiðendur frá forritið og byggingarnar til leitar: myndir, myndbönd, tal, transkripsjon og innblástur, hver reiknað fyrir notkun frá jafnvægi þínu.

Þessi síða er vélþýdd til hægðarauka. Enska frumritið er útgáfan sem á við.

Að búa til myndir

Gerir einum til fjórum myndum frá tilkynningu og gefur þeim aftur þegar þeir eru kláraðir. ?image í app þínu.

POST https://nymbot.ai/api/v1/images/generations - þarf API lykil, eða Lightning greiðsla á beiðni.

Ís kom frá GET /api/v1/models?type=imageMeð því að nota venjulegt generator, @cf/black-forest-labs/flux-1-schnell, kostar flat 5 venjuleg kredit (50 sats) á mynd. Hver annar myndavél eyðir Pro kredit á eigin verði, með venjulegum gjald og marg, eins og í Að App. n Myndir kostar n A svið sem generator tekur ekki er kastað frekar en hafnað; venjulegur generator notar aðeins tilkynningu.

resolution er ekki notað: Hver myndavél gerir sína eigin stærð. url, hvert mynd er hlaðið upp á opinbera Blossom gestgjafi og þú færð tengil hennar (einhvers konar myndavélar skila aðeins tengil sínu, sem er gefið áfram). Það sem eldurinn sérmeð b64_json Myndin kemur aftur í svarið og er aldrei hlaðið upp. data: URL í image_url er rannsakað á sama hátt og Edit að og hlaðið upp til Blossom fyrst svo að myndavélin geti náð því; það er eytt aftur ef beiðni misheppnar.

Ef sumir af þeim n myndir misheppnast, þú færð þær sem starfa, eru teknar aðeins fyrir þá (auka hvaða veitingastaður gjaldþrota þrátt fyrir að misheppni), og nymbot.failed segir hversu margir eru saknir. Ef allir misheppnir, sendir beiðni 502.

Svarið

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

Redigera myndir

Breytir mynd sem þú sækir upp, eftir tilkynningu. Þetta er útgáfa Endpoint OpenAI, svo OpenAI SDK's images.edit virkar eins og það er. Aðeins Pro generators með edit á listanum samþykkir það.

POST https://nymbot.ai/api/v1/images/edits - þarf API lykil, eða Lightning greiðsla á beiðniLíkaminn er multipart/form-dataAllt að 32 MB.

Myndin sem þú sendir upp er athugað að vera vel myndaður PNG, JPEG, WebP eða GIF, sent á sem raunverulegur tegund hennar og sett á opinberan Blossom gestgjafi, vegna þess að myndavélin taka upp inntökuna sína með tengil. Hjálpaðu henni sem opinber. Ef ritningin misheppnar og ekkert er hlaðið, er gestgjafa afritin fjarlægð aftur. Svarið hefur sömu mynd og fyrir kynningu. Verðlaunin er verð myndavélsins, sem fyrir sumir myndavélin inniheldur gjald fyrir inntökuna.

Svarið

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

Vídeó

Myndband tekur mínútur, svo það fer í bakgrunni. Þú sendir það, færð ID strax, og spyr um ID þar til það er gert.

POST https://nymbot.ai/api/v1/videos - þarf API lykil, eða Lightning greiðsla á beiðniTil baka 202.

Verðið er fast þegar þú sendir, frá myndavélinni, upplýsingu og lengd, svo það er tekin úr Pro jafnvægi þínu eins fljótt og veitirinn samþykkir starfið, og sýnt er sem cost, estimated_cost og nymbotEf veitirinn neitar vinnunni er ekkert áreiðanlegt. Ef rendering er ekki gert síðar, eða lokið klippið er ekki hægt að geyma og veitirinn hefur ekki reiknað fyrir það, er gjaldið endurgreitt einu sinni, sjálfkrafa. A rendering sem er enn að fara eftir klukkustund er gefinn upp, og geymir gjald sitt, vegna þess að veitirinn gjaldar rendering þegar hann samþykkir það. A endurgreiðsla endurgreiðar kredítin en lækkar ekki kostnaðarkalla lykilsins.

Svarað (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 Byrjaði eins og in_progresseða completed Myndbandið er nú þegar í data Þannig að rafmagninn kom strax til baka.

Skoðað á myndband

GET https://nymbot.ai/api/v1/videos/{id} - þarf lykil sem tilheyrir nym sem sendi það.

Það svarar 202 Þegar myndbandið er í gangi og 200 þegar það er lokið eða hefur mistakast. Spyrja á hverjum 5 til 10 sekúndur. Sérhver skoðun spyr veitirinn einu sinni og svarar í einu; það bíður aldrei eftir myndbandinu. Starfið er haldið í 24 klukkustundir eftir að það var sent. GET /api/v1/videos listar síðustu 50 störf lykilsins sem {"object": "list", "data": […]}.

Svaraðu mér (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 er in_progress, completed eða failedMisheppnuð vinnustað fylgir error ({"code": "generation_failed", "message": …}Ef það er endurgreitt, cost Það er 0 og nymbot Bæta refunded_credits og refunded_satsFullkominn myndband er á opinberu Blossom gestgjafi, eins og myndaðar myndir.

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

Texti í ræðu

Lesi texta hárlega og gefur endurgreiðslunni sjálfu, ekki tengil. audio.speech.create í OpenAI SDKs virkar.

POST https://nymbot.ai/api/v1/audio/speech - þarf API lykil, eða Lightning greiðsla á beiðni.

The venjulegur rödd kostar flat 3 venjulegur kredit (30 sats) fyrir beiðni, eins og í forritinu. Aura 2 er Pro, verðlaunað eftir stafi sem þú sendir. Content-TypeKostnaður er í X-Nymbot-Cost-Sats Ef talamálið misheppnar, er ekkert hlaðið.

Svarið

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

Audio módel og rödd

Tveir opinberir listi til að velja talamódel og rödd, eða transkripsímódel. Það eru 41 Aura 2 ensku tala og fjögur MeloTTS tungumál.

GET https://nymbot.ai/api/v1/audio/models Engin lykill þörf.

GET https://nymbot.ai/api/v1/audio/voices?language=en Engin lykill þörf.

Svör (Röddur í rödd)

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

The Models lista svör {"object": "list", "data": {"tts": […], "stt": […]}}Hvert talamóti gefur jafnvægi sínu, verð, max_input_chars, response_formats, languages og default_voice; transkripsímyndin gefur afrit sínar, max_file_bytes, max_seconds, formi og verð á mínútu.

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

Talað til texta

Hreyfir upptöku í texta með Whisper. Þetta er OpenAI transcription endpoint, svo audio.transcriptions.create Að vinna.

POST https://nymbot.ai/api/v1/audio/transcriptions - þarf API lykil, eða Lightning greiðsla á beiðniLíkaminn er multipart/form-data.

Fyrir WAV, WebM, MP4 og Ogg skrár lengd er lesið frá skrárinu áður en eitthvað er keypt, þannig að upptöku yfir 30 mínútur er hafnað fyrirfram (með 3 sekúndur). Lengd WAV skrár er kominn frá dæmi hraða, kanna og dæmi stærð. Lengd annarra snið, svo sem MP3, er ekki hægt að lesa upp fyrirfram, svo þeir eru takmarkaðir af stærð: við lægsta bitrate Nymbot grunar, 8 kbps, 30 mínútur er 1,8 MB, og stærri skrár í slíku snið er hafnað með 413 audio_too_long Sendu lengri upptökur eins og WAV, WebM, MP4 eða Ogg. Ef Whisper skýrir þá meira en 30 mínútur, er beiðni hafnað með 413 audio_too_long, og þar sem Whisper gekk, 30 mínútur eru hlaðaðir.

Þú ert að borga fyrir lengd hljóðins, hrundið upp í sekúndu: lengsta lengd lesið frá skrárinu, lengd Whisper skýrslur, og minnsta stærð skrár leyfir, á prósent verð Whisper með venjulegum gjald og marg, og að minnsta kosti 0.05 kredit eftirspurn. Það er borgað frá venjulegum jafnvægi þegar það getur náð haldi, og frá Pro annars; 402 gefur það sem hver jafnvægi myndi þurfa. Í forritið er hægt að transkrifa rödd skilaboð ókeypis; á API er það alltaf hlaðið. Ef Whisper missir, er ekkert hlaðið.

Svarið

{
  "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 Endurtakið skýra texta, srt og vtt endurgreiða undirskriftar, og verbose_json bætir við tungumáli, lengd og tímabundið hluti. Fyrir þremur sem eru ekki JSON, kostnaður er í höfundum.

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

Að þýða tal á ensku

POST https://nymbot.ai/api/v1/audio/translations - þarf API lykil, eða Lightning greiðsla á beiðniLíkaminn er multipart/form-data.

Sama og transkriptur, með sömu sviðum fyrir utan language, takmarkanir og verð, en texti kemur aftur á ensku, sama hvaða tungumál var talað. 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);

innblástur

Umbreytir texta í vektorum til að leita, flokka og endurtekna. Mólin fara á Cloudflare og eyða venjulegri jafnvægi.

POST https://nymbot.ai/api/v1/embeddings - þarf API lykil, eða Lightning greiðsla á beiðni.

Listið um gerðir er uppspretta sannleika um hvaða eru í boði og hvað þeir kosta; EmbeddingGemma frá Google, með styttri vektorum á beiðni, birtist þar líka þegar greininni hefur verð fyrir það.

Svarið

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