Vidensgrundlag / Udviklere

Billeder, lyd og indlejringer

Generatorerne fra appen og byggeblokkerne til søgning: billeder, video, tale, transkription og indlejringer, hver faktureret pr. Brug fra din balance.

Denne side er maskinoversat for nemheds skyld. Den engelske original er den version, der gælder.

Genererer billeder

Optager en til fire billeder fra en prompt og returnerer dem, når de er færdige. ?image På den app.

POST https://nymbot.ai/api/v1/images/generations - der kræves en API-nøgle, eller Lightning betaling efter anmodning.

Ids kommer fra GET /api/v1/models?type=imageDen almindelige generator, @cf/black-forest-labs/flux-1-schnell, koster en flat 5 standard kreditter (50 sats) et billede. Hver anden generator bruger Pro kreditter til sin egen pris, med den sædvanlige gebyr og margin, som i Den app. n Billeder koster n Et felt, som en generator ikke tager, falder i stedet for afvist; standardgeneratoren bruger kun prompt.

resolution ikke anvendes: hver generator gør sin egen størrelse. url, hvert billede uploades til en offentlig Blossom vært, og du får linket (nogle generatorer returnerer kun et link af deres egen, som sendes videre). Hvad branden kan semed b64_json billedet returneres i svaret og uploades aldrig. data: URL til image_url Det kontrolleres på samme måde som en Edit og uploades til Blossom først, så generatoren kan hente det; det slettes igen, hvis anmodningen mislykkes.

Hvis nogle af de n billeder fejler, du får dem, der fungerede, opkræves kun for dem (plus eventuelle leverandøren faktureret på trods af fejlen), og nymbot.failed angiver, hvor mange der mangler. Hvis alle fejler, returneres anmodningen 502.

Svaret

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

Rediger billeder

Ændrer et billede, du uploader, efter en opfordring. Dette er OpenAI's redigering endpoint, så OpenAI SDK's images.edit fungerer som det er. Kun Pro-generatorer med edit På modellen er det accepteret.

POST https://nymbot.ai/api/v1/images/edits - der kræves en API-nøgle, eller Lightning betaling efter anmodningKroppen er multipart/form-dataOp til 32 MB.

Det billede, du uploader, kontrolleres for at være en velformet PNG, JPEG, WebP eller GIF, sendes som sin virkelige type og placeres på en offentlig Blossom-vært, fordi generatorerne henter deres input via link. Behandle det som offentligt. Hvis redigering mislykkes og intet opkræves, slettes den hostede kopi igen. Svaret har samme form som for generation. Prisen er generatorens pris, som for nogle generatorer inkluderer et gebyr for inputbilledet.

Svaret

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

Videoer

En video tager minutter, så den kører i baggrunden. Du indsender den, får et id med det samme, og spørger om id'et, indtil det er gjort.

POST https://nymbot.ai/api/v1/videos - der kræves en API-nøgle, eller Lightning betaling efter anmodningTilbage 202.

Prisen er fast, når du indsender, fra generatoren, opløsning og længde, så den opkræves fra din Pro-balance, så snart udbyderen accepterer jobbet, og vises som cost, estimated_cost og nymbotHvis udbyderen nægter jobbet, opkræves der intet.Hvis renderingen senere mislykkes, eller hvis det færdige klip ikke kan gemmes, og udbyderen ikke har faktureret for det, refunderes gebyret en gang, automatisk.En rendering, der stadig går efter en time, opgives, og beholder gebyret, fordi udbyderen fakturerer en rendering, når den accepterer det.En refundering returnerer kreditterne, men nedsætter ikke nøglenes udgiftskonto.

