Ny fototry ny fahalalana / Ny mpandrindra

Ny sary, ny feo ary ny embeddings

Ny solosaina avy amin'ny fampiharana, ary ny fanorenana ho an'ny fikarohana: sary, lahatsary, feo, transkription ary embeddings, tsirairay voasoratra amin'ny fampiasana avy amin'ny tahirin-kevitrao.

Ity pejy ity dia nadika amin'ny milina mba hahamora kokoa. Ny original amin'ny teny anglisy no dikan-teny mihatra.

Ny famoronana sary

Ataon'ny iray ka hatramin'ny efatra sary avy amin'ny fangatahana ary miverina rehefa vita izy ireo. ?image Ao amin'ny App

POST https://nymbot.ai/api/v1/images/generations – mila ny API key, na Lightning fandoavam-bola amin'ny fangatahana.

Avy amin'ny GET /api/v1/models?type=imageNy Generator Standard dia @cf/black-forest-labs/flux-1-schnell, vidin'ny 5 Standard credits (50 sats) ny sary. Ny generator hafa rehetra mandany Pro credits amin'ny vidiny manokana, miaraka amin'ny saram-pandraharahana sy ny marika mahazatra, toy ny Ny App. n Ny sarin'ny vidiny n Ny sehatra iray izay tsy mandray ny generator dia lavo fa tsy voaheloka; ny generator matetika dia mampiasa ny fangatahana fotsiny.

resolution tsy ampiasaina: ny generator tsirairay dia mamorona ny habeny manokana. url, ny sary tsirairay dia nalefa any amin'ny mpizara Blossom ho an'ny daholobe ary azonao atao ny mahazo ny rohy (ny mpamorona vitsivitsy ihany no miverina ny rohy manokana, izay alefa). Ny olona rehetra manana ny rohy dia afaka misokatra ary tsy azo alaina indray; jereo Inona no hitany amin'ny afoAo amin'ny b64_json Ny sary dia miverina amin'ny valin'ny valiny ary tsy naverina. data: Ao amin'ny URL image_url Ny fitsapana dia mitovy amin'ny Edit ny ary nalefa tany amin'ny Blossom voalohany mba hahafahan'ny generator haka azy; dia esorina indray raha tsy nahavita ny fangatahana.

Raha ny sasany amin'ireo n ny sary tsy miasa, dia mahazo ireo izay niasa, dia voavidy fotsiny ho an'ireo (plus na inona na inona ny mpamatsy voavidy na dia tsy nahomby aza), ary nymbot.failed milaza ny isan'ny tsy hita. Raha tsy mahomby ny rehetra, ny fangatahana dia miverina 502.

Ny valiny

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

Fandaharana ny sary

Manova ny sary nalefanao, manaraka ny fampitandremana. Ity no tanjona fanitsiana ny OpenAI, noho izany ny OpenAI SDKs' images.edit miasa amin'ny fomba misy azy io. Ny solosaina Pro ihany edit Ao amin'ny lisitry ny modely dia manaiky izany.

POST https://nymbot.ai/api/v1/images/edits – mila ny API key, na Lightning fandoavam-bola amin'ny fangatahanaNy vatana dia multipart/form-dataMihoatra ny 32 MB.

Ny sary izay alefasanao dia voamarina ho PNG, JPEG, WebP na GIF tsara, nalefa ho toy ny karazana tena izy, ary napetraka ao amin'ny mpizara Blossom ho an'ny daholobe, satria ny mpamorona dia mandray ny fidirana amin'ny rohy. Manao izany ho an'ny daholobe. Raha tsy mahomby ny fanitsiana ary tsy misy na inona na inona, ny kopia voatahiry dia esorina indray. Ny valiny dia mitovy amin'ny endrika toy ny amin'ny famokarana. Ny vidiny dia ny vidin'ny mpamorona, izay ho an'ny mpamorona sasany dia ahitana saram-pidirana ho an'ny sary fidirana.

Ny valiny

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

Ny lahatsary

Ny lahatsary dia mitaky minitra, noho izany dia mihazakazaka ao amin'ny taonjato. Manolotra azy ianao, mahazo ID avy hatrany, ary manontany momba ny id mandra-pahatongan'izany.

POST https://nymbot.ai/api/v1/videos – mila ny API key, na Lightning fandoavam-bola amin'ny fangatahanaMiverena 202.

Ny vidiny dia voafetra rehefa manolotra, avy amin'ny generator, fanapahan-kevitra sy ny faharetan'ny, noho izany dia ampidirina avy amin'ny Pro salan'ny raha vao manaiky ny asa ny mpamatsy, ary hita toy ny cost, estimated_cost SY nymbotRaha mandà ny asa ny mpamatsy, dia tsy misy vola. Raha tsy mahomby ny fampisehoana taorian'izay, na tsy afaka mitahiry ny clip vita ary ny mpamatsy dia tsy nandray karama izany, dia miverina indray mandeha ny karama. Ny fampisehoana izay mbola mitranga aorian'ny ora iray dia voavonjy, ary mitazona ny karama, satria ny mpamatsy dia miverina ny fampisehoana rehefa manaiky izany. Ny famerenana dia miverina ny karama fa tsy mampihena ny habetsaky ny fandaniana.

Ny fanontaniana (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 Manomboka amin'ny in_progressNa ny completed Ao amin'ny lahatsary izay efa data Avy eo dia niverina avy hatrany ny generator.

Jereo ao amin'ny lahatsary

GET https://nymbot.ai/api/v1/videos/{id} - mila fanalahidy ananan'ny nym izay nanolotra azy. Ny fanalahidy izay nahatratra ny kapila dia mbola afaka manamarina.

Ny valiny 202 Rehefa vita ny lahatsary ary 200 rehefa vita na tsy nahomby. Manontany isaky ny 5 ka hatramin'ny 10 segondra. Ny tsindry tsirairay dia manontany ny mpamatsy indray mandeha ary mamaly avy hatrany; tsy miandry ny lahatsary. Ny asa dia voatahiry mandritra ny 24 ora taorian'ny nanolorana azy. GET /api/v1/videos Ity lahatsoratra ity dia mamaritra ny asa 50 farany nataon'ny key toy ny {"object": "list", "data": […]}.

Ny valiny (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 Ny in_progress, completed Ary failedNy tsy fahombiazan'ny asa dia mitondra error ({"code": "generation_failed", "message": …}Raha toa ka efa voavonjy izany, cost 0 ary ny nymbot Ny fanampiny refunded_credits SY refunded_satsNy lahatsary vita dia ao amin'ny tranonkala Blossom, toy ny sary nateraky.

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

Teny amin'ny teny

Vakio ny lahatsoratra mafy ary miverina ny rakitra feo, fa tsy rohy. audio.speech.create Ao amin'ny OpenAI SDKs miasa.

POST https://nymbot.ai/api/v1/audio/speech – mila ny API key, na Lightning fandoavam-bola amin'ny fangatahana.

Ny feo ankapobeny dia mihoatra ny 3 taratasy ankapobeny (30 sats) isaky ny fangatahana, toy ny ao amin'ny fampiharana. Aura 2 dia Pro, mifanaraka amin'ny soratra alefanao. Ny vatana valiny dia ny feo, miaraka amin'ny fifanarahana Content-TypeNy vidiny dia ao amin'ny X-Nymbot-Cost-Sats Raha tsy mahomby ny modely fitenenana, dia tsy misy na inona na inona.

Ny valiny

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 modely sy feo

Misy lisitra roa ho an'ny fisafidianana modely feo sy feo, na modely transkripta. Misy 41 Aura 2 mpiteny Anglisy sy fiteny efatra MeloTTS.

GET https://nymbot.ai/api/v1/audio/models Tsy ilaina ny fanalahidy.

GET https://nymbot.ai/api/v1/audio/voices?language=en Tsy ilaina ny fanalahidy.

Ny valiny (ny feo)

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

Ny modely lisitry ny valiny {"object": "list", "data": {"tts": […], "stt": […]}}Ny modely tsirairay dia manome ny toetra, ny vidiny, max_input_chars, response_formats, languages SY default_voice; ny modely transkription dia manome ny alika, max_file_bytes, max_seconds, format sy ny vidiny isam-bolana.

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

Ny teny amin'ny lahatsoratra

Miverina amin'ny lahatsoratra ny rakitra amin'ny Whisper. Ity no fototry ny transkription amin'ny OpenAI, ka audio.transcriptions.create Ny asa.

POST https://nymbot.ai/api/v1/audio/transcriptions – mila ny API key, na Lightning fandoavam-bola amin'ny fangatahanaNy vatana dia multipart/form-data.

Ho an'ny WAV, WebM, MP4 sy Ogg antontan-taratasy ny faharetan'ny voasoratra avy amin'ny rakitra alohan'ny mihazakazaka na inona na inona, noho izany ny fandefasana mihoatra noho ny 30 minitra dia tsy azo alaina mialoha (miaraka amin'ny fahasoavana 3 segondra). Ny faharetan'ny rakitra WAV dia avy amin'ny sample rate, ny fantsona sy ny sample size. Ny faharetan'ny endrika hafa, toy ny MP3, dia tsy azo alaina mialoha, noho izany dia voafetra amin'ny habeny: amin'ny bitrate ambany indrindra ny Nymbot mihevitra, 8 kbps, 30 minitra dia 1.8 MB, ary ny rakitra lehibe kokoa amin'ny endrika toy izany dia tsy azo alaina 413 audio_too_long Alohan'ny mihazakazaka na inona na inona. Maniraka rakitra lava kokoa toy ny WAV, WebM, MP4 na Ogg. Raha manambara mihoatra ny 30 minitra ny Whisper, ny fangatahan'ny dia tsy nahazo 413 audio_too_long, ary satria nihazakazaka ny Whisper, 30 minitra dia voavidy.

Mandoa ny fe-potoana ny feo, manodidina ny faharoa: ny lava indrindra ny fe-potoana voasoratra avy amin'ny rakitra, ny fe-potoana Whisper tatitra, ary ny kely indrindra ny habetsaky ny rakitra dia mamela, amin'ny Whisper's per-minute vidiny amin'ny mahazatra saram-pandraharahana sy ny marika, ary farafaharatsiny 0.05 kredit ny fangatahana. 402 Manome ny zavatra ilain'ny tsirairay. Ao amin'ny fampiharana, ny famindrana hafatra feo dia mety ho maimaim-poana; ao amin'ny API dia mandrakariva ny karama. Raha tsy mahomby ny Whisper, dia tsy misy karama.

Ny valiny

{
  "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 Miverena ny lahatsoratra mazava, srt SY vtt Hiverina amin'ny subtitles, ary verbose_json manampy ny fiteny, ny fe-potoana ary ny fotoana. Ho an'ny telo izay tsy JSON, ny vidiny dia ao amin'ny lohateny.

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

Mifanaraka amin'ny teny Anglisy

POST https://nymbot.ai/api/v1/audio/translations – mila ny API key, na Lightning fandoavam-bola amin'ny fangatahanaNy vatana dia multipart/form-data.

Toy izany koa amin'ny tranokala, miaraka amin'ny sehatra mitovy amin'ny language, ny fetra sy ny vidiny, fa ny lahatsoratra dia miverina amin'ny teny anglisy na aiza na aiza ny fiteny niteny. 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);

Ny fametrahana

Miverina ny lahatsoratra amin'ny vektor ho an'ny fikarohana, clustering sy deduplication. Ny modely mihazakazaka amin'ny Cloudflare ary mandany ny salan-dalàna.

POST https://nymbot.ai/api/v1/embeddings – mila ny API key, na Lightning fandoavam-bola amin'ny fangatahana.

Ny lisitry ny modely dia loharanon'ny fahamarinana izay misy azy ireo sy ny vidiny; Ny Google's EmbeddingGemma, amin'ny vektor fohy kokoa amin'ny fangatahana, dia hita ao koa rehefa misy vidiny ho azy ny lisitry ny modely.

Ny valiny

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