Svar på spørgsmål (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 Begynder som in_progresseller completed Videoen er allerede i data Så kom generatoren med det samme.

Tjek på en video

GET https://nymbot.ai/api/v1/videos/{id} - har brug for en nøgle, der tilhører den nym, der indsendte den. En nøgle, der har nået sin cap, kan stadig tjekke.

Det svarer 202 Mens videoen bliver lavet og 200 Spørg hver 5 til 10 sekunder. Hver check spørger leverandøren en gang og svarer med det samme; det venter aldrig på videoen. Et job holdes i 24 timer efter det blev indsendt. GET /api/v1/videos Lister de sidste 50 jobs som {"object": "list", "data": […]}.

Svar på spørgsmål (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 eller failedEt mislykket job bærer error ({"code": "generation_failed", "message": …}Hvis det er tilbagebetalt, cost er 0 og nymbot Tilføj refunded_credits og refunded_satsDen færdige video er på en offentlig Blossom vært, ligesom genererede billeder.

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

Tekst til tale

Læser tekst højt og returnerer selve lydfilen, ikke et link. audio.speech.create i OpenAI SDKs fungerer.

POST https://nymbot.ai/api/v1/audio/speech - der kræves en API-nøgle, eller Lightning betaling efter anmodning.

Den standard stemme koster en flat 3 standard kreditter (30 sats) en anmodning, som i appen. Aura 2 er Pro, prissat af de tegn, du sender. Content-TypeOmkostningerne er i den X-Nymbot-Cost-Sats Hvis talemodellen fejler, opkræves der ikke noget.

Svaret

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

Lydmodeller og stemmer

To offentlige lister for at vælge en tale model og stemme, eller en transkriptionsmodel.Der er 41 Aura 2 engelsktalende og fire MeloTTS sprog.

GET https://nymbot.ai/api/v1/audio/models Ingen nøgle kræves.

GET https://nymbot.ai/api/v1/audio/voices?language=en Ingen nøgle kræves.

Svar på spørgsmål (stemmer)

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

Modeller lister svar {"object": "list", "data": {"tts": […], "stt": […]}}Hver tale model giver sin balance, pris, max_input_chars, response_formats, languages og default_voice· Transkriptionsmodellen giver sine aliaser, max_file_bytes, max_secondsPriser og priser pr. 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);

Tal til tekst

Omdanner en optagelse til tekst med Whisper. Dette er OpenAI's transkriptionsendpunkt, så audio.transcriptions.create Arbejder på.

POST https://nymbot.ai/api/v1/audio/transcriptions - der kræves en API-nøgle, eller Lightning betaling efter anmodningKroppen er multipart/form-data.

For WAV, WebM, MP4 og Ogg filer længden læses fra filen, før noget kører, så en optagelse over 30 minutter er nægtet op foran (med 3 sekunders nåde). En WAV fil længde kommer fra dens prøve rate, kanaler og prøve størrelse. Længden af andre formater, såsom MP3, kan ikke læses op foran, så de er begrænset af størrelse: ved den laveste bitrate Nymbot antager, 8 kbps, 30 minutter er 1,8 MB, og en større fil i et sådant format er nægtet med 413 audio_too_long Send længere optagelser som WAV, WebM, MP4 eller Ogg. Hvis Whisper så rapporterer mere end 30 minutter alligevel, afvises anmodningen med 413 audio_too_long, og da Whisper løb, er 30 minutter opkrævet.

Du betaler for længden af lyd, afrundet op til det andet: den længste af længden læst fra filen, længden Whisper rapporter, og det mindste filens størrelse tillader, til Whisper's per-minut pris med den sædvanlige gebyr og margin, og mindst 0.05 kredit en anmodning. 402 Det giver, hvad hver balance ville have brug for. I appen kan transkription af en talemeddelelse være gratis; på API'en oplades det altid.

Svaret

{
  "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 Returnerer klar tekst. srt og vtt Tilbage til undertekster, og verbose_json tilføjer sprog, varighed og timede segmenter. For de tre, der ikke er JSON, er omkostningerne i overskrifterne.

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

Oversættelse af tale til engelsk

POST https://nymbot.ai/api/v1/audio/translations - der kræves en API-nøgle, eller Lightning betaling efter anmodningKroppen er multipart/form-data.

Det samme som transkription, med de samme felter bortset fra language, grænser og pris, men teksten kommer tilbage på engelsk, uanset hvilket sprog der blev talt. 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);

Indsætninger

Omdanner tekst til vektorer til søgning, klassificering og deduplicering.Modellerne kører på Cloudflare og bruger standardbalancen.

POST https://nymbot.ai/api/v1/embeddings - der kræves en API-nøgle, eller Lightning betaling efter anmodning.

Modellisten er kilden til sandheden for hvilke der er tilgængelige og hvad de koster; Googles EmbeddingGemma, med kortere vektorer på anmodning, vises der også, når kataloget har en pris for det.

Svaret

